Macros de postback pour les réseaux publicitaires – AppsFlyer Support

En bref : en tant qu'ad network, vous pouvez définir le contenu et les points de terminaison des postbacks qui vous sont envoyés dans le cadre de votre intégration avec AppsFlyer. Les postbacks sont liés à l'engagement des utilisateurs d'app, par exemple les installations, les évènements in-app, les réengagements, etc.

Guides du postback des partenaires intégrés :

Les postbacks pour les réseaux publicitaires

Configuration du postback : pour demander des modifications de vos paramètres de postback, contactez integrations@appsflyer.com ou votre responsable du développement partenaire AppsFlyer.
Types de postback : les postbacks sont disponibles pour les événements d'installation et événements in-app, ainsi que pour les installations et événements in-app bloqués en raison soit d'une fraude identifiée par Protect360, soit d'une violation des règles de validation du ciblage.

Sources des données du postback
Source	Description
Paramètres du lien d'attribution	Paramètres fournis par le partenaire sur les URL de clic et d'impression Exemple : Paramètre de l'ID de clic sur le lien d'attribution - "&click_id=CLICK_ID"
ID de partenaire dans AppsFlyer	Identifiants uniques fournis à l'annonceur par le partenaire Exemples : ID d'app, ID de compte, ID d'utilisateur, ID de réseau
Informations provenant du SDK	Informations extraites de l'appareil par le SDK AppsFlyer Exemple : les identifiants des appareils iOS peuvent être extraits en utilisant "&IDFA=(idfa)" dans le postback
Issue de la plate-forme AppsFlyer	Infos issues de la plate-forme AppsFlyer.
Protect360 et règles de validation	Informations sur les installations identifiées comme frauduleuses, les installations qui violent les règles de ciblage des campagnes, ainsi que les événements in-app qui en découlent

Macros de postback

Lorsque les macros sont intégrées à un postback, elles sont remplacées par les données de l'utilisateur correspondant. Par exemple, pour obtenir l'adresse IP d'un utilisateur qui installe l'application, intégrez country_code=(ip) dans la structure du postback. Les macros prises en charge sont répertoriées dans le tableau suivant :

Signification des colonnes du tableau suivant :

Source : origine des données.
- Lien : liens d'attribution
- SDK : SDK AppsFlyer intégré dans l'app ou l'API de serveur à serveur
- AF : après traitement par AppsFlyer
Envoyer tout: si oui, vous pouvez recevoir les données des installations et événements qui ont été attribués à d'autres réseaux ou en organique. (En d'autres termes : qui ne vous est pas attribué).
[Base] Macros pour tous les postbacks : macros relatives à l'installation, à l'événement in-app et aux postbacks d'événement qui ont été rejetés
[Facultatif] concerne les événements in-app et les événements rejetés tels qu'indiqué dans la colonne (rejeté, in-app)

