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.
- Un admin ouvre ⚙ → Users → API keys.
- Crée une clé avec les permissions write (les clés en lecture seule reçoivent
403). - La clé est passée dans l'en-tête
Authorization: Bearer <key>ouX-Api-Key: <key>.
2. Configuration de Dolphin
Dolphin → Settings → Cost export → Keitaro :
- Tracker URL :
https://your-tracker.com - API key : la clé de l'étape 1
- Matching : par Adset ID (le défaut) — le filtre
sub_id_3correspondra alors
automatiquement au paramètre adset_id du clic.
3. Configuration de Fbtool.pro
Fbtool → Costs → Keitaro :
- Admin panel URL :
https://your-tracker.com - API key : la clé de l'étape 1
- Fbtool matche par
ad.idet envoie le filtresub_id_4— il correspondra
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
- Les clics de la campagne sur
[start_date .. end_date], restreints par les filtres. - La clé du filtre est essayée comme nom de paramètre telle quelle (
ad_id,adset_id,
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.
- La somme est convertie dans la devise du tracker (
core/CurrencyRates.php) et répartie
équitablement entre les clics correspondants (CPC uniforme) — le même modèle qu'utilise core/CostImporter.php.
- Renvoyer la même période écrase la répartition au lieu
de s'y ajouter (les services envoient les coûts toutes les 60–90 minutes).
- Si aucun clic n'a été trouvé, la somme est stockée dans
cost_recordssous une connexion
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.
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 →DocsInstallation 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 →DocsMigrer 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 →DocsMigrer 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 →DocsAperç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 →DocsCampaigns 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 →DocsCloaking
La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.
Lire le guide →DocsBrowser check
Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.
Lire le guide →DocsLanding 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 →DocsPWA 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 →DocsFunnel 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 →DocsPopups 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 →DocsEnregistrements 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 →DocsContent 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 →DocsBibliothè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 →DocsPWA 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 →DocsPostbacks et conversions
Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.
Lire le guide →DocsCoû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 →DocsRé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 →DocsFacebook / 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 →DocsDolphin / 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 →DocsNettoyage 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 →DocsSources 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 →DocsRapports, 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 →DocsDomaines et SSL
Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.
Lire le guide →DocsCloudflare
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 →DocsAdministration
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 →DocsBot 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 →DocsMCP : 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 →