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.
| 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)
| 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 :
|
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 |
|
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 |
|
Oui | Oui |
| af_subsite_id | Lien | Non |
|
Oui | Oui |
| af_ad_type | Lien | Non |
Utiliser la convention de dénomination suivante :
|
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)¤cy=(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)¤cy=(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