Macros—installations, événements in-app et événements rejetés
Macro de postback (nom)	Source	Envoyer tout	Description	[Par défaut] Macros pour tous les postbacks	Événements in-app et rejetés [optionnel]
advertising_id	SDK	Oui	ID d'appareil réinitialisable par l'utilisateur, également nommé GAID. Également disponible sous la forme : (sha1-advertiserId)	Oui
app_name	SDK	Oui	Nom de l'app défini par l'annonceur	Oui
appsflyer_id	SDK	Oui	Identifiant unique AppsFlyer enregistré lors de la conversion	Oui
attributed_touch_type	SDK	Non	Valeurs possibles click, impression, TV, préinstallé	Oui
blocked_reason	AF	Non	Fraude/motif des règles de validation	Non	Rejeté
blocked_reason_value	AF	Non	Fraude/valeur du motif des règles de validation (ex : ID de site)	Non	Rejeté
blocked_sub_reason	AF	Non	Fraude/sous-motif des règles de validation	Non	Rejeté
bundle_id	SDK	Oui	iOS : identification visant à faire correspondre une app ou un groupe d'apps dans iOS (cf ID de groupe des développeurs Apple) Android : le nom de l'app	Oui
country_code	AF	Oui	Code pays utilisant ISO 3166 (alpha-2) Exemple : US, CN.	Oui
event_name	SDK	Oui	Nom attribué à un événement	Non	Achat
event_revenue_USD	AF	Oui	Valeur de l'événement en USD	Non	Achat
event_revenue	SDK	Oui	Valeur de l'événement raporté par le SDK à l'aide de event_revenue_currency, ou la devise que vous avez sélectionnée.	Non	Achat
event_revenue _currency	SDK	Oui	Le code de devise du revenu d'évènement rapporté dans l'événement, ou la devise que vous avez sélectionnée.	Non	Achat
event_time	SDK	Oui	Heure de l'évènement	Non	Achat
event_value	SDK	Oui	L'événement in-app comporte des attributs dotés de valeurs, lesquelles peuvent être entièrement envoyées entièrement au postback au format JSON. URL encodée à partir de la macro (encodage).	Non	Achat
idfa	SDK	Oui	ID publicitaire réinitialisable par l'utilisateur qui est présent sur les appareils iOS. Également disponible sous : (sha1-idfa)	Oui
idfv	SDK	Oui	Identifiant unique par utilisateur et par vendeur présent sur les appareils IOS	Oui
install_time	SDK	Oui	Horodateur de l'installation	Oui
install_unix_ts	SDK	Oui	Installer l'horodateur au format unix	Oui
is_attributed	AF	Oui	Un drapeau marquant si l'installation ou l'événement est attribué à cette source média	Oui
is_lat	SDK	Oui	Suivi publicitaire limité (LAT) : le lancement du LAT iOS 14 a été rendu obsolète par Apple. Définissez le statut de confidentialité des utilisateurs à l'aide de ATT. Dans ce cas, ne prenez pas en compte is_lat. Versions antérieures à IOS 14, si défini sur «true», l'IDFA n'est pas disponible et est réglé sur 0. Lorsque «true», l'utilisateur a choisi de refuser les publicités basées sur les intérêts. Ceci n'empêche pas la collecte de GAID.	Oui
is_primary_attribution	AF	Oui	Si défini sur «false», voir is_retargeting.	Non	Achat
is_retargeting	Lien	Non	Utilisable associé à is_primary_attribution. En savoir plus sur la double attribution des événements de retargeting. Si «true» (1), l'événement est rapporté dans le cadre d'une campagne de retargeting, la source média étant la source média de retargeting. Si «false» (0) et is_primary_attribution est «false», l'événement fait partie d'une campagne de retargeting mais la source média de référence est la source média d'attribution de l'utilisateur	Non
langue	SDK	Oui	Langue (locale) signalée par l'appareil et définie par l'OS de l'appareil.	Oui
OAID	SDK	Oui	ID réinitialisable par l'utilisateur présents sur certains appareils Android, remplace généralement le GAID	Oui
partner_event_id	AF	Oui	Nom/ID de l'événement correspondant sur la plate-forme du partenaire	Non	Achat
platform	SDK	Oui	Plate-forme de l'appareil : iOS, Android ou Windows Mobile	Oui
retargeting_ conversion_type	AF	Non	Indicateur précisant s'il s'agit d'une réattribution ou d'un réengagement	Retargeting uniquement
app_version	SDK	Oui	Nom de la version de l'app défini par le développeur dans le code de l'app	Oui
app_id	SDK	Oui	L'ID de l'app tel que rapporté par l'app.	Oui
att-0-1	SDK	Oui	Valeurs possibles : 1 : statut ATT autorisé ou af_authorized. 0 : tout autre statut ATT.	Oui
att-status	SDK	Oui	Le statut ATT rapporté par iOS. Comme autorisé, not_determined. Dans certains cas, il n'y a pas de valeur et "" est renvoyé.	Oui
af_ad	Lien	Non	Nom de la publicité (voir plus) - fourni par l'annonceur/l'éditeur	Oui	Oui
af_ad_id	Lien	Non	Fourni par l'annonceur/l'éditeur	Oui	Oui
af_adset	Lien	Non	Fourni par l'annonceur/l'éditeur Adset représente un niveau intermédiaire dans la hiérarchie entre campagne et publicité. En savoir plus	Oui	Oui
af_adset_id	Lien	Non	Fourni par l'annonceur/l'éditeur	Oui	Oui
C	Lien	Non	Fourni par l'annonceur/l'éditeur. Les noms de campagne comportant plus de 100 caractères sont affichés dans le tableau de bord comme "c_name_exceeded_max_length"	Oui	Oui
af_c_id	Lien	Non	Fourni par l'annonceur/l'éditeur	Oui	Oui
af_siteid	Lien	Non	L'ID unique qui définit l'éditeur qui affiche la publicité. En savoir plus	Oui	Oui
af_subsite_id	Lien	Non	ID du sous-réseau/de l'éditeur. Si en plus de l'éditeur principal (ID de site) il existe un sous-éditeur, ou bien si vous souhaitez inclure des infos supplémentaires, comme le type de publicité ou l'emplacement dans l'app (bannière, interstitiel, vidéo, etc.), veuillez utiliser af_sub_siteid. Exemple : af_sub_siteid =ABCD_4567	Oui	Oui
af_ad_type	Lien	Non	Utiliser la convention de dénomination suivante : text : une unité publicitaire qui ne contient que du texte, par exemple un résultat de recherche banner :un format de base qui apparaît en haut ou en bas de l'écran de l'appareil interstitial :une annonce pleine page qui apparaît pendant les pauses faites durant l'expérience video: une vidéo standard, qui est non-rewarded (sans récompense) rewarded_video : un bloc de publicités qui offre des récompenses in-app aux utilisateurs qui décident de regarder une vidéo playable :un bloc de publicités contenant un aperçu interactif de l'expérience de l'app sponsor_contenu :un lien inclus dans un extrait de contenu sponsorisé, comme un article publicitaire audio : une publicité audio	Oui	Oui
imei	SDK	Oui	A unique number used to identify mobile phones	Oui

