Docs

Dolphin / Fbtool

Dolphin et Fbtool.pro n'ont pas d'intégrations de tracker propres. Les deux services font exactement une chose : envoyer les coûts à Keitaro via son Admin API. Le « support Dolphin/Fbtool » d'Orbitra est donc un endpoint entrant compatible que les services appellent en croyant parler à Keitaro :

POST https://your-tracker.com/admin_api/v1/campaigns/CAMPAIGN_ID/update_costs
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "start_date": "2026-08-15",
  "end_date": "2026-08-15",
  "cost": 12.34,
  "currency": "USD",
  "timezone": "Europe/Berlin",
  "filters": { "sub_id_4": "120212558973560058" }
}

La réponse suit le format Keitaro : {"success":true, ...} ou un code HTTP + {"success":false,"error":"..."}.

L'endpoint est implémenté dans admin_api.php ; le routage vit dans .htaccess (Apache) et core/nginx_config.php (nginx). Régénérer la config nginx après une mise à jour récupère la location automatiquement.


1. Créer une clé API

L'endpoint accepte les clés personnelles du tracker (table user_api_keys) — les mêmes que celles qu'utilise MCP.

  1. Un admin ouvre ⚙ → Users → API keys.
  2. Crée une clé avec les permissions write (les clés en lecture seule reçoivent 403).
  3. La clé est passée dans l'en-tête Authorization: Bearer <key> ou X-Api-Key: <key>.

2. Configuration de Dolphin

Dolphin → Settings → Cost export → Keitaro :

automatiquement au paramètre adset_id du clic.

3. Configuration de Fbtool.pro

Fbtool → Costs → Keitaro :

automatiquement au paramètre ad_id du clic.

4. Ce qui doit être configuré sur la campagne

Les filtres comparent les paramètres du clic (clicks.parameters_json). Le template de source de trafic Facebook met ces paramètres sur chaque clic : la campagne doit recevoir du trafic avec un lien contenant

ad_id={{ad.id}}&adset_id={{adset.id}}&campaign_id={{campaign.id}}

Dans l'éditeur de campagne, cela se fait en choisissant la source « Facebook Ads » : les paramètres sont remplis automatiquement (onglet « Parameters », le lien avec les macros).

5. Comment la dépense est répartie

campaign_id, …) plus les défauts du template FB Keitaro : sub_id_3→adset_id, sub_id_4→ad_id. Plusieurs filtres sont combinés en AND.

équitablement entre les clics correspondants (CPC uniforme) — le même modèle qu'utilise core/CostImporter.php.

de s'y ajouter (les services envoient les coûts toutes les 60–90 minutes).

external_api cachée, sans attribution — la dépense ne disparaît donc pas en silence. Vérifiez les filtres et les paramètres de la campagne si la dépense « n'arrive jamais ».

6. Vérification

curl -X POST 'https://your-tracker.com/admin_api/v1/campaigns/10/update_costs' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"start_date":"2026-08-15","end_date":"2026-08-15","cost":10,"currency":"USD","filters":{"ad_id":"123456"}}'

La réponse {"success":true,"clicks":N,...} signifie que la dépense a été enregistrée et répartie sur N clics. clicks:0 — la dépense a été mise de côté sans attribution : le filtre n'a correspondu à aucun clic sur la période.


Ajouté en v0.9.7.7.

← Précédent
Facebook / Meta
Suivant →
Nettoyage des commentaires FB
Voir la source sur GitHub: github.com/fenjo26/Orbitra.link/wiki
Tous les guides
Docs

Démarrage rapide : votre première campagne

Le chemin court : installez le tracker, créez une campagne et obtenez vos premiers clics et conversions en moins d'une heure.

Lire le guide →
Docs

Installation et mises à jour

Installez Orbitra sur un serveur Ubuntu ou Debian tout neuf en une commande, et passez aux nouvelles versions sans risque.

Lire le guide →
Docs

Migrer depuis Keitaro

Déplacez campagnes, offres, sources et domaines de Keitaro vers Orbitra : ce qui est transféré et quoi vérifier après l'import.

Lire le guide →
Docs

Migrer depuis Binom

Déplacez campagnes et streams de Binom vers Orbitra via l'API publique v2 : ce qui est transféré automatiquement et quoi régler à la main.

Lire le guide →
Docs

Aperçu des fonctionnalités

