Réseaux push et pop
Import de dépense depuis les réseaux annonceurs push et pop, plus le Zone Killer — des règles qui trouvent (et, si vous les y autorisez, bloquent) les zones qui brûlent de l'argent. Tout vit au même endroit : la carte Push/Pop networks dans ⚙ → Integrations, dans le groupe des réseaux pub à côté des coûts Facebook / TikTok / Google.
Réseaux
| Réseau | Niveau de dépense | Clé API |
|---|---|---|
| AdMaven | campagne × zone | Advertiser panel → section API → API token |
| PropellerAds | campagne × zone | SSP → Profile → API token |
| Kadam | campagne × zone | Compte annonceur → section API → API token |
| Galaxion | campagne × zone | E-mail + mot de passe du compte (le tracker obtient un token lui-même), ou un token API prêt |
| HilltopAds | campagne seulement | My Account → onglet API → API key |
| Adsterra | campagne seulement | Settings → onglet API → Generate new token (seul le token le plus récent fonctionne) |
| Clickadu | campagne seulement | Compte annonceur → section API → API key |
Les réseaux marqués campagne seulement ont bien une ventilation par zone dans leur API, mais ses lignes ne portent pas d'id de campagne — une zone ne peut pas y être liée à la campagne dont elle a acheté les clics. Leur dépense se répartit sur les clics de la campagne, et la carte de connexion vous prévient avant que vous connectiez.
Connexion
Choisissez une tuile de réseau, collez la clé, appuyez sur Check connection — elle montre le vrai solde du compte — puis enregistrez. Chaque connexion a son propre intervalle de mise à jour ; les boutons de la liste : Update spend (maintenant), pause, éditer, supprimer. La dépense déjà importée reste dans les rapports après une suppression.
La sync tourne dans le même passage de aggregator_cron.php que les autres connexions de coûts (voir Coûts) : chaque passage relit les 5 derniers jours, le premier 30. Re-synchroniser un jour est sûr — la dépense se recalcule, elle ne s'accumule pas.
Comment la dépense arrive sur un clic
L'exigence principale est la même que pour Facebook ou TikTok : la campagne doit utiliser le template de source de trafic du réseau, pour que le lien fasse passer l'id de campagne du réseau (dans ad_campaign_id) et l'id de zone (les templates de source Keitaro l'écrivent dans source, le template intégré PropellerAds dans zone). Sans la macro de zone, la dépense atterrit quand même — mais par campagne seulement, jamais ventilée par zone.
Le matching, du niveau le plus spécifique au plus large :
- campagne × zone — une ligne de zone ne s'attribute qu'aux clics du même jour portant à la fois l'id de zone et l'id de campagne du réseau. Un id de zone seul ne suffit pas : les ids de zone ne sont pas uniques entre réseaux.
- campagne — une ligne de zone dont la zone n'a matché aucun clic se somme sur les clics de la campagne sans zone (elle ne grimpe jamais sur des clics déjà tarifiés par leurs propres lignes de zone — plusieurs zones non matchées s'additionnent au lieu de s'écraser mutuellement).
Les clés de paramètre de clic qui comptent comme « la zone » : zone, zone_id, zoneid, sub_source_id.
Si une sync répond « enregistrements reçus, mais aucun n'a pu s'attacher à des clics », la campagne n'utilise très probablement pas le template de source de ce réseau — le lien n'apporte pas d'id de campagne à matcher. Les diagnostics « N reçus, 0 rattachés » de Coûts s'appliquent ici aussi.
Zone Killer
Une carte dans l'onglet General de l'éditeur de campagne (la campagne doit d'abord être enregistrée). Une règle lie la campagne à une connexion de coûts push/pop et décide quelles zones sont candidates :
- window — sur combien de jours en arrière juger (dépense et conversions se somment par zone sur la fenêtre) ;
- min spend — une zone qui a dépensé moins ne vaut pas la peine d'être touchée ;
- zero conversions et/ou max ROI — les conditions de kill ;
- mode —
dry_run(défaut) ouautoavec un plafond de blocages par exécution.
Les candidates se calculent depuis clicks.cost / clicks.revenue par zone — les mêmes chiffres répartis que montrent les rapports, avec les mêmes clés de zone que l'import de coûts a matchées, donc une règle ne peut jamais juger une zone que l'importateur a tarifiée autrement.
- Dry-run liste les candidates ; vous sélectionnez et appuyez sur Block selected.
- Auto laisse
zone_rules_cron.phpexécuter lui-même les candidates (plafonnées par exécution) et envoie une notification Telegram sur ce qu'il a bloqué.
Le blocage passe par l'API d'écriture du réseau pour AdMaven, HilltopAds, PropellerAds, Kadam et Galaxion. Adsterra et Clickadu n'ont pas d'API d'écriture de zone utilisable : leurs règles restent en dry-run, et la carte copie les ids des zones sélectionnées pour que vous les colliez à la main dans la blacklist du réseau.
Chaque blocage et déblocage — manuel ou automatique — atterrit dans un journal en ajout seul avec les métriques qui ont étayé la décision ; l'ensemble actuellement bloqué est une zone dont la dernière action réussie est « block ». Le journal s'affiche sous la règle.
Pour les réseaux campagne seulement (HilltopAds, Adsterra, Clickadu), le Zone Killer juge les zones approximativement — par leur part des clics de la campagne, car l'API ne donne pas de dépense par zone. Gardez leurs règles en dry-run et vérifiez la liste avant de bloquer.
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
*/30 * * * * php /var/www/orbitra/zone_rules_cron.php >> /var/www/orbitra/var/logs/zone_rules.log 2>&1
La première ligne est le cron que l'installateur ajoute pour la sync des coûts. La seconde — l'exécuteur du Zone Killer — vous l'ajoutez vous-même, et seulement si vous utilisez des règles auto ; un passage est bon marché (une règle sans candidate est un seul GROUP BY sur les clics de la campagne). Flags : --campaign=12 (une seule campagne), --quiet.
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 →