Postbacks et conversions
Une conversion atteint Orbitra sous forme de postback depuis le réseau d'affiliation et s'attache à un clic par son ID (subid). Le tracker peut alors la transférer vers la source de trafic (un postback S2S sortant) et vers la Conversions API de la plateforme pub.
Postback entrant
L'adresse du postback est ⚙ → Postback URL. Elle ressemble à ceci :
https://your-domain/<postback_key>/postback
postback_key est la clé secrète de l'installation (protection contre les fausses conversions). Si elle vaut encore la valeur par défaut publique du dépôt, le panel vous alerte ; générez-en une nouvelle sur la même page ou avec php cli/generate_postback_key.php. L'installateur génère sa propre clé.
Paramètres
| Paramètre | Requis | Signification |
|---|---|---|
subid | oui | L'ID de clic du tracker — ce que le réseau a reçu dans {subid} / {clickid} |
status | non | Statut de la conversion : lead, sale, rejected, registration, deposit, trash, ou n'importe lequel personnalisé |
payout | non | Montant du payout |
currency | non | Devise du payout |
tid | non | ID de transaction — pour les conversions répétées sur le même clic |
sub_id_N | non | Valeurs additionnelles |
<type>_status | non | Mappez les statuts directement dans l'URL : sale_status=approved,confirmed |
Exemples :
…/postback?subid={subid}&status=lead
…/postback?subid={subid}&status=sale&payout={payout}
…/postback?subid={subid}&status=sale&payout={payout}&tid={transaction_id}
…/postback?subid={subid}&status={status}&sale_status=approved,confirmed
Si le réseau nomme ses paramètres autrement, configurez des alias de paramètres sur la même page.
Réponses
200 — la conversion est enregistrée. 4xx — la requête est rejetée (mauvaise clé, clic inconnu). 500 / 503 — une erreur d'écriture ; le réseau devrait réessayer le postback. La conversion, ses compteurs et les événements de la Conversions API s'écrivent en une seule transaction : une erreur ne peut jamais produire un « 200 et un événement perdu ».
Comment le statut est déterminé
Dans l'ordre :
- Types de conversion de Settings → Conversion Types — si le statut est dans la liste de valeurs d'un type.
- Un type intégré du même nom.
- La règle
<type>_status=…du postback lui-même. - Alias intégrés :
approved,confirmed,accepted,converted→sale;declined,refused,cancelled,canceled→rejected. - Sinon —
custom.
Les statuts qui n'ont matché aucun type se listent sous Settings → Conversion Types → Unmapped statuses : vous pouvez les affecter à un type là, et les conversions déjà enregistrées se reclassent.
Types de conversion
Chaque type a : un nom, une liste de statuts du réseau, une couleur d'étiquette et quatre drapeaux — compte dans « Conversions », compte dans « Profit », envoie le S2S vers la source, compte dans le Cap de l'offre. Un type Revshare existe d'origine (le statut revshare va dans le profit uniquement : pas de nouvelle conversion, pas de S2S, pas de Cap).
Payouts dans une autre devise
Le payout se convertit dans la devise de base du tracker (taux dans core/CurrencyRates.php). Le montant d'origine, la devise et le taux se stockent sur le clic. Les macros du postback sortant {payout} / {currency} portent la valeur dans la devise de base ; les originales sont {fx_orig_payout} / {fx_orig_currency}. Une paire de devises inconnue s'enregistre telle quelle.
Journal des postbacks entrants
⚙ → Logs → Postbacks — chaque requête entrante avec son issue : si le clic a été trouvé, le statut résultant, le montant. L'ID de clic ouvre la carte du clic.
Postbacks S2S sortants (vers la source de trafic)
Configurés dans la campagne, dans l'onglet S2S Postbacks. Chaque postback est une carte : URL, méthode GET ou POST, chips de statut (sale, lead, rejected, registration, deposit, trash plus les personnalisés). Le menu « insert macro » insère une macro à la position du curseur.
Si la source de trafic sélectionnée a un postback_url défini, une campagne à liste vide le reçoit automatiquement. Si des postbacks sont déjà configurés, une astuce avec un bouton « add » apparaît en haut de l'onglet.
Le filtre de statut laisse passer une conversion si le statut interne a matché (sale), le mot propre du réseau (approved), ou la chip legacy custom pour les mots désormais reconnus par les alias.
Macros
{subid} (aussi {clickid}, {click_id}), {status}, {payout} (aussi {conversion_revenue}), {currency}, {tid} (aussi {external_id}), {campaign_id}, {offer_id}, {cost}, {revenue}, {profit}, et tout paramètre de clic enregistré par son nom : {sub_id_1} … {sub_id_30}, {fx_orig_payout}, {fx_orig_currency}, etc.
{status} porte le statut interne (sale), pas le mot d'origine du réseau. Pour le traduire dans le vocabulaire de la source, utilisez une transformation à la Keitaro : {status: sale=purchase lead=lead} — un statut absent de la liste passe inchangé.
File d'attente de livraison
Les postbacks sortants ne partent pas à l'instant de la conversion — ils entrent dans la file s2s_postbacks_log, et le cron postback_queue_cron.php (une fois par minute) les délivre avec tentatives :
- succès — HTTP 2xx–3xx ;
- tentatives : 60 s → 5 min → 30 min → 2 h → 24 h, après quoi la ligne est marquée
failed; - vérification SSRF à l'enfilement et avant l'envoi : une adresse dans un réseau privé reçoit
failedimmédiatement ; - une ligne laissée en
in_flightpar un worker crashé revient dans la file après 10 minutes.
⚠️ Sans le cron, la file n'est jamais traitée. L'installateur le met en place ; pour le vérifier ou l'ajouter à la main — Settings → Automation → Postback Queue. Une mise à jour via le panel restaure aussi un cron manquant.
Journal de la file : ⚙ → Logs → S2S (statut, tentatives, prochaine tentative, dernière erreur, code HTTP).
Testeur de postback
Le bouton de l'onglet S2S Postbacks (admin seulement) envoie un vrai postback vers ce même serveur avec un clic jetable et affiche un verdict pour chaque étape :
- avec quel statut la conversion s'est enregistrée ;
- si le filtre de statut de chaque postback S2S le laisse passer — et pourquoi : par statut interne, par le mot du réseau, ou par la chip legacy ;
- une livraison d'essai vers la source : code HTTP et timing ;
- les macros qui ne se résoudraient pas et partiraient vers la source en texte brut (
{external_id},{sub_id_N}) ; - les placeholders du template de la source (
bbg=xxx,[YOUR_…]) ; - si le worker de la file est vivant et le cron installé.
Le clic de test, la conversion et les lignes de file se suppriment après la vérification.
Renvoyer les conversions manquées
Le bouton « Re-send missed conversions » enfile les conversions des dernières 72 heures qui passent le filtre courant mais n'ont jamais atteint la file. Le presser à nouveau ne duplique rien.
Import de conversions
⚙ → Conversion Import — téléversez un fichier ou collez une liste d'IDs de clics quand le réseau ne peut pas envoyer de postbacks, ou quand il faut les restaurer.
Conversions API
L'envoi des conversions vers les serveurs de Meta et TikTok se configure dans le profil de pixel et dans la campagne (l'onglet « Integrations »). Pour Meta, voir Facebook / Meta. Les événements s'enfilent avec la conversion et se délivrent avec confirmation : succès uniquement sur une réponse 2xx où events_received correspond à la taille du lot.
Supervision
conversion_monitor_cron.php calcule la part de postbacks échoués sur une fenêtre (60 minutes par défaut) et, quand le seuil (10 %) est dépassé, écrit une alerte dans var/logs/conversion_alerts.log ; l'envoi de l'alerte vers Telegram n'est pas encore implémenté. L'installateur ne met pas en place ce cron — ajoutez-le si besoin :
*/5 * * * * php /var/www/orbitra/conversion_monitor_cron.php --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 →