S2S – Branch
Découvrez les articles les plus lus
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.
Comment ça fonctionne
- Le visiteur clique sur un lien de tracking Affilae.
- Affilae enregistre le clic et envoie le visiteur vers votre lien Branch, avec l’identifiant du clic.
- Branch effectue l’attribution, ce n’est pas Affilae.
- Pour chaque événement attribué à Affilae, Branch envoie un postback à Affilae avec l’identifiant du clic.
- 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.
- Dans Branch, ouvrez Configuration > Ad Partners (ancien tableau de bord : Ads > Partner Management).
- Recherchez Affilae et ouvrez sa fiche.
- Cliquez sur Enable, et acceptez les conditions si Branch vous les demande.
Étape 2, créer le lien Branch
- Dans Branch, créez un lien publicitaire : Create Link > Ad Link, puis sélectionnez le partenaire Affilae.
- Renseignez la page web de repli $fallback_url avec une adresse de votre site, par exemple votre page d’accueil.
- Vérifiez que le lien contient les paramètres ci-dessous, puis copiez-le.
Le lien ressemble à ceci :
Les paramètres à conserver
| Paramètre | Son rôle |
|---|---|
| $3p | Identifie Affilae comme partenaire publicitaire. Branch l’ajoute quand le lien est créé pour Affilae. |
| ~click_id | Reçoit l’identifiant du clic Affilae. Gardez la valeur {ClickID} telle quelle : Affilae la remplace à chaque clic. |
| $fallback_url | Page web où arrivent les visiteurs qui n’ont pas l’application. Affilae y place la page choisie par l’affilié. |
| ~campaign | Facultatif. Nomme la campagne dans Branch, qui le transmet en utm_campaign sur les redirections web. |
Étape 3, envoyer les conversions à Affilae
Branch transmet les conversions à Affilae par un postback, un par événement que vous voulez rémunérer.
- 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.
- Dans Branch, sur la fiche du partenaire Affilae, ouvrez Postback Config et cliquez sur Add New Postback.
- Choisissez l’événement, par exemple PURCHASE.
- 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.
- Laissez l’option Send all events désactivée : Branch n’envoie alors que les événements attribués à Affilae.
| Paramètre | Son rôle |
|---|---|
| key | La clé de la règle de commission Affilae |
| cids | L’identifiant du clic Affilae, renvoyé par Branch |
| id | Le numéro de la commande |
| amount | Le montant de la vente, dans la devise de la commande |
| currency | La devise de la commande, en code ISO (EUR, par exemple) |
| voucher | Le code promo utilisé, facultatif |
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é.
Étape 4, configurer Affilae
- Dans Affilae, ouvrez Configuration.
- Section Paramètres généraux : vérifiez que le Format d’URL du programme est bien en Server-to-Server (S2S).
- 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.
- Collez votre lien Branch dans URL de redirection du partenaire.
- Saisissez $fallback_url dans Paramètre de query-string de la landing page.
- Cliquez sur Enregistrer.
É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 |
|---|---|---|
| 1 | Dans 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. |
| 2 | Envoyez-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. |
| 3 | Le 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. |
| 4 | Faites 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. |
| 5 | Dans 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. |
| 6 | Refusez 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. |
Si quelque chose ne remonte pas
| Ce que vous constatez | À vérifier |
|---|---|
| Aucun clic dans Clics | Le 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 store | Vous 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 à Affilae | L’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 Liveview | L’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 Records | Aucun 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 Affilae | La 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 dollars | Le 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 manque | L’application n’envoie pas transaction_id, ou envoie le même pour chaque achat. |
À 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
- S2S, Server-to-Server
- S2S – AppsFlyer
- S2S – Adjust
- Fondamentaux du Tracking Affilae
- Tester le tracking des clics et conversions
- Toutes les intégrations disponibles
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.
