Docs

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ètreRequisSignification
subidouiL'ID de clic du tracker — ce que le réseau a reçu dans {subid} / {clickid}
statusnonStatut de la conversion : lead, sale, rejected, registration, deposit, trash, ou n'importe lequel personnalisé
payoutnonMontant du payout
currencynonDevise du payout
tidnonID de transaction — pour les conversions répétées sur le même clic
sub_id_NnonValeurs additionnelles
<type>_statusnonMappez 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 :

  1. Types de conversion de Settings → Conversion Types — si le statut est dans la liste de valeurs d'un type.
  2. Un type intégré du même nom.
  3. La règle <type>_status=… du postback lui-même.
  4. Alias intégrés : approved, confirmed, accepted, converted → sale ; declined, refused, cancelled, canceled → rejected.
  5. 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 :

⚠️ 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 :

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
← Précédent
PWA externes et chaînes Telegram
Suivant →
Coûts : import de la dépense
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 →