En bref : les liens d'attribution rapportent les activités des utilisateurs liées aux clics et aux impressions de publicités à AppsFlyer. Le fait de cliquer sur un lien d'attribution redirige l'utilisateur afin qu'il télécharge l'app. Une copie de l'URL cliquée est envoyée à AppsFlyer. Dans AppsFlyer, des portions du lien sont utilisées pour remplir les rapports de données brutes.
Lien d'attribution de base d'AppsFlyer
Le lien d'attribution de base contient les informations minimum pour enregistrer le clic et rediriger l'utilisateur afin qu'il télécharge l'app. Des paramètres supplémentaires peuvent être ajoutés au lien après le caractère ?, pour enregistrer d'autres informations.
http://app.appsflyer.com/{app_id}?pid={media_source}
Le lien d'attribution de base comprend le {App_id}, qui est l'ID d'app pour l'app de l'Apple iTunes/App Store, ou le nom du package pour Google Play, ainsi que le payant (source média). Il s'agit du minimum requis pour un lien d'attribution.
Remarque : pour les apps Amazon, utilisez le nom du bundle/package (et non l'ASIN).
Exemple
http://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822
Paramètres du lien d'attribution
Les paramètres suivants peuvent être utilisés avec le lien d'attribution généré.
Le nombre dans la colonne Type de champ correspond à la limite de caractères de la valeur du paramètre. Pour des informations sur les limites de la longueur des valeurs du paramètre, cliquez ici.
Paramètres | Nom d'affichage dans les données brutes | Description |
Type de champ |
---|---|---|---|
pid | Source média | Identifie de manière unique un partenaire intégré AppsFlyer. Ne le modifiez pas. Plus d'informations. |
Chaîne 50 |
c | Campagne | 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" |
Chaîne 100 |
af_prt |
Agence |
|
Chaîne 50 |
af_mp |
S/O |
|
|
clickid |
S/O |
Identifiant de clic unique des ad networks |
|
af_siteid |
Site ID |
Identifiant d'éditeur des réseaux publicitaires |
Chaîne 24 |
af_sub_siteid |
Identifiant du sous-site |
Identifiant du sous-réseau/de l'éditeur de la publicité |
Chaîne 50 |
af_c_id |
Identifiant de la campagne |
Fourni par l'annonceur/l'éditeur |
Chaîne 24 |
af_adset |
Ensemble de publicités |
|
Chaîne 100 |
af_adset_id |
Identifiant de l'ensemble de publicités |
Fourni par l'annonceur/l'éditeur |
Chaîne 24 |
af_ad |
Publicité |
Nom de la publicité (voir plus) - fourni par l'annonceur/l'éditeur |
Chaîne 100 |
af_ad_id |
Identifiant de publicité | Fourni par l'annonceur/l'éditeur |
Chaîne 24 |
af_ad_type |
Type de publicité |
Utilisez la convention de dénomination suivante :
|
Chaîne 24 |
af_click_lookback |
Fenêtre d'attributionrétrospective |
Remarque : n'affecte que les URL des clics, pas les URL d'impression. |
3 car. max. |
af_viewthrough_ |
S/O |
Remarque : n'affecte que les URL des impressions, pas les URL des clics. |
3 car. max. |
af_channel |
Canal |
Le canal de la source média par lequel les publicités sont distribuées, p. ex., UAC_Search, UAC_Display, Instagram, Facebook Audience Network etc. |
Chaîne Enum dynamique Chaîne 20 |
af_keywords |
Mots-clés |
Liste des mots-clés pour les campagnes ciblées sur le texte |
Chaîne 100 |
af_cost_model |
Modèle de coût |
|
Chaîne 20 |
af_cost_currency |
Devise des coûts |
|
Enum 3 car |
af_cost_value |
Valeur des coûts |
|
Chaîne 20 |
af_sub[n] (n=1-5) exemple : af_sub1 |
Sous-paramètre [n] |
Paramètre personnalisé facultatif défini par l'annonceur Pour plus d'informations sur l'utilisation de ces paramètres, consultez la section de la FAQ. |
Chaîne 100 |
af_r | S/O |
Redirect users to the specified URL for both platforms (Android and iOS). |
|
af_web_dp | S/O | URL qui redirige les utilisateurs d'ordinateur de bureau (par exemple Windows ou Mac) vers une page web différente de celle configurée dans le modèle OneLink. À utiliser pour conserver les données d'attribution des utilisateurs d'ordinateur sur d'autres plateformes (p.ex. Google Analytics ou Omniture) | |
af_dp | S/O | La valeur de secours pour lancer l'app, à utiliser en cas d'échec de la méthode Universal Link ou Android App Link, et pour les utilisateurs d'Android version 6.0 et -.Il doit seulement indiquer le chemin de base, c'est-à-dire l'activité par défaut. | |
af_force_deeplink | S/O | Force le deep linking dans l'activité indiquée dans la valeur af_dp | |
af_ref | S/O |
Les réseaux publicitaires travaillant avec les clics S2S peuvent envoyer une valeur de référence unique en utilisant le paramètre suivant : &af_ref=ReferrerValue
La valeur af_ref doit consister en une valeur unique, structurée comme suit :
NetworkName_UniqueClickValueForEachClick
Exemple : af_ref=networkname_123456789ABCDEF
Le nom de réseau peut être n'importe quelle chaîne valide. Par exemple, « networkname_int » ou juste « networkname ».
AppsFlyer peut utiliser ce paramètre pour l'attribution sur les appareils Android. AppsFlyer n'utilise pas ce paramètre pour l'attribution sur les appareils iOS ou Windows.
|
|
is_incentivized | S/O |
Booléen : true/false
Campagnes avec incitations ou sans incitations
|
|
af_param_ forwarding |
S/O |
|
|
af_os | Version OS | [Pour iOS uniquement] La version du système d'exploitation de l'appareil | |
af_model | Type de modèle iOS |
[Pour iOS uniquement] Le modèle de l'appareil. Valeurs autorisées :
|
Paramètres | Nom d'affichage dans les données brutes | Description |
Type de champ |
---|---|---|---|
is_retargeting |
S'agit-il de retargeting (campagne) | Les URL cliquables des campagnes de retargeting doivent inclure &is_retargeting=true .Si le paramètre n'est pas inclus ou si sa valeur est « fausse », la campagne est considérée comme une campagne d'acquisition d'utilisateur normale. |
Enum 5 car |
af_reengagement_window |
Fenêtre de réengagement |
Modifiez la fenêtre d'attribution du réengagement en ajoutant ce paramètre au lien d'attribution. Les options de plage de fenêtres possibles sont les suivantes :
Valeur par défaut : 30 jours Exemple : |
3 car. max. |
Paramètres de type de publicité
En fonction du type de publicités, vous pouvez également envoyer le paramètre de visibilité correspondant en précisant les spécifications de l'engagement. Vous trouverez ci-dessous une liste des valeurs possibles pour « af_ad_type » ainsi que les paramètres de visibilité attendus.
Paramètre | Format de la valeur | Description |
---|---|---|
af_video_total_length | Durée totale possible de la vidéo | |
af_video_played_length | Durée de la vidéo ayant été vue | |
af_playable_played_length | Durée de l'élément jouable ayant été joué une fois complètement chargé | |
af_ad_time_viewed | Durée pendant laquelle le modèle de publicité était visible à l'écran | |
af_ad_displayed_percent | Pourcentage maximal du modèle de publicité visible sur l'écran de l'appareil | |
af_audio_total_length | Durée possible totale de l'audio | |
af_audio_played_length | Durée de l'audio ayant été entendue |
Paramètres Android spécifiques
Paramètre | Nom d'affichage dans les données brutes | Description |
Type de champ |
---|---|---|---|
advertising_id |
Advertising ID |
Google Advertising ID - Doit être pris en charge par le réseau publicitaire |
40 caractères max. |
sha1_advertising_id |
S/O |
Google Advertising ID haché avec SHA1 - Doit être pris en charge par le réseau publicitaire |
|
md5_advertising_id |
S/O |
Google Advertising ID haché avec SHA1 - Doit être pris en charge par le réseau publicitaire |
Pris en charge avec les installations et les réattributions uniquement |
android_id |
Android ID |
Device Android_id - Doit être pris en charge par le réseau publicitaire |
20 caractères max. |
sha1_android_id |
S/O |
Device Android_id haché avec SHA1 - Doit être pris en charge par le réseau publicitaire |
|
md5_android_id |
S/O |
Device Android_id haché avec MD5 - Doit être pris en charge par le réseau publicitaire |
Pris en charge avec les installations et les réattributions uniquement |
imei |
imei |
ID IMEI de l'appareil |
|
sha1_imei |
S/O |
ID IMEI appareil haché avec SHA1 - Doit être pris en charge par le réseau publicitaire |
|
md5_imei |
S/O |
ID IMEI appareil haché avec MD5 - Doit être pris en charge par le réseau publicitaire |
|
oaid |
OAID |
Ouvrir l'identifiant de périphérique anonyme |
Disponible à partir du SDK Android version 4.10.3 |
sha1_oaid |
S/O |
Ouvrir l'identifiant de périphérique anonyme haché avec SHA1 - Doit être pris en charge par le réseau publicitaire |
Disponible à partir du SDK Android version 4.10.3 |
md5_oaid |
S/O | Ouvrir l'identifiant de périphérique anonyme haché avec MD5 - Doit être pris en charge par le réseau publicitaire | Disponible à partir du SDK Android version 4.10.3 |
af_android_url |
S/O |
Redirige les utilisateurs d'Android vers une URL différente de celle de la page de l'application sur Google Play. Utilisation d'applications dès l'achat |
|
sha1_el |
S/O |
Utilisé pour les ordinateurs portables comme pour l'attribution mobile - e-mail haché avec SHA1. Doit être pris en charge par le réseau publicitaire |
|
fire_advertising_id |
S/O |
Identifiant de publicité Amazon Fire |
|
Paramètres iOS spécifiques
Paramètres | Nom d'affichage | Description |
---|---|---|
idfa |
IDFA |
Utilisez les majuscules. Doit être pris en charge par le réseau publicitaire Type de champ : 40 caractères max. |
idfv |
IDFV | Utilisez des majuscules. |
af_ios_url |
Redirige les utilisateurs iOS (iPhone ou iPad) vers une URL différente de la page des apps sur iTunes |
Utilisez pour les redirections sur la page d'accueil |
af_ios_fallback |
S/O | |
sha1_idfa |
S/O |
IDFA haché avec SHA1. Doit être pris en charge par le réseau publicitaire |
sha1_idfv |
S/O |
IDFV haché avec SHA1. |
mac |
S/O |
Adresse mac des appareils. Doit être pris en charge par le réseau publicitaire |
md5_idfv |
S/O |
IDFV haché avec MD5 |
sha1_mac |
S/O |
Adresse des appareils mac hachée avec SHA1. Doit être pris en charge par le réseau publicitaire |
Exemple
http://app.appsflyer.com/{app_id}/?pid=airpush_int&c=RedBanner&
af_siteid={publisher_id}&af_sub1=1.5&af_sub2=USD&af_sub3=burst_campaign
Tous les paramètres sont disponibles dans le Rapport d'installations et les Analyses, Rapports et API.
Paramètres personnalisés
Vous pouvez spécifier des paramètres personnalisés en plus des paramètres par défaut, spécifiques à Android et à iOS. Ces paramètres personnalisés vous aideront à personnaliser l'expérience utilisateur et le contenu en fonction du lien d'attribution qui mène à une installation.
Vous pouvez ajouter un paramètre personnalisé au lien d'attribution au format parameter=value
. Par exemple :
http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_value
Voici deux choses à savoir sur les paramètres personnalisés :
- Les paramètres personnalisés n'apparaissent pas dans les données brutes.
- Les paramètres personnalisés peuvent être récupérés à partir de l'API du SDK Obtenir les données de conversion.
Pourquoi l'ID éditeur (PID) est-il le paramètre le plus important ?
Parmi tous les paramètres de lien d'attribution disponibles, le PID se distingue comme étant le seul paramètre qui DOIT être inclus dans chaque lien d'attribution.
Le PID, l'identifiant de l'éditeur, est le nom de la source média. C'est le champ principal pour l'attribution de l'installation à sa source.
Chaque partenaire intégré possède son propre PID, finissant en « _int ». Lorsque vous utilisez les liens d'attribution personnalisés, vous pouvez définir le nom de PID à votre convenance, dans la mesure où il n'est pas réservé par les partenaires intégrés.
Voici quelques exemples d'identifiants d'importants éditeurs intégrés : organic, googleadwords_int (Google AdWords), Facebook ads, Twitter. Vous pouvez utiliser le nom que vous souhaitez pour les sources non intégrées, comme des e-mails, des sms ou des pigeons voyageurs.
Éviter les problèmes courants de PID
Pensez aux règles suivantes pour les PID quand vous utilisez ce paramètre :
En l'absence du PID dans le lien d'attribution, l'utilisateur est automatiquement attribué à une source média « inexistante », et la source d'installation originale disparaît.
Astuce
Évitez d'utiliser des espaces dans la valeur du PID, ou veillez à encoder vos liens d'attribution dans l'URL avant de les utiliser.
Niveaux de granularité des données
Vous pouvez utiliser jusqu'à quatre paramètres d'URL pour analyser en profondeur la performance de vos publicités.
L'utilisation des 4 paramètres sur tous vos liens d'attribution actifs vous permet :
- D'attribuer tous les événements et installations des utilisateurs à certaines publicités spécifiques
- D'analyser en profondeur et de comparer la performance de toutes vos publicités par ensemble de publicités, par campagne et par source média sur les rapports agrégés pour optimiser à chaque niveau
- De comparer toutes vos publicités sur toutes vos sources médias sur les rapports de données brutes et votre tableau Pivot
Les paramètres sont :
Source média (pid=)
nom de campagne (c=)
Ensemble de publicités (af_adset=)
Nom de publicité (af_ad=)
Exemple
Le lien d'attribution suivant utilise 4 niveaux de granularité pour enregistrer la publicité « cachemire » dans l'ad set « manteaux » de la campagne « hiver » diffusée sur la source média « networkx » intégrée.
http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere
FAQ
Dois-je utiliser des lettres majuscules ou minuscules pour les paramètres ?
Vous pouvez utiliser l'un ou l'autre, mais veillez à rester cohérent. Si vous définissez un paramètre personnalisé avec des caractères majuscules ou minuscules, assurez-vous de toujours utiliser ce paramètre.
Par exemple, si vous définissez pid=MyMediaSource, assurez-vous de toujours l'utiliser. Si vous utilisez pid=MyMediaSource sur un lien d'attribution et pid=mymediasource sur un autre, des divergences dans les données peuvent survenir. Il en va de même pour tout autre paramètre que vous définissez sur le lien d'attribution.
Les liens d'attribution d'Appsflyer sont-ils dynamiques ou statiques ?
Comment faire la différence entre un lien dynamique ou statique ?
Si le lien d'attribution comporte des paramètres, il s'agit d'un lien d'attribution long prédéfini, et il est donc statique.
Seules les URL raccourcies, utilisées pour les liens d'attribution personnalisés, sont dynamiques.
Cela signifie que lorsque vous commencez à utiliser un lien d'attribution pour un partenaire intégré, ou une URL longue pour des médias propres, ceux-ci ne changeront pas quels que soient les prospects qui interagissent avec eux, même si vous modifiez les valeurs du lien d'attribution sur le tableau de bord AppsFlyer. Si vous souhaitez faire une modification, vous devrez alors utiliser la nouvelle URL longue.
Par ailleurs, les URL raccourcies pour les médias propres ne contiennent pas directement de paramètres. Lorsqu'un prospect interagit avec une URL raccourcie d'AppsFlyer, il est redirigé vers AppsFlyer, et les paramètres définis s'appliquent de manière dynamique.
Qu'est-ce que ce message d'erreur du Play Store ?
Si vous rencontrez le message d'erreur suivant dans le Play Store après avoir suivi un lien d'attribution :
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#
Habituellement, ces caractères sont inclus dans le lien parce qu'il s'agit de macros, et ils sont remplacés dynamiquement par une valeur. Ce n'est donc pas un problème très important, et vous pouvez ignorer le message.
À quoi servent les Paramètres de souscripteur ?
Exemple
Une application de transport à la demande, Luber, a prévu des créatifs avec 3 modèles de couleur : bleu, jaune et rouge. Linda, distributrice mobile, veut tester le modèle de couleur qui génère le plus d'installations. Pour cela, elle ajoute &af_sub3=blue
dans les liens d'attribution de toutes les publicités bleues dans TOUTES les sources médias non-SRN. Elle fait la même chose pour les publicités jaunes et rouges. Une fois ces informations analysées et affichées dans les rapports des données brutes, Linda peut évaluer le succès des publicités selon les différentes couleurs, et choisir celle qui obtient le meilleur taux de conversion.
Quelle est la longueur maximum d'un nom de campagne ?
c_name_exceeded_max_length
Astuce
Vidéo: Noam Gohary de Playtika révèlent les 3 meilleures méthodes pour optimiser votre structure de lien et vos données.