Coûts : import de la dépense
Orbitra tire la dépense quotidienne des comptes pub et la répartit sur les clics, pour que ROI et profit des rapports se calculent à partir d'argent réel, pas d'un coût par clic manuel.
Les connexions sont dans ⚙ → Integrations, dans le groupe des réseaux pub : Facebook Costs, TikTok Costs, Google Ads Costs. L'onglet Integrations de l'éditeur de campagne montre si les clics de la campagne portent les IDs pour le matching, et permet d'ajouter une connexion.
Comment la dépense arrive sur un clic
- Le cron
aggregator_cron.php(l'installateur l'ajoute toutes les 15 minutes) parcourt les connexions dont l'intervalle de mise à jour arrive à échéance. Chaque passage relit les 5 derniers jours, et le premier passage en lit 30 : les comptes pub révisent la dépense rétroactivement, et le jour courant grossit jusqu'à minuit. - Les enregistrements atterrissent dans
cost_recordsavec des mises à jour indexées par(connection_id, external_id). Re-synchroniser le même jour est sûr : la dépense se recalcule, elle ne s'accumule pas. - Pour chaque enregistrement, les clics du même jour se matchent, du niveau le plus spécifique au plus large :
ad_id(aussicreative_id,creative) ;adset_id/adgroup_id(aussiadgroup,adgroupid,ad_group_id) ;campaign_id(aussicampaign,campaignid,ad_campaign_id).
- La dépense du jour se divise équitablement entre les clics matchés.
- La dépense se convertit dans la devise du tracker (taux depuis
open.er-api.com, mis en cache 12 heures ; taux personnalisés via le réglagefx_rates_manual_json, unités pour 1 USD).
L'exigence principale : le lien de la pub doit faire passer l'ID de l'ad, du groupe ou de la campagne vers le tracker. Le plus simple est de choisir une source de trafic template (Facebook, TikTok, Google Ads) dans la campagne — le template ajoute lui-même les macros nécessaires.
Les enregistrements qui n'ont trouvé aucun clic réessaient le matching à chaque sync : un clic tardif, un lien corrigé ou un nouvel adgroup_id ramènera la dépense.
Le diagnostic N reçus, 0 rattachés
Le bouton Refresh costs d'une connexion montre la raison précise :
| Code | Signification |
|---|---|
no_spend | des enregistrements sont arrivés, mais la dépense y est nulle |
no_clicks | il n'y a pas de clics dans Orbitra ces jours-là |
no_ids | les clics ne portent aucun ID d'ad, de groupe ou de campagne — le lien ne mène pas directement à la campagne Orbitra, ou les paramètres se perdent en route |
macros | les clics contiennent des macros non résolues comme __CID__ — la source n'a pas substitué les valeurs |
ids_differ | les IDs des clics et du rapport du compte pub ne correspondent pas ; les deux s'affichent |
Dans la carte du clic, la section « Parameters » montre tous les paramètres capturés, avec les IDs des réseaux pub en premier.
Facebook / Meta
Un Long-lived User Token ou System User Token avec ads_read + l'ID du compte pub (act_…). Vous pouvez préciser la version de l'API et un proxy. Pour le détail, voir Facebook / Meta.
TikTok
Trois façons de connecter :
| Méthode | Ce qu'il faut |
|---|---|
| Connect via TikTok MCP | Seulement un login TikTok. Pas d'app développeur ni de token — le tracker s'enregistre lui-même via le serveur MCP officiel de TikTok. Importe la dépense ; n'importe pas les pixels. Le panel doit s'ouvrir en HTTPS (https:// sur une IP nue fonctionne aussi) |
| 1-Click (Sign in with TikTok) | App ID et App Secret de votre propre app TikTok for Business : les variables d'environnement ORBITRA_TIKTOK_APP_ID / ORBITRA_TIKTOK_APP_SECRET, ou les champs de connexion manuelle. Trouve les comptes pub et les pixels, importe les pixels dans le Pixel Vault |
| Manual | Un token Marketing API depuis une app développeur gratuite (Developer Portal → Apps & Agents → permissions Direct Advertiser, Ads Management et Reporting) + Advertiser ID |
Un token d'Events Manager ne fonctionne pas pour l'import de dépense — il n'envoie que des événements de conversion. Si la liste des comptes pub ne peut pas se lire via MCP, vous pouvez coller des Advertiser IDs à la main, séparés par des virgules.
Google Ads
- 1-Click (Sign in with Google) — trouve les comptes directs et les comptes enfants MCC, en créant une connexion pour chacun que vous sélectionnez. Requiert un Developer Token (venant du MCC) et un OAuth Client ID + Secret (Google Cloud Console, type « Web application », redirect URI
https://your-domain/api.php?action=google_ads_oauth_callback). - Manual — Customer ID, Developer Token, Client ID, Client Secret, Refresh Token.
Les clés du 1-Click se prennent dans l'ordre : les variables d'environnement ORBITRA_GOOGLE_CLIENT_ID, ORBITRA_GOOGLE_CLIENT_SECRET, ORBITRA_GOOGLE_DEVELOPER_TOKEN → réglages → champs d'une connexion manuelle déjà enregistrée. Le plus simple est d'enregistrer une fois une connexion manuelle — après cela, le bouton 1-Click fonctionne aussi. Pour vérifier la configuration serveur : php check_google_ads_oauth.php.
Les variables d'environnement se lisent dans l'environnement PHP-FPM (
env[ORBITRA_GOOGLE_CLIENT_ID] = …dans la config du pool), pas dans le fichier.env— le code PHP ne le charge pas..env.examplen'est qu'une liste de noms.
Google et TikTok n'acceptent pas les redirections OAuth vers http://. Sur une IP nue sans certificat, utilisez une connexion manuelle.
La dépense se matche par les paramètres ValueTrack {campaignid} et {creative} — le template de source Google Ads les ajoute.
Réseaux push et pop
La dépense des réseaux annonceurs push/pop — AdMaven, PropellerAds, Kadam, Galaxion, HilltopAds, Adsterra, Clickadu — s'importe par le même cron et atterrit sur les clics par campagne et, là où le réseau le reporte, par zone (site). Le Zone Killer, qui bloque les zones qui brûlent de l'argent, fonctionne à partir de ces données. Voir Réseaux push & pop.
Dolphin et Fbtool
Ces services ne peuvent envoyer la dépense qu'à Keitaro via son Admin API. Orbitra accepte la même requête à POST /admin_api/v1/campaigns/<ID>/update_costs. Pour le détail, voir Dolphin / Fbtool.
Dépense manuelle
Le bouton Refresh costs du menu de la campagne règle la dépense d'une période à la main (action update_costs).
Agrégateur de revenus
⚙ → Revenue Aggregator — la tâche inverse : tirer les revenus des comptes de programmes d'affiliation qui n'envoient pas de postbacks. Moteurs : ReferOn, Affilka, Generic API. Pour chaque connexion vous réglez le réseau, le type de deal, l'intervalle de sync, et le nom du paramètre où le programme d'affiliation stocke l'ID de clic Orbitra. Les revenus et les journaux de sync sont dans les onglets de la même page.
Agences et commission
Les comptes pub loués coûtent plus cher que ce que le cabinet reporte : le pourcentage de l'agence s'écrit dans chaque import (cost_records.fee_amount ; clicks.cost porte la dépense avec les frais, clicks.fee la part de frais) — donc ROI/CPC sont honnêtes dès que la dépense atterrit, et changer le pourcentage plus tard ne réécrit jamais l'histoire.
- L'onglet Agencies de la section agrégateur gère les agences (nom, % de frais, contacts, conditions de paiement, notes) et les compare par dépense, CPC, CPM et ROI sur une période.
- Chaque connexion de coûts choisit son agence dans l'éditeur.
- Les rapports gagnent les colonnes Spend (cabinet) et Agency fee ; chaque groupement splitte les deux.
Noms des pubs, statuts, métriques plateforme
Le cost sync collecte aussi ce que la plateforme sait des pubs elles-mêmes : noms et statuts dans ad_entities (statuts rafraîchis toutes les heures, dans le même passage de cron), impressions et comptes de clics propres de la plateforme sur les lignes de dépense. Dans les rapports de campagne groupés par ad / adset / campaign, vous obtenez les noms au lieu d'ids nus, une chip de statut, et les colonnes côté plateforme : Impressions, Clicks (platform), CPM, CTR (platform) et Click loss = 1 − visiteurs du tracker / clics plateforme — le chiffre qui expose immédiatement un problème de cloaking ou de domaine, que adset.pro n'a pas.
Un bandeau en haut des rapports montre la part des revenus qu'on ne peut pas rattacher à un id d'ad (une macro __CID__ / {{ad.id}} non remplacée compte comme manquante) et saute dans l'éditeur de la source en cause.
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
L'intervalle se vérifie par connexion, donc un cron fréquent coûte peu ; pour des intervalles de moins de 15 minutes, lancez-le plus souvent. Flags : --force (ignore l'intervalle), --connection=5, --days=30.
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 →