Tout ce qu'Orbitra sait faire : campaigns et streams, cloaking, landings, PWA, postbacks, coûts, rapports et intégrations.

Lire le guide →
Docs

Campaigns et streams

La référence complète : réglages de campagne, types de streams, schémas, rotation, filtres, test links et chaque option expliquée.

Lire le guide →
Docs

Cloaking

La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.

Lire le guide →
Docs

Browser check

Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.

Lire le guide →
Docs

Landing pages

Types de landings, la macro {offer}, l'adaptateur JS, LeadForge et les landings multi-offres — la référence complète.

Lire le guide →
Docs

PWA et Web Push

Construisez des apps PWA installables et collectez des abonnés push : réglages, icônes, événements et notifications.

Lire le guide →
Docs

Funnel de visite PWA

Le funnel configurable des landings PWA : étapes ordonnées, store, instructions et carte push, tracking par écran, statistiques de transitions et éditeur.

Lire le guide →
Docs

Popups de conversion

Un popup avec bouton d'offre sur vos landings : templates par vertical, déclencheurs, designs, une vraie étape du funnel et les métriques Popup CTR.

Lire le guide →
Docs

Enregistrements de session

Replay des visites façon vidéo, heatmap de clics et carte de scroll : activation, sites entiers, consentement cookies, stockage et dépannage.

Lire le guide →
Docs

Content Gallery : référence complète

La médiathèque partagée du tracker : dossiers, uploads, limites de formats, MediaPicker et contrat de taille dans les éditeurs PWA, landing et offre.

Lire le guide →
Docs

Bibliothèque de créas

L'onglet Creatives de la galerie : sync Facebook/TikTok, dépense et ROI par créa, rattachement des brouillons, alertes burnout et rapports.

Lire le guide →
Docs

PWA externes et chaînes Telegram

Builders PWA tiers comme cibles de stream avec installs et postbacks attribués, et offres chaîne Telegram via funnel bots avec conversions tg_join.

Lire le guide →
Docs

Postbacks et conversions

Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.

Lire le guide →
Docs

Coûts : import de la dépense

Import de la dépense Facebook, TikTok, Google Ads et réseaux push/pop : matching par IDs, diagnostics, agences, métriques plateforme et agrégateur de revenus.

Lire le guide →
Docs

Réseaux push et pop

Import de dépense AdMaven, PropellerAds, Kadam et autres, et le Zone Killer : règles dry-run/auto pour bloquer les zones qui brûlent de l'argent.

Lire le guide →
Docs

Facebook / Meta

Les deux intégrations Facebook : import de coûts avec mapping des paramètres, et Conversions API avec matching navigateur, consentement et dépannage.

Lire le guide →
Docs

Dolphin / Fbtool

Recevoir les coûts Facebook de Dolphin et Fbtool.pro sur l'endpoint compatible Keitaro : clé API, matching par adset/ad et répartition de la dépense sur les clics.

Lire le guide →
Docs

Nettoyage des commentaires FB

Modération planifiée des commentaires spam sous vos pubs Facebook : dry-run, stop words, regexes admin, whitelist, journal et restauration en un clic.

Lire le guide →
Docs

Sources de trafic et réseaux d'affiliation

Les deux annuaires du funnel : templates de sources avec paramètres et macros, postback vers la source, réseaux d'affiliation et paramètres d'offre.

Lire le guide →
Docs

Rapports, logs et métriques

Dashboard, liste des campagnes, rapport à dimensions, tendances et cohortes, journal du trafic, carte du clic et le détail du calcul de chaque métrique.

Lire le guide →
Docs

Domaines et SSL

Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.

Lire le guide →
Docs

Cloudflare

Connecter Cloudflare via l'API : parking DNS automatique, proxy orange, modes SSL de zone, import des zones et réécriture des enregistrements A.

Lire le guide →
Docs

Administration

Utilisateurs, rôles et permissions, clés API, réglages du tracker, bases geo, mises à jour et menu ⚙ : archive, statuts, logs et extension Ads Manager.

Lire le guide →
Docs

Bot Telegram

Statistiques, conversions et digest quotidien dans Telegram : connexion par token, webhook ou polling, commandes, notifications et alertes vers les chaînes.

Lire le guide →
Docs

MCP : un assistant IA dans le tracker

Connecter Claude Desktop ou tout client MCP à Orbitra via le serveur MCP : clés API, options de connexion et les 41 tools disponibles.

Lire le guide →