Macros d'évènements in-app uniquement

Les exemples suivant concernent les postbacks d'événement in-app qui sont disponibles pour les partenaires.

Exemple

Le modèle de postback d'événement "&event=(event)&json=(encode)" a été traduit dans le postback suivant pour un événement af_purchase spécifique :

&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%
22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22
af_content_type%22%3A%22default_type%22%7D%0A

La valeur JSON décodée de ce postback est

{"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Valeurs chiffrées

Les postbacks peuvent contenir des caractères spéciaux, c'est à dire non alphanumériques. Pour transférer ces valeurs via postback sans les altérer, AppsFlyer encode les valeurs qui ne sont pas alphanumériques.

Pour décoder ou encoder un postback, utilisez un service d'encodage web.

Exemple de postbacks

Exemples de postbacks d'installations

http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)

http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)

Exemples de postbacks d'événements in-app

http://YourCompanyDomain.com?site_id=(publisher_id)&
device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android_id)&
install_time=(install_unix_ts)&event_name=(event_name)&currency=(currency)&
json=(event_value)

http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&idfa=(idfa)&install_time=(install_unix_ts)
&event_name=(event_name)&currency=(currency)&json=(event_value)

Exemple de postback d'événement in-app

Paramètres d'événements :

Nom de l'événement : af_revenue
Revenu de l'événement : 120.00
Devise de l'événement : USD
Valeur de l'événement : {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Postback :

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&device_ip=
38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&
android_id=9aaeecc4455xxxxx&;install_time=1451923560&event_name=af_purchase&
currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue
%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id
%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A