Configuration du postback S2S : guide en 5 minutes pour affiliés

Ce qu’est un postback S2S

Un postback server-to-server est une simple requête HTTP que votre réseau d’affiliation envoie à votre tracker lorsqu’une conversion se produit. Aucun JavaScript ne s’exécute dans le navigateur du visiteur, donc les bloqueurs de pub, les règles sur les cookies et la vitesse de la page n’ont aucun effet dessus. C’est pourquoi c’est la méthode par défaut pour compter les conversions en marketing d’affiliation.

Comment le click ID voyage

1. Un visiteur clique sur votre annonce et atterrit sur votre lien de tracking. Le tracker enregistre le clic et lui attribue un click ID unique.
2. Le tracker redirige le visiteur vers l’offre et transmet le click ID, par exemple sous la forme ?sub_id=….
3. Le réseau stocke cette valeur avec le visiteur. Quand le visiteur convertit, le réseau appelle votre URL de postback avec la même valeur.
4. Le tracker associe le click ID au clic d’origine et ajoute la conversion et le payout à la campagne, au flux, à la landing page et à l’offre qui l’ont généré.

Configuration dans XPNSR Tracker

1. Transmettre le click ID à l’offre

Définissez le paramètre de transfert du Click ID de la campagne (par exemple clickid) pour que le tracker l’ajoute à chaque URL d’offre, ou insérez vous-même la macro dans l’URL de l’offre :

https://offer.example/landing?sub_id={click_id}&country={country_code}

Utilisez le nom de paramètre attendu par votre réseau : sub_id, aff_sub, s2, etc. Les 331 préréglages de réseaux d’affiliation du tracker les connaissent déjà.

2. Fournir au réseau votre URL de postback

https://your-tracking-domain/api/postback?click_id={clickid}&revenue={payout}&status=lead

Remplacez les valeurs entre accolades par les macros propres à votre réseau. Dans le tableau de bord du réseau, ce champ s’appelle généralement Postback, S2S ou Server callback.

Sécuriser le postback

Quiconque connaît l’URL pourrait envoyer de fausses conversions. Chaque campagne dispose d’un secret de postback : ajoutez &token=YOUR_SECRET à l’URL (ou envoyez-le dans l’en-tête X-Postback-Token) et activez Require token. Vous pouvez aussi restreindre les postbacks aux adresses IP du réseau. Les postbacks en double pour une même conversion sont ignorés.

Tests et dépannage

1. Ouvrez vous-même votre lien de tracking et effectuez une conversion de test, ou utilisez le postback de test du réseau.
2. Ouvrez Clicks Log dans le tracker et retrouvez votre clic : la conversion y apparaît en quelques secondes.

• Rien n’arrive : vérifiez l’URL dans le réseau à la recherche de fautes de frappe et assurez-vous que les noms des macros correspondent exactement à la documentation du réseau.
• Ça arrive mais ne correspond pas : le click ID n’a pas été transmis à l’offre. Ouvrez l’URL de l’offre depuis un clic de test et cherchez-le.
• Montants incorrects : envoyez le payout sous forme de nombre simple, sans signe monétaire ; utilisez currency pour les payouts hors USD.
• Erreurs 401 : le token est manquant ou incorrect alors que Require token est activé.