Article

S2S – Branch

Branch est une plateforme d’attribution mobile. Couplée au suivi Server-to-Server d’Affilae, elle permet de suivre les installations et les événements dans votre application générés par vos affiliés. Affilae collecte le clic, Branch fait l’attribution, puis renvoie les conversions à Affilae.

Prérequis Le Format d’URL de votre programme doit être réglé sur Server-to-Server (S2S), dans Configuration puis Paramètres généraux. Votre application doit intégrer le SDK Branch, et il vous faut un accès administrateur à votre compte Branch.

Comment ça fonctionne

  1. Le visiteur clique sur un lien de tracking Affilae.
  2. Affilae enregistre le clic et envoie le visiteur vers votre lien Branch, avec l’identifiant du clic.
  3. Branch effectue l’attribution, ce n’est pas Affilae.
  4. Pour chaque événement attribué à Affilae, Branch envoie un postback à Affilae avec l’identifiant du clic.
  5. Affilae rattache la conversion au clic et calcule la commission.

Étape 1, activer Affilae dans Branch

Affilae fait partie des partenaires publicitaires (Ad Partners) de Branch.

  1. Dans Branch, ouvrez Configuration > Ad Partners (ancien tableau de bord : Ads > Partner Management).
  2. Recherchez Affilae et ouvrez sa fiche.
  3. Cliquez sur Enable, et acceptez les conditions si Branch vous les demande.

Étape 2, créer le lien Branch

  1. Dans Branch, créez un lien publicitaire : Create Link > Ad Link, puis sélectionnez le partenaire Affilae.
  2. Renseignez la page web de repli $fallback_url avec une adresse de votre site, par exemple votre page d’accueil.
  3. Vérifiez que le lien contient les paramètres ci-dessous, puis copiez-le.

Le lien ressemble à ceci :

https://votre-app.app.link/XXXXXX?$3p=a_affilae&~click_id={ClickID}&~campaign=Affilae&$fallback_url=https://www.votre-site.com/

Les paramètres à conserver

Paramètre Son rôle
$3pIdentifie Affilae comme partenaire publicitaire. Branch l’ajoute quand le lien est créé pour Affilae.
~click_idReçoit l’identifiant du clic Affilae. Gardez la valeur {ClickID} telle quelle : Affilae la remplace à chaque clic.
$fallback_urlPage web où arrivent les visiteurs qui n’ont pas l’application. Affilae y place la page choisie par l’affilié.
~campaignFacultatif. Nomme la campagne dans Branch, qui le transmet en utm_campaign sur les redirections web.
Astuce Vous pouvez aussi utiliser dans le lien les tokens {affiliateTrackingId}, {affiliateName}, {affiliateGroup}, {programName}, {programId}, {month}, {year} et {adId}, par exemple ~secondary_publisher={affiliateTrackingId} pour retrouver l’affilié dans Branch. Affilae remplace {affiliateName}, {affiliateTrackingId} et {ClickID} à chaque clic, et les autres tokens à la création du lien ({month} et {year} : date de création du lien).

Étape 3, envoyer les conversions à Affilae

Branch transmet les conversions à Affilae par un postback, un par événement que vous voulez rémunérer.

  1. Dans Affilae, choisissez la règle de commission des ventes de l’application et notez sa Clé/Key. Nous recommandons une règle dédiée à l’application, distincte de celles du site.
  2. Dans Branch, sur la fiche du partenaire Affilae, ouvrez Postback Config et cliquez sur Add New Postback.
  3. Choisissez l’événement, par exemple PURCHASE.
  4. Si Branch vous demande une URL de postback, ou pour vérifier celle qu’il propose, utilisez l’adresse ci-dessous, en remplaçant VOTRE_CLE_AFFILAE par la clé de la règle.
  5. Laissez l’option Send all events désactivée : Branch n’envoie alors que les événements attribués à Affilae.
