Postback S2S : ton réseau d'affiliation prévenu à chaque vente
Un postback est un appel de serveur à serveur qui prévient ton réseau d'affiliation qu'une vente a eu lieu, pour qu'il crédite le bon affilié. Tu colles l'URL de postback de ton réseau dans Oriva, avec des variables comme {click_id} ou {payout}. À chaque vente confirmée par ton serveur, Oriva remplit ces variables et appelle l'URL.
Quelles variables peut-on mettre dans l'URL ?
| Variable | Remplacée par |
|---|---|
{click_id} | l'identifiant de clic de l'affilié, lu à l'arrivée du visiteur (paramètre aff_click_id, ou subid selon le réseau) |
{payout} | la commission, que tu transmets avec la vente (payout) |
{value} | le montant de la vente |
{currency} | la devise de la vente |
{event_name} | le type de conversion (achat, lead…), pour qu'une seule URL gère plusieurs objectifs |
{event_id} | la référence unique de la vente |
Une variable sans valeur est remplacée par un vide : l'appel part quand même.
Pourquoi seulement les ventes confirmées par ton serveur ?
Parce qu'un postback déclenche un vrai paiement. La clé qu'Oriva place dans le code de ton site est publique par nature : n'importe qui peut la lire. Si elle suffisait à déclencher un postback, n'importe qui pourrait inventer une vente et se faire verser une commission. Oriva n'envoie donc un postback que pour une vente transmise par ton serveur, avec ta clé secrète.
Et si le visiteur refuse les cookies ?
Le postback part quand même : payer une commission n'est pas du ciblage publicitaire. Mais sans accord du visiteur, Oriva ne garde pas son identifiant de clic, et {click_id} arrive vide. Ton réseau ne pourra pas attribuer cette vente à un affilié.
Mon URL est-elle protégée ?
- seules les adresses en
httpssont acceptées, et jamais une adresse de réseau interne ; - le token de ton réseau, s'il est dans l'URL, n'apparaît pas en clair dans le journal ;
- si l'URL est ton propre serveur, Oriva peut signer chaque appel (paramètre
oriva_signature, HMAC-SHA256) pour que tu vérifies qu'il vient bien d'Oriva.
Que se passe-t-il si le réseau ne répond pas ?
Oriva réessaie automatiquement après une panne réseau, une limite de débit (429) ou une erreur serveur (5xx). Toute autre erreur est définitive et visible dans le journal, avec le statut renvoyé par le réseau.
Pas de bouton de test ici, volontairement : un appel de test toucherait la vraie URL de ton réseau, et pourrait déclencher une vraie commission.
Essaie Oriva gratuitement.
14 jours pour brancher ton site et voir tes ventes arriver sur tes plateformes.
Commencer l'essai gratuit