Article

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.

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

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 :

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
$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.

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 les remplace à chaque clic.

É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.

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
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

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.

La fenêtre d’attribution

Dans Branch, la fenêtre click to conversion fixe le délai pendant lequel une conversion peut encore être attribuée à un clic. Réglez-la sur la même durée que la Durée du tracking (en jours) de votre règle Affilae, dans l’onglet Attribution windows de la fiche Affilae. Si Branch attribue une vente à un clic plus ancien que cette durée, Affilae ne peut pas la rattacher à l’affilié.

Étape 4, configurer Affilae

Dans Affilae, ouvrez Configuration.
Ouvrez la section Paramètres généraux.
Ouvrez Personnalisation des url de tracking.
Vérifiez que le Format d’URL du programme est bien en Server-to-Server (S2S).
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.

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

Branch ne mesure qu’une installation par appareil, sauf sur les appareils de test. Préparez votre téléphone avant de tester.

Déclarez votre téléphone comme appareil de test Ajoutez-le dans Branch (Test devices) avec son identifiant publicitaire (IDFA sur iPhone, GAID sur Android), que l’application Branch Device ID Finder vous affiche. Après chaque test d’installation, réinitialisez l’appareil dans Branch (Reset ou Refresh selon votre tableau de bord) : sinon, l’installation suivante est comptée comme une réinstallation.

Sur iPhone, autorisez le suivi avant de tester Quand l’utilisateur refuse le suivi, Branch n’attribue pas à un partenaire les installations venues d’un lien web. Sur l’appareil de test, 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.

Désinstallez l’application si elle est présente.
Générez un lien de test dans le Générateur de liens d’Affilae, pour un de vos partenariats, et ouvrez-le sur le téléphone.
Installez l’application, puis ouvrez-la.
Déclenchez un événement configuré, un achat par exemple.
Dans Branch, vérifiez que le postback vers Affilae est parti (Liveview, ou l’onglet Postback Testing de la fiche Affilae).
Vérifiez enfin que la conversion arrive dans Affilae, avec son montant.

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.

À 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.
La fenêtre click to conversion de Branch suit 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, 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.