https://lb.affilae.com/?key=VOTRE_CLE_AFFILAE&cids=${(last_attributed_touch_data.~click_id)!}&id=${(event_data.transaction_id)!}&amount=${(event_data.revenue)!}&currency=${(event_data.currency)!}&voucher=${(event_data.coupon)!}
Paramètre Son rôle
keyLa clé de la règle de commission Affilae
cidsL’identifiant du clic Affilae, renvoyé par Branch
idLe numéro de la commande
amountLe montant de la vente, dans la devise de la commande
currencyLa devise de la commande, en code ISO (EUR, par exemple)
voucherLe code promo utilisé, facultatif
Le montant et sa devise vont ensemble Utilisez event_data.revenue avec event_data.currency. N’associez pas revenue_in_usd à la devise de la commande : les montants seraient faux pour toute vente qui n’est pas en dollars.
Un numéro de commande unique Branch peut envoyer deux fois le même postback. Affilae ne compte qu’une conversion par numéro de commande et par règle : transmettez toujours le vrai numéro de commande dans id.

Pour rémunérer aussi les installations, ajoutez de la même façon un postback sur l’événement INSTALL, avec la clé d’une règle dédiée aux installations. Une installation n’a pas de numéro de commande : mettez dans id l’identifiant de l’événement chez Branch, ${(id)!}.

Ce que votre application doit envoyer

Pour chaque achat, l’événement que votre application envoie à Branch (PURCHASE) doit contenir ces trois données :

  • revenue : le montant de la commande.
  • currency : la devise, en code à trois lettres (EUR, USD…).
  • transaction_id : le numéro de commande, différent pour chaque achat.

Le numéro de commande devient l’identifiant de la conversion dans Affilae (colonne ID). Vous retrouvez ainsi la commande correspondante au moment de valider la conversion, et chaque achat d’un même utilisateur est enregistré comme une conversion distincte.

Les fenêtres d’attribution

Branch utilise deux fenêtres, dans l’onglet Attribution windows de la fiche Affilae : click to install (7 jours par défaut), le délai maximal entre le clic et l’installation, et click to conversion (30 jours par défaut), le délai maximal entre le clic et l’achat. Pour les régler pour Affilae seulement, activez dans cet onglet le remplacement des réglages globaux.

Côté Affilae, un postback n’est rattaché au clic de l’affilié que si ce clic date de moins que la Durée du tracking (en jours) de la règle quand le postback arrive. Réglez click to conversion sur cette durée, et click to install au plus sur cette durée : si Branch attribue une vente à un clic plus ancien, Affilae ne peut pas la rattacher à l’affilié.

Les utilisateurs iOS qui refusent le suivi Sur un parcours qui part d’un site web, ce qui est le cas des liens affiliés, Branch n’attribue pas à un partenaire l’installation d’un utilisateur iOS qui a refusé le suivi : aucun postback ne part vers Affilae pour cet utilisateur. C’est le choix de l’utilisateur, dans le cadre des règles d’Apple sur le suivi (App Tracking Transparency).

Étape 4, configurer Affilae

  1. Dans Affilae, ouvrez Configuration.
  2. Section Paramètres généraux : vérifiez que le Format d’URL du programme est bien en Server-to-Server (S2S).
  3. Puis section Personnalisation des url de tracking : activez l’option Rediriger les clics via un partenaire d’attribution (avancé). Les deux champs suivants n’apparaissent qu’après.
  4. Collez votre lien Branch dans URL de redirection du partenaire.
  5. Saisissez $fallback_url dans Paramètre de query-string de la landing page.
  6. Cliquez sur Enregistrer.
Les deux champs sont requis Le premier indique par où passer, le second dans quel paramètre Affilae place la page de destination réelle. Avec un seul des deux, les liens ne passent pas par Branch, et les ventes dans l’application ne sont pas attribuées à vos affiliés.
Vos affiliés n’utilisent que les liens Affilae Ne transmettez jamais votre lien Branch à vos affiliés : collez-le dans la configuration du programme, le Générateur de liens l’intègre automatiquement à leurs liens trackés. Vos affiliés créent leurs liens dans Affilae avec l’adresse d’une page de votre site, jamais avec un lien Branch.

Étape 5, le test final

