Article

S2S – Server-to-Server

Le Server-to-Server (S2S) est une méthode de suivi des clics et des conversions qui fonctionne différemment du C2S : le tag JavaScript Affilae n’est pas nécessaire. Elle repose sur un identifiant unique de clic, le clickID, que vous stockez de votre côté puis renvoyez à Affilae au moment de la conversion.

Ce clickID est unique et il circule comme une variable tout au long de l’entonnoir de conversion. C’est lui qui permet d’identifier le partenaire à rémunérer.

Prérequis : le Format d’URL de votre programme doit être réglé sur Server-to-Server (S2S). Ce réglage fait basculer les liens de tracking en redirection et fait valider la conversion côté serveur. La mise en place d’une CMP reste obligatoire.

Régler votre programme en Server-to-Server

  1. Dans la barre latérale, cliquez sur Programmes, puis sur le nom de votre programme.
  2. Cliquez sur Configuration.
  3. Ouvrez la section Paramètres généraux.
  4. Sur le champ Format d’URL, choisissez Server-to-Server (S2S).
Affilae
GÉRER MES PROGRAMMES
Mon programme
Configuration
Mes affiliés
Elément pubs
Clics
Conversions
Le menu « Configuration » dans le menu du programme, côté annonceur.

Pourquoi utiliser le S2S

  • Le suivi ne dépend pas d’un script chargé sur votre site : il résiste mieux aux bloqueurs de publicité.
  • Le clic est enregistré par Affilae au moment de la redirection, sans dépendre d’un script chargé sur votre site.
  • Vous gardez le contrôle sur le clickID, puisque c’est vous qui le stockez.
  • Le suivi fonctionne sur mobile, où les cookies sont souvent bloqués.
  • C’est l’approche idéale pour l’attribution mobile avec une solution comme Branch ou Appsflyer.

Comment ça marche, du clic à la conversion

Le clic

  1. L’internaute clique sur un lien affilié.
  2. Affilae génère un clickID unique, par exemple 603ed1800000000000000000.
  3. Le clickID est ajouté automatiquement à votre landing page : https://votresite.com/?aecid=603ed1800000000000000000
Attention : le clickID n’est pas ajouté quand le clic n’est pas enregistré, par exemple si le partenariat n’est pas accepté ou si un capping « Stopper le tracking » est atteint. Un clic venu d’un pays hors Geo Targeting reçoit un clickID, mais il ne pourra générer aucune conversion.

Le stockage

Vous devez stocker ce clickID dans un cookie sécurisé, posé sur le navigateur de l’internaute au chargement de la landing page. Ce cookie doit porter les attributs HttpOnly et Secure.

La conversion

Côté annonceur, vous renvoyez ensuite ces informations à Affilae. Deux options sont possibles.

1. L’URL de postback. Configurez son déclenchement pour qu’elle se déclenche après la validation de la conversion par le client, et renseignez la variable cids avec le ou les clickID collectés, séparés par un tiret.

https://lb.affilae.com/?key=603ed1800000000000000000-603ed1800000000000000001&id={{UNIQUE_ID}}&amount={{AMOUNT}}&payment={{PAYMENT}}&customer={{CUSTOMER_ID}}&cv={{SUB_ID}}&voucher={{VOUCHER_CODE}}&currency=EUR&cids={{CLICK_IDS}}

Le paramètre cv est une référence libre de votre choix, remontée avec la conversion. À ne pas confondre avec les SubID que les affiliés ajoutent à leurs liens.

2. L’API. Appelez POST /advertiser/conversions.add : les champs et un exemple sont dans Automatiser le suivi des conversions via l’API. La référence complète est disponible sur rest.affilae.com/reference.

Dès réception, Affilae rattache la conversion au clic qui porte ce clickID. Un clickID inconnu, issu d’un autre programme ou plus ancien que la Durée du tracking (en jours) de la règle ne permet pas ce rattachement. Une même commande n’est enregistrée qu’une fois par règle : un second envoi avec le même identifiant de commande est ignoré. Deux commandes différentes passées après le même clic comptent toutes les deux.

Les en-têtes à transmettre

EN-TÊTE CONTENU ATTENDU
x-ae-d-ip L’adresse IP v4 ou v6 du client, par exemple 203.0.113.10.
x-ae-d-ua Le user agent du client, par exemple Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36. Optionnel, mais fortement recommandé.
Referer Le référent, par exemple https://www.site.fr.
Schéma du parcours S2S, du clic au stockage du clickID puis à la conversion
Le parcours d’un clickID, de la génération du clic jusqu’à l’enregistrement de la conversion.

Checklist de mise en œuvre

  1. Programme configuré en S2S dans Affilae.
  2. Réception du paramètre aecid sur votre landing page.
  3. Cookie qui persiste le ou les clickID, avec les attributs HttpOnly et Secure.
  4. Lecture du cookie pour transmettre les clickID lors d’une conversion, par postback ou par API.
  5. Tests.

Points d’attention

Astuce : testez plusieurs parcours utilisateur avant d’ouvrir votre programme, et vérifiez à chaque fois que la conversion remonte bien dans Affilae. Un clickID mal transmis ne déclenche aucune erreur visible, les conversions manquent simplement.
Créez toujours vos liens trackés avec Affilae : le Générateur de liens, l’extension Chrome, ou l’API pour les outils qui génèrent des liens automatiquement. Cela vaut quel que soit le mode de tracking du programme : C2S, S2S ou partenaire d’attribution mobile (AppsFlyer…). Ne modifiez pas un lien généré : pour changer de page de destination ou ajouter un SubID, générez un nouveau lien. Un lien retouché à la main ou assemblé en dehors d’Affilae peut ne pas enregistrer vos clics et vos ventes.
  • Le clickID fait toujours 24 caractères, par exemple 603ed1800000000000000000.
  • Les cookies doivent être HttpOnly et Secure.
  • Testez avec plusieurs parcours utilisateur.
  • Vérifiez que les conversions remontent bien dans Affilae.

Articles liés

Questions
fréquentes

Voir plus de questions

Le S2S ne repose pas sur le tag JavaScript Affilae. Le suivi passe par un identifiant unique de clic, le clickID, que vous stockez côté serveur puis renvoyez à Affilae au moment de la conversion. Le S2S ne dépend donc pas d’un script chargé sur votre site : il résiste mieux aux bloqueurs de publicité, et continue de fonctionner sur un mobile qui bloque les cookies.

Dans la barre latérale, cliquez sur Programmes, ouvrez votre programme, puis Configuration et la section Paramètres généraux. Sur le champ Format d’URL, choisissez Server-to-Server (S2S). Ce réglage fait basculer les liens de tracking en redirection.

Un clickID fait toujours 24 caractères, par exemple 603ed1800000000000000000. Il arrive sur votre landing page dans le paramètre aecid de l’URL.

Le clickID n’est pas ajouté quand le clic n’est pas enregistré, par exemple si le partenariat n’est pas accepté ou si un capping « Stopper le tracking » est atteint. Un clic venu d’un pays hors Geo Targeting reçoit un clickID, mais il ne pourra générer aucune conversion.

Dans un cookie posé sur le navigateur de l’internaute au chargement de la landing page. Ce cookie doit porter les attributs HttpOnly et Secure. À la conversion, vous relisez le cookie pour transmettre le ou les clickID.

Les deux options sont valables. L’URL de postback se déclenche après la validation de la conversion par le client, avec les clickID dans la variable cids séparés par un tiret. L’API offre plus de contrôle, sa référence est publiée sur rest.affilae.com/reference.

Le second envoi est ignoré : Affilae n’enregistre qu’une conversion par identifiant de commande et par règle. Deux commandes différentes passées après le même clic comptent toutes les deux, chacune avec son propre identifiant.

Non. Le S2S ne dépend pas des cookies du navigateur, mais la mise en place d’une CMP reste obligatoire.

Besoin d’aide ?

Restez informés des dernières tendances en affiliation marketing et ne manquez aucun de nos articles.

Contactez-nous