Avant de commencer
Pour intégrer l'annonceur sur AppsFlyer, inscrivez-vous en tant que partenaire d'intégration publicitaire.
Si vous avez déjà une intégration avec AppsFlyer, contactez leur équipe à [email protected].
Intégration générale
Pour démarrer l'intégration, vous devez envoyer à AppsFlyer l'URL de suivi et l'URL de postback à des fins de reporting.
URL de suivi d'AppsFlyer
Sur AppsFlyer, allez dans Configuration > Intégrations actives > Lien d'attribution.
Préparez une URL de suivi AppsFlyer pour l'intégration en utilisant les paramètres obligatoires.
Paramètres obligatoires du lien de suivi :
clickid | {clickid} | Un identifiant de clic unique |
af_siteid | {pid} | Un identifiant unique qui identifie l'éditeur |
af_c_id | {offer_id} | L'ID de l'offre |
c | {offer_name} | Le titre de l'offre |
⚠️ Vous n'avez pas besoin de remplir le pid=medianame_int, l'équipe d'AppsFlyer s'en charge.
L'exemple d'URL de suivi d'AppsFlyer :
http://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid={clickid}&af_siteid={pid}&af_c_id={offer_id}&c={nom_de_l'offre}
2. Sur Affise, insérez le lien dans le champ URL de suivi dans Offres > une certaine offre > Suivi.
Clé cryptée
Il peut y avoir des cas où vous avez besoin de transmettre le revenu à votre annonceur dans une URL de suivi d'AppsFlyer. Vous indiquez ce revenu dans Offres > une certaine offre > Paiements.
Si vous ne souhaitez pas révéler la valeur réelle du coût, vous pouvez la crypter dans une URL de suivi AppsFlyer en utilisant la clé af_cost_value={max_income}.
🔎 Le système Affise compte tous les paiements de l'offre : généraux et personnels.
Pour rendre le paramètre disponible, procédez comme suit :
Prenez votre clé de cryptage sur AppsFlyer.
Dans le panneau d'administration Affise > Paramètres > Appsflyer, insérez cette clé de cryptage dans le champ Clé de cryptage.
Une fois que vous avez effectué l'intégration du cryptage des coûts avec AppsFlyer, vous accédez à la liste des réseaux publicitaires supportant les coûts.
Lorsque l'intégration des coûts est prête, mettez à jour votre URL de suivi AppsFlyer avec af_cost_value={max_income} et utilisez-la dans votre offre Affise.
L'URL se présente comme suit
https://app.appsflyer.com/id554782625?&clickid={clickid}&af_siteid={pid}&af_c_id={offer_id}&af_cost_model=CPI&af_cost_value={max_income}&af_cost_currency=USD.🔎 Pour en savoir plus sur le coût crypté , cliquez ici.
URL de postback Affise
Pour recevoir des conversions sur Affise, vous devez obtenir un lien de postback sur Affise et le configurer sur AppsFlyer.
Vous pouvez configurer deux types d'URL de postback Affise en fonction de vos besoins : postback d'installation globale et postback d'événement in-app.
Sur AppsFlyer, allez dans Profil > Gestion du postback > Postbacks par défaut.
Configurez votre postback dans les champs URL de postback d'installation et URL de postback d'événement in-app.
Ajoutez les champs requis. Vous devez utiliser les paramètres de postback Affise et les macros AppsFlyer.
Les paramètres et macros obligatoires sont
pid | {af_siteid} | ID de l'éditeur. Vérifier à la fois Installer et In-app. |
offer_id | {af_c_id} | ID de l'offre sur Affise. A vérifier à l'installation et dans l'application. |
clickid | {clickid} | ID du clic. Vérifier à la fois Install et In-app. |
goal | {partner_event_id} | Valeur de l'objectif Affise correspondant au nom de l'événement AppsFlyer. Cochez In-app uniquement. |
4. Optionnel. Ajoutez des champs personnalisés si nécessaire pour transmettre des informations supplémentaires.
Un lien postback Affise pour l'exemple AppsFlyer :
https://offers-rocketcompany.affise.com/postback?pid={af_siteid}&offer_id={af_c_id}&clickid={clickid}&goal={partner_event_id}&custom_field1={oaid}5. Facultatif. Si vous travaillez avec des campagnes d'applications iOS, il est nécessaire d'effectuer la même configuration dans Profil > Gestion du postback > Confidentialité avancée. La seule différence est que vous n'avez pas besoin d'utiliser l'ID de clic et que vous avez besoin de plus de paramètres supplémentaires pour une meilleure correspondance des clics et des conversions.
🔎 Pour en savoir plus sur l'attribution probabiliste, cliquez ici.
Retour d'événement in-app
Pour recevoir des rétrocessions d'événements in-app, configurez des objectifs dans Offres > une certaine offre > Paiements.
⚠️ La valeur d'objectif"1" dans le système Affise se réfère toujours à l'événement d'installation . Si l'objectif n'est pas spécifié dans l'URL de postback, la conversion a la valeur d'objectif"1" par défaut.
La valeur de l'objectif se réfère à la valeur de l'événement AppsFlyer :
Fraud install postback
Lorsque vous recevez des postbacks d'AppsFlyer, le système Affise ne fait pas automatiquement la différence entre les postbacks réels et les postbacks frauduleux. Par conséquent, toutes les conversions sont enregistrées comme des conversions réelles et vous devez les payer.
Pour résoudre ce problème, vous pouvez mettre en place des paiements nuls et un postback séparé pour que les conversions frauduleuses soient refusées.
Pour mettre en place des paiements nuls, procédez comme suit :
Dans Offres > une certaine offre > Paiements, ajoutez un nouveau paiement.
Définissez le revenu et les paiements à 0.
Ajoutez un nouvel objectif à ce paiement.
Pour refuser des conversions basées sur des postbacks frauduleux, vous devez configurer une URL de postback distincte pour les conversions frauduleuses :
Ajoutez le paramètre comment avec les macros AppsFlyer {blocked-reason}, {blocked-reason-value}, {blocked-sub-reason} pour définir les données de fraude dans l'URL de postback Affise.
Ajoutez le paramètre status=3 à l'URL de postback Affise pour refuser automatiquement les conversions frauduleuses.
Ajoutez l'objectif que vous avez défini pour zéro paiement.
Exemple d'URL de postback d'installation de fraude :
http://offers.rocketcompany.affise.com/postback?clickid={clickid}&custom_field1={af_siteid}&comment={blocked-reason}_{blocked-reason-value}_{blocked-sub-reason}_blockedbyAF&status=3&goal=4Attribution probabiliste
Lorsque vous travaillez avec l'attribution probabiliste, vous ne pouvez pas transmettre la valeur de l'ID du clic. Les URLs pour l'intégration requièrent d'autres paramètres obligatoires et des macros.
URL de suivi probabiliste AppsFlyer
Mettez à jour une URL de suivi AppsFlyer avec les macros obligatoires {pid} et {offer_id} .
Ajoutez d'autres paramètres et macros si nécessaire.
L'exemple d'URL de suivi AppsFlyer :
https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&af_siteid={pid}&af_c_id={offer_id}Données User-Agent pour les navigateurs basés sur Chrome 110
Il existe une particularité pour la mise en place d'une attribution probabiliste (à la fois pour les clics et les impressions) pour les appareils Android ou de bureau initiés à partir de navigateurs basés sur Chrome (Chrome, Edge, Opera, et plus). Ce type de trafic comprend des données d'en-tête user-agent réduites. À cet égard, vous devez transmettre les informations relatives à la version du système d'exploitation et au modèle de l'appareil en même temps que les données du user-agent.
Pour transmettre correctement les données, outre les macros obligatoires {pid} et {offer_id} pour les clics, et les macros {oid} et {aid} pour les impressions, utilisez les macros Affise suivantes :
{device_ua} pour transmettre les données relatives à l'agent utilisateur.
{os_version} pour transmettre les données relatives à la version du système d'exploitation.
{device_model} pour transmettre les données relatives au modèle de l'appareil.
🔎 Trouvez les paramètres d'AppsFlyer ici.
L'exemple d'URL de suivi d'AppsFlyer :
https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&af_siteid={pid}&af_c_id={offer_id}&af_ua={device_ua}&af_os_version={os_version}&af_model={device_model}.URL de postback probabiliste Affise
L'exemple recommandé du lien de postback probabiliste pour Appsflyer :
https://offers-rocketcompany.affise.com/probattribution?action_id={postback_id}&goal={partner_event_id}&offer_id={af_c_id}&pid={af_siteid}&country={country_code}×tamp={attributed_touch_hour}&sub2={af_sub_siteid}&action_timestamp={event_hour}&platform={platform}.🔎 Vous trouverez d'autres paramètres ici.
Si vous souhaitez utiliser les options Durée de vie de la session Click&Impression ou Durée de vie minimale de la session Click&Impression, ajoutez les paramètres timestamp et action_timestamp à votre lien postback. Pour plus de détails, cliquez ici.
⚠️ Appsflyer envoie des postbacks avec un délai pouvant aller jusqu'à 24 heures. Par exemple, une conversion a eu lieu à 14h30, mais le postback a été envoyé à 19h45. L'heure d'envoi d'un postback est aléatoire.
Ce délai entraîne plusieurs limitations :
Pas de possibilité d'utiliser le rapport Time to Action (CTIT) sur Affise.
Pas de possibilité d'utiliser CR, Click, et KPI Automation dans une période de moins de 24 heures.
Veuillez contacter l'équipe de support client d'Affise pour toutes les questions soulevées via l'e-mail : [email protected].