Le test rejoue le parcours d’un client : un clic sur un lien affilié, l’installation de l’application, puis un achat. Faites-le sur un téléphone, jamais sur ordinateur : sur ordinateur, le lien Branch envoie vers votre site, et aucune installation n’est possible.

Préparer le test

  • Un partenariat de test dans Affilae, pour générer le lien. Vos règles de l’application doivent s’appliquer à son groupe.
  • Un téléphone déclaré comme appareil de test dans Branch (Test Devices), avec son identifiant publicitaire (IDFA sur iPhone, GAID sur Android), que l’application Branch Metrics DeviceID Finder vous affiche. Branch ne compte qu’une installation par appareil : avant chaque test, désinstallez l’application et réinitialisez l’appareil dans Branch (Refresh, ou Reset Device Data sur l’ancien tableau de bord). Sinon, l’installation est comptée comme une réinstallation.
  • Sur iPhone, ouvrez Réglages > Confidentialité et sécurité > Suivi, activez Autoriser les demandes de suivi des apps, puis acceptez la demande de suivi de votre application.
  • Une version de l’application sans le mode debug du SDK Branch (setDebug) : en mode debug, les événements n’apparaissent pas dans Liveview et ne déclenchent aucun postback.
  • Une personne, un téléphone à la fois, depuis le pays ciblé par votre programme. Notez l’heure de chaque action.

Le test, étape par étape

# Faites Vérifiez
1Dans Affilae, ouvrez le Générateur de liens, choisissez le partenariat de test et une page de votre site, puis copiez le Lien traqué.Le lien commence par https://lb.affilae.com/r/ et contient votre lien Branch sous forme encodée : c’est normal, ne le modifiez pas.
2Envoyez-vous ce lien par SMS ou par e-mail, et touchez-le sur le téléphone.Dans Affilae, menu du programme, Clics : une nouvelle ligne apparaît en quelques secondes, avec votre partenariat de test.
3Le store s’ouvre : installez l’application, puis ouvrez-la.Dans Branch, Liveview, filtrez sur le partenaire (ad partner (3p) = a_affilae) : l’installation apparaît, attribuée à Affilae. Comptez jusqu’à 30 minutes.
4Faites un achat dans l’application et notez son numéro de commande.Dans Liveview, onglet Webhook Records, filtré sur Affilae : le postback de l’achat apparaît, avec le code réponse 200.
5Dans Affilae, ouvrez Conversions et collez le numéro de commande dans la recherche ID.La conversion apparaît avec son montant et votre partenariat de test. Son Tunnel de conversion montre le clic de l’étape 2.
6Refusez la conversion de test : cochez-la, cliquez sur Refuser, choisissez le motif Commande test ou erreur de tracking, puis cliquez sur Confirmer. Si elle est verrouillée, le refus n’est plus proposé : sur les offres 2026, sélectionnez-la et cliquez sur Contester ; sinon, contactez le support.Une conversion de test reste une vraie conversion, avec une commission à payer. Détails dans Tester le tracking des clics et conversions.
Astuce Ne testez pas seulement l’installation. Déclenchez au moins un achat : c’est le postback de l’achat, avec la clé de la règle, qui décide de la commission.

Si quelque chose ne remonte pas

Ce que vous constatez À vérifier
Aucun clic dans ClicsLe lien vient du Générateur de liens et n’a pas été modifié. Le programme est en S2S, avec Rediriger les clics via un partenaire d’attribution (avancé) activé et ses deux champs remplis.
Le lien ouvre votre site au lieu du storeVous testez sur ordinateur, ou les redirections du lien Branch n’envoient pas vers le store. Pour voir où le lien envoie chaque plateforme, ouvrez le lien Branch sans ses paramètres, suivi de ?debug=1 (Link Debugger de Branch).
L’installation n’est pas attribuée à AffilaeL’appareil n’a pas été réinitialisé dans Branch avant le test, le suivi n’est pas autorisé sur l’iPhone, l’installation a eu lieu après la fenêtre click to install, ou le lien Branch ne contient plus $3p=a_affilae et ~click_id={ClickID}.
Vos événements de test n’apparaissent pas dans LiveviewL’application est en mode debug (setDebug), ou le téléphone n’est pas déclaré comme appareil de test pour cette application.
Installation attribuée, mais aucun postback dans Webhook RecordsAucun postback n’est configuré pour cet événement dans Postback Config, ou l’événement envoyé par l’application n’est pas celui du postback (PURCHASE, par exemple).
Postback envoyé (code 200), mais aucune conversion dans AffilaeLa clé est celle d’une règle d’un autre programme, la règle ne s’applique pas au groupe du partenariat de test, la devise envoyée ne fait pas partie des Devises de la règle, ou le test a été fait hors du pays ciblé. Sinon, contactez-nous (ci-dessous).
Conversion à 0 €L’application n’envoie pas revenue avec l’achat, ou le postback n’utilise pas event_data.revenue.
Montant faux pour les ventes qui ne sont pas en dollarsLe postback associe revenue_in_usd à la devise de la commande (voir l’étape 3).
Pas de numéro de commande, ou un deuxième achat manqueL’application n’envoie pas transaction_id, ou envoie le même pour chaque achat.
Toujours rien après 30 minutes ? Écrivez à votre contact Affilae avec : l’heure du clic et de l’achat, avec le fuseau horaire ; le système du téléphone (iOS ou Android) ; le numéro de commande de l’achat de test ; ce que montre Branch pour ce test (attribution de l’installation dans Liveview, code réponse du postback dans Webhook Records). Avec ces informations, nous pouvons retrouver votre test de notre côté.

À retenir

  • Le programme Affilae doit être en S2S.
  • Affilae s’active dans Branch, dans Ad Partners.
  • Le lien Branch contient $3p=a_affilae, ~click_id={ClickID} et $fallback_url.
  • Un postback par événement rémunéré, avec cids, le numéro de commande, et le montant dans la devise de la commande.
  • Chaque achat envoie revenue, currency et transaction_id.
  • Les fenêtres click to install et click to conversion de Branch ne dépassent pas la Durée du tracking de la règle.
  • Le lien Branch se colle dans la configuration du programme, jamais chez vos affiliés.
  • Le test se fait sur un appareil de test Branch réinitialisé, avec une application sans mode debug, et sur iPhone avec le suivi autorisé.

Articles liés

Questions
fréquentes

Voir plus de questions reponses

Le S2S fait passer vos liens en redirection et fait valider la conversion côté serveur. C’est ce qui permet à Branch d’envoyer les conversions à Affilae. Sans ce réglage, l’intégration ne peut pas fonctionner.

Dans Affilae, ouvrez Configuration, onglet Tracking, dépliez Intégration via un module Affilae et choisissez la règle dans Règles et devises : la Clé/Key s’affiche.

$3p=a_affilae, ~click_id={ClickID} et $fallback_url. Sans ~click_id, Branch ne peut pas renvoyer l’identifiant du clic, et la conversion ne peut pas être rattachée à l’affilié.

Non. Collez-le dans la configuration du programme : le Générateur de liens l’intègre automatiquement aux liens trackés de vos affiliés. Un lien Branch transmis tel quel, ou intégré à la main dans un lien Affilae, peut ne pas enregistrer les clics et les conversions.

Dans cet ordre : que le clic vient d’un lien généré par Affilae, que le postback contient bien cids, que la vente a lieu dans la Durée du tracking de la règle, et que la règle de l’application est bien associée au groupe de l’affilié.

Non. Affilae ne compte qu’une conversion par numéro de commande et par règle. Transmettez toujours le vrai numéro de commande dans id.

Le montant de la vente dans la devise de la commande, avec un point comme séparateur décimal (26.10, par exemple) : event_data.revenue avec event_data.currency.

Vérifiez que l’application n’est pas en mode debug (setDebug) : dans ce mode, Branch n’affiche pas les événements dans Liveview et n’envoie aucun postback. Vérifiez aussi que le téléphone est déclaré comme appareil de test pour cette application.

Non. Sur un parcours qui part d’un site web, Branch n’attribue pas à un partenaire un utilisateur iOS qui a refusé le suivi : aucun postback ne part vers Affilae pour lui.

Besoin d’aide ?

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

Contactez-nous