Postbacks : ce qu'il faut dire à votre affiliate manager
C'est quoi un postback
Quand un visiteur achète sur le site de l'annonceur, la vente est enregistrée dans le réseau d'affiliation, pas dans votre tracker. Un postback, c'est le réseau qui le signale à votre tracker : une courte requête serveur à serveur du type
https://track.example.com/a7f3c91e/postback?subid=0bc4ba11-688d-4de0-98b4-8b0d6e81cef&status=sale&payout=30
Il dit : « le clic 0bc4ba11… a converti, statut sale, vous gagnez 30 ». Orbitra retrouve ce clic et sait dès lors quelle campagne, quel stream, quelle offre, quel pays, quelle pub et quelle créa ont produit l'argent.
Sans postbacks, le tracker compte les clics mais ne voit jamais la moindre conversion : revenus, profit, ROI et CR restent à zéro.
Le voyage aller-retour de l'ID de clic
1. Visitor clicks your ad → Orbitra creates click 0bc4ba11…
2. Orbitra redirects to the offer: https://network/offer?aff=777&sub1=0bc4ba11…
▲ added by the network's "offer parameters"
3. The network remembers sub1 for this visitor
4. Visitor buys → the network calls your postback URL and puts sub1 back:
https://track.example.com/a7f3c91e/postback?subid=0bc4ba11…&status=sale&payout=30
5. Orbitra marks click 0bc4ba11… as a conversion
Deux réglages rendent cela possible :
- les paramètres d'offre du réseau dans Orbitra (
&sub1={subid}) — l'ID de clic part vers le réseau ; - l'URL de postback dans le dashboard du réseau — l'ID de clic revient. Le réseau remplace sa propre macro (
{sub1},{clickid},[SUB1]— chaque réseau l'écrit à sa façon) par la valeur stockée.
Si vous avez créé le réseau à partir d'un template, les deux moitiés utilisent déjà les bons noms.
Où trouver votre URL de postback
- Networks → la ligne du réseau (ou l'éditeur du réseau) → Postback URL. C'est la meilleure : elle utilise les noms de macros propres au réseau.
- ⚙ → Postback URL — l'adresse générique et des exemples pour les réseaux absents de la liste des templates.

Les paramètres qu'Orbitra comprend :
| Paramètre | Requis | Signification |
|---|---|---|
subid | oui | L'ID de clic Orbitra — ce que le réseau a reçu dans sub1 (ou dans le champ que vous avez choisi) |
status | non | lead, sale, rejected, trash, registration, deposit, ou le mot propre au réseau (approved, pending, declined…) |
payout | non | Ce que vous gagnez pour cette conversion |
currency | non | Si le réseau paie dans une autre devise — elle est convertie dans la devise du tracker |
tid | non | ID de transaction, nécessaire quand un clic peut apporter plusieurs conversions (p. ex. dépôts répétés) |
Les mots propres au réseau pour les statuts sont traduits automatiquement (approved, confirmed → sale ; declined, cancelled → rejected). Vous pouvez mapper n'importe quel autre mot directement dans l'URL : &sale_status=approved,paid&lead_status=pending. Les mots qu'Orbitra n'a pas reconnus apparaissent dans ⚙ → Settings → Conversion Types → Unmapped statuses, où vous pouvez les affecter.
Ce qu'il faut envoyer à votre affiliate manager
La plupart des réseaux configurent le postback pour vous si vous le demandez. Envoyez un message de ce genre (remplacez l'URL par la vôtre) :
Bonjour ! Merci de mettre en place un global postback pour mon compte (toutes les offres) :
https://track.example.com/a7f3c91e/postback?subid={sub1}&status={status}&payout={payout}
- Mon ID de clic est transmis dans sub1 du lien d'offre — merci de le renvoyer danssubid.
- Merci d'envoyer les postbacks pour tous les statuts : nouveau lead (hold/pending), approved, rejected et trash, avec le payout pour les approved.
- La méthode GET convient.
Pourriez-vous aussi m'indiquer vos noms de macros pour l'ID de clic, le statut et le payout, s'ils diffèrent de{sub1},{status},{payout}? Merci !
Ce qu'il faut vérifier dans leur réponse :
- Quel champ porte votre ID de clic. S'ils disent « utilisez
aff_sub», modifiez les paramètres d'offre du réseau dans Orbitra en&aff_sub={subid}et le postback ensubid={aff_sub}. - Leur syntaxe de macro.
{sub1},[SUB1],%sub1%,{{sub1}}— copiez exactement ce qu'ils utilisent. - Leurs mots de statut. S'ils envoient
status=1/2/3ou des mots en russe, mappez-les avec&sale_status=…&lead_status=…&rejected_status=…ou dans Conversion Types. - Par offre vs global. Un global postback couvre toutes les offres ; un postback par offre doit être ajouté à chaque offre séparément.
Comment le tester
- Faites un vrai clic via le lien de campagne (ou prenez un clic dans ⚙ → Logs → Traffic) et copiez son ID de clic.
- ⚙ → Postback URL → Test Postback : collez l'ID de clic, choisissez un statut, cliquez sur Test.

- Ouvrez ⚙ → Conversions — la conversion y est, et les compteurs de la campagne bougent.
Beaucoup de réseaux ont aussi un bouton « test postback » qui envoie une requête avec un faux sub1. Orbitra y répond « click not found » — c'est normal ; cela prouve que l'URL est joignable.

⚙ → Logs → Incoming Postbacks liste chaque requête arrivée, y compris celles rejetées, avec la raison. C'est le premier endroit à consulter quand « le réseau dit avoir envoyé, le tracker n'affiche rien ».
Renvoyer les conversions vers la source de trafic (S2S)
Certaines sources de trafic (réseaux push et pop, TikTok, certains réseaux natifs) optimisent mieux quand elles reçoivent vos conversions. C'est un postback sortant, configuré dans l'onglet S2S Postbacks de la campagne. Si le template de la source de trafic contient une URL de postback, une nouvelle campagne la récupère automatiquement. Le bouton Run test y vérifie toute la chaîne. Facebook et TikTok utilisent plutôt leur Conversions API — voir Facebook / Meta.

Dépannage
| Symptôme | Où regarder |
|---|---|
| Rien dans Incoming Postbacks | Le réseau ne vous a jamais appelé : URL erronée dans son dashboard, ou le postback est configuré par offre pour une autre offre |
| « Click not found » | L'ID de clic n'est pas transmis : vérifiez les paramètres d'offre du réseau et la macro dans le postback |
| « Wrong key » | L'URL contient une ancienne clé de postback. Un réseau créé avant votre changement de clé garde l'ancienne clé dans sa Postback URL enregistrée — corrigez la clé dans cette URL (éditeur du réseau) et mettez-la à jour dans le dashboard du réseau |
Conversion enregistrée avec le statut custom | Le mot de statut du réseau n'est pas mappé — corrigez-le dans Conversion Types |
| Le payout est à 0 | Le réseau ne substitue pas {payout}, ou l'envoie sous un autre nom — ajoutez un alias de paramètre sur la page Postback |
Référence : Postbacks et conversions.
Guide du débutant : par où commencer
Une visite d'Orbitra écran par écran : ce que fait le tracker, les mots que vous rencontrerez et l'ordre de lecture des guides.
Lire le guide →GuideVotre première campagne, étape par étape
D'une installation toute neuve à un lien de campagne fonctionnel et une conversion de test : domaine, réseau, offre, source, campagne, postback.
Lire le guide →GuideConnecter un domaine
Ajouter un domaine, pointer le DNS vers le tracker, obtenir un certificat SSL gratuit, et le rôle de chaque interrupteur de la page Domains.
Lire le guide →GuideOffres et réseaux d'affiliation
Comment offres et réseaux s'organisent dans Orbitra : templates, paramètres d'offre et réglages de payout.
Lire le guide →GuidePostbacks : ce qu'il faut dire à votre affiliate manager
Comment les conversions arrivent dans Orbitra : l'URL de postback, les statuts et quoi copier-coller à votre réseau.
Lire le guide →GuideStreams : comment le trafic est réparti
C'est quoi un stream, les schémas, la rotation et les poids, et comment Orbitra décide où va un clic.
Lire le guide →GuideFiltres de stream
Pays, appareil, ISP, bots et plus : chaque filtre expliqué, avec des exemples de routages courants.
Lire le guide →GuideLe cloaking pour les débutants
Page safe vs page money, couches de détection, sensitivity, et comment tester votre cloak avant d'envoyer du vrai trafic.
Lire le guide →GuideLanding pages
Hébergez vos landings dans le tracker : types de landings, la macro {offer}, l'adaptateur JS et les pixels de tracking.
Lire le guide →GuideApplications PWA
Construisez une PWA installable depuis une landing : icône, captures d'écran, fiche store et limites.
Lire le guide →GuideNotifications push vers les utilisateurs PWA
Collectez des abonnés push depuis vos landings PWA et envoyez-leur des notifications — du trafic de réengagement gratuit.
Lire le guide →GuideContent Gallery
Stockez icônes, captures et créas dans le tracker et réutilisez-les dans vos PWA et landings.
Lire le guide →GuideCréas et test de créas
Sachez de quelle créa vient chaque clic : routage par subid, une campagne de test et la lecture du rapport.
Lire le guide →