En bref : en savoir plus sur la structure et les paramètres des liens d’attribution.
Présentation
Les liens d'attribution permettent aux annonceurs de récupérer des données concernant l'engagement d'un utilisateur avec une publicité. Les liens d'attribution sont placés à la fin de la publicité, ils renseignent AppsFlyer lorsque un utilisateur interagit avec une publicité. L'engagement peut se faire via un clic sur une publicité ou lorsqu'un utilisateur affiche une impression publicitaire. Une copie de l'URL d'attribution est envoyée à AppsFlyer.
Les liens d’attribution sont générés via OneLink ou à partir d'un lien de plateforme unique.
OneLink (lien multi-plateforme) | Lien vers une plateforme unique | |
---|---|---|
Description et utilisation |
Vous pouvez l'utiliser quand :
|
Vous pouvez l'utiliser quand :
|
Conditions préalables |
Aucun | |
Informations obligatoires |
||
URL de base |
{subdomain}.onelink.me |
app.appsflyer.com |
Identifiant unique |
ID du template |
app_id |
Structure de l'URL | https://{subdomain}.onelink.me/ |
|
Exemple | https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int |
https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int& |
Paramètres du lien d'attribution
- Les paramètres énumérés sont disponibles pour être utilisés dans le lien d'attribution.
- La valeur 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 du lien d'attribution—UA et retargeting
Le tableau suivant peut être téléchargé en .csv
.
Paramètre | Nom d'affichage dans les données brutes | Description |
Type et longueur du champ |
---|---|---|---|
pid | Source média | Identifie de manière unique un partenaire intégré AppsFlyer. Ne le modifiez pas. Plus d'informations. |
Chaîne 150 |
c | Campagne | Fourni par l'annonceur ou l'éditeur. Voir les limites de caractères pour les noms de campagne. |
Chaîne 100 |
af_prt |
Partenaire |
|
Chaîne 50 |
af_mp |
S/O |
|
|
clickid |
S/O |
Identifiant de clic unique des ad networks |
|
af_siteid |
Site ID |
|
Chaîne 24 |
af_sub_siteid |
Identifiant du sous-site |
|
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'attribution ré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 où les publicités sont distribuées, exemple : UAC_Search, UAC_Display, Instagram, Meta 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 Caractéristiques et limitations. |
Chaîne 100 |
af_r | S/O |
Utilisé dans les liens vers plateforme unique pour rediriger les utilisateurs vers l'URL qui a été définie pour les deux plateformes (Android et iOS).
|
|
af_web_dp | S/O |
URL qui redirige les utilisateurs d'ordinateur de bureau (comme Windows ou Mac) vers une page web différente de celle configurée dans le template OneLink. Cette option permet de conserver les données d'attribution des utilisateurs d'ordinateur de bureau sur d'autres plateformes (ex : Google Analytics ou Omniture) Remarque : si vous disposez d'une liste des redirections autorisées active, vérifiez que le domaine de cette URL apparait bien dans la liste. |
|
af_dp | S/O | La valeur du schéma d'URI de secours qui lance 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 -. Elle ne doit indiquer que 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_base_params_forward | S/O |
|
|
af_partner_account_id | ID de compte réseau | ID du compte de l'annonceur auprès du partenaire | Chaîne 100 |
Rediriger | S/O | Avec &redirect=false , le paramètre permet à AppsFlyer de savoir qu'il s'agit d'un clic S2S et que le partenaire s'occupe de rediriger l'utilisateur qui a cliqué. |
|
af_ua | Agent utilisateur |
Concerne les réseaux publicitaires qui envoient les clics et les impressions de serveur à serveur. La chaîne de caractères de l'agent-utilisateur est la suivante :
L'agent-utilisateur doit être identique dans le paramètre de l'URL et l'en-tête HTTP. Note : dans Android, l'agent-utilisateur est parfois réduit à Client Hints. Il doit être envoyé même dans ce cas.
|
|
af_ip | IP |
Concerne les réseaux publicitaires qui envoient les clics et les impressions de serveur à serveur. Adresse IP de l'appareil Recommandé : si il est disponible, fournissez l'IP de l'appareil sous le paramètre af_ip. Option suivante : si disponible, AppsFlyer utilisera l'IP dans X-Forwarded-For. |
|
[Obsolète] af_os | Version OS |
[Pour iOS uniquement] La version du système d'exploitation de l'appareil Bien qu'il soit obsolète, ce paramètre est toujours pris en charge par AppsFlyer. Recommandé : utilisez le paramètre af_os_version à la place. |
|
af_os_version | Version OS |
|
|
af_model | Modèle d'appareil |
|
|
af_media_type | Type de média |
Positionnement de la publicité portant le lien comme suit :
|
|
deep_link_sub1-10 | S/O |
Valeurs supplémentaires du deep link. Les développeurs implémentent dans le code le comportement des valeurs souhaité. |
|
deep_link_value | S/O |
Nom du contenu in-app vers lequel les utilisateurs seront dirigés. Les développeurs implémentent dans le code le comportement souhaité de deep_link_value. |
|
af_og_title | S/O |
Lorsqu'un lien est publié sur les réseaux sociaux, le titre de l'open graph (OG) génère un aperçu de titre. |
Chaîne 40 |
af_og_description | S/O |
Lorsqu'un lien est publié sur les réseaux sociaux, la description de l'open graph (OG) génère un aperçu de description. |
Chaîne 300 |
af_og_image | S/O |
Lorsqu’un lien est publié sur les médias sociaux, l’image de l'open graph (OG) génère un aperçu d’image. |
Paramètres du lien d'attribution—retargeting uniquement
Paramètre | Nom d'affichage dans les données brutes | Description |
Type et longueur du 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 « false », 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 : |
S/O |
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.
Type de publicité (af_ad_type)
Paramètre | Format de la valeur | Description |
---|---|---|
af_video_total_length | secondes | Durée totale possible de la vidéo |
af_video_played_length | secondes | Durée de la vidéo ayant été vue |
af_playable_played_length | secondes | Durée de l'élément jouable ayant été joué une fois complètement chargé |
af_ad_time_viewed | secondes | 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 | secondes | Durée possible totale de l'audio |
af_audio_played_length | secondes | 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 autre de celle de la page de l'app sur Google Play. À utiliser pour les app stores tiers. Remarque : si vous disposez d'une liste des redirections autorisées active, vérifiez que le domaine de cette URL apparait bien dans la liste. |
|
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 |
|
af_android_store_csl |
store_product_page |
Liste personnalisée des stores dans Google Console |
chaîne |
Paramètres spécifiques à iOS
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 |
Redirection de la page d'accueil : permet de rediriger les utilisateurs iOS (iPhone ou iPad) vers une autre URL que celle de la page de l'app sur iTunes Remarque : si vous disposez d'une liste des redirections autorisées active, vérifiez que le domaine de cette URL apparait bien dans la liste. |
|
af_ios_store_cpp | store_product_page |
ID de page produit personnalisée (ppid) |
af_ios_fallback [obsolète] |
S/O |
Obsolète : les utilisateurs sont redirigés en fonction du flux du schéma d'URI iOS. |
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
https://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 définir des paramètres personnalisés en plus des paramètres par défaut spécifiques à Android et iOS. Ces paramètres spécifiques vous permettront de personnaliser le contenu de l'utilisateur et ce qu'il expérimente en fonction du lien d'attribution qui déclenche une installation.
Vous pouvez ajouter un paramètre personnalisé au lien d'attribution au format parameter=value
. Par exemple :
https://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.
Paramètre de l'ID de partenaire (PID)
Parmi tous les paramètres de lien d'attribution disponibles, le PID est obligatoire. Le PID est l'identifiant unique de la source média attribuée par AppsFlyer.
Chaque partenaire intégré a sa propre valeur de PID. Le PID se termine par le suffixe _int. Lorsque vous utilisez un lien OneLink, vous pouvez définir le PID sur la valeur de votre choix, tant qu'il n'est pas réservé à un partenaire intégré. Pour éviter tout conflit, n'utilisez pas le suffixe _int.
Quelques ID d'éditeurs intégrés parmi les plus importants : organic, googleadwords_int (Google AdWords), Meta ads, Twitter. Vous pouvez utiliser le nom que vous souhaitez pour les sources non intégrées, comme les e-mails, sms ou pigeons voyageurs.
Comment éviter les problèmes de PID les plus courants :
- Intégrez systématiquement le PID dans vos liens d'attribution. En l'absence de PID dans le lien d'attribution, l'utilisateur est automatiquement attribué à une source média « inexistante », et la source d'installation originale disparaît.
- Pour les sources personnalisées, utilisez les PID des partenaires non intégrés. Pour chaque source intégrée, utilisez uniquement le PID désigné pour obtenir la bonne attribution de ses installations. Pour toute source média personnalisée, comme les e-mails, les SMS, voire les posts viraux non payés sur Facebook, utilisez des valeurs de PID non intégrés différentes.
-
N'utilisez que les caractères autorisés. Si le paramètre PID du lien d'attribution contient l'un des caractères suivants /<>*&?\
- Le clic ou l'installation s'affichera dans le tableau de bord comme af_invalid_param
- Les liens d'attribution ne seront pas attribués
- Le deep linking ne fonctionnera pas après les clics
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.
Paramètre de l'ID de site
L'identifiant du site est l'identifiant unique de l'éditeur diffusant la publicité. En d'autres termes, le site web ou l'app qui affiche la publicité. Les réseaux publicitaires attribuent des identifiants de site uniques à chaque éditeur.
Cet identifiant est inclus dans le paramètre af_siteid
transmis à AppsFlyer dans le lien d'attribution. Il est rendu disponible via les tableaux de bord, options de rapport et postbacks d'AppsFlyer.
L'ID de site doit être transmis à AppsFlyer via le lien d'attribution pour les raisons suivantes :
- Il fournit clarté et transparence sur l'éditeur.
- Il est utilisé par AppsFlyer pour identifier et éliminer les éditeurs frauduleux, ou tout autre cluster de trafic.
Le paramètre d'ID de site contient uniquement l'ID de l'éditeur qui diffuse la publicité.
Pour inclure des informations supplémentaires, telles que le type de publicité, le placement ou les deux au sein de l'app, par exemple la bannière, l'intersection ou la vidéo, utilisez le paramètre ID de sous-site.
Exemple
Le lien d'attribution suivant comprend :
-
af_siteid
(ID de site) : ID de l'éditeur -
af_sub_siteid
(ID de sous-site) : infos d'identification additionnelles (dans le cas présent, une source affiliée et un emplacement de type de publicité)
https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid=1234&af_sub_siteid=ABCD_4567
Dans l'exemple de lien :
- 1234 = ID d'éditeur
- ABCD = source affiliée (sous-éditeur) avec laquelle l'éditeur collabore
- 4567 = emplacement dans l'app du type de publicité, comme une bannière, un interstitiel ou une vidéo
FAQ : pourquoi le trafic génère-t-il autant d'installations bloquées ?
Les installations peuvent être bloquées pour les motifs suivants :
-
ID de site manquant : le paramètre
af_siteid
est vide dans l'URL de clic. Les engagements qui sont envoyés avec un ID de site manquant indiquent soit un problème technique, soit une tentative de contournement des systèmes de détection des fraudes. - Plusieurs ID de site : le même éditeur est envoyé sur plusieurs URL de clics, à l'aide de différents ID de site. Ceci est vu comme un acte frauduleux visant à dissimuler l'activité réelle de l'éditeur, il est souvent associé à un click flooding.
- ID de site mal formaté : l'envoi d'un format incorrect, associé à d'autres signes de fraude, peut entraîner le blocage non seulement de l'éditeur en question, mais aussi d'un cluster de niveau plus élevé, ce qui peut se répercuter de manière très forte sur l'activité du partenaire.
Pour éviter les blocages d'installations, veillez à n'envoyer qu'un seul paramètre d'ID de site par éditeur, comme indiqué dans notre exemple.
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
- Évaluez et comparez les performances de toutes vos publicités par ad set, campagne et source média au sein de rapports agrégés, et optimisez l'ensemble des niveaux
- 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.
https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere
Particularités et limites
Particularité | Remarques |
---|---|
Caractères spéciaux |
Les caractères spéciaux qui suivent ne sont pas autorisés dans le paramètre ou les valeurs : ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, } et % |
Nbre maxi de caractères dans l'URL |
La longueur totale de l'URL ne doit pas dépasser 2 000 caractères |
Apps sociales Android WebView redirection du deep linking |
Voir les détails de la limitation ici |
Dois-je utiliser des lettres majuscules ou minuscules pour les paramètres ?
Vous pouvez choisir d'utiliser l'un ou l'autre, mais ne changez pas d'avis en cours de procédure. Si vous définissez un paramètre personnalisé avec des caractères majuscules ou minuscules, veillez à toujours utiliser ce paramètre.
Par exemple, si vous paramétrez pid=MyMediaSource, vous devrez l'utiliser à chaque fois. Si vous utilisez pid=MyMediaSource sur un lien d'attribution et pid=mymediasource sur un autre, les données seront inconsistantes. Cela est valable pour chacun des paramètres que vous définissez sur le lien d'attribution.
Le lien d'attribution Appsflyer est-il dynamique ou statique ?
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 courtes (ex :
yourbrand.onelink.me/HaT8/r5c2b371
) utilisées pour les liens d'attribution personnalisés, sont dynamiques.Par conséquent, lorsque vous commencez à utiliser un lien d'attribution pour un partenaire intégré (ou une URL longue pour un média propre) ce lien reste inchangé quel que soit le prospect qui interagit avec lui, et ce même si vous modifiez les valeurs du lien d'attribution dans le tableau de bord AppsFlyer. Si vous souhaitez faire une modification, vous devrez ainsi utiliser la nouvelle URL longue.
De plus, les URL courtes des médias propres ne contiennent pas directement de paramètres. Lorsqu'un prospect interagit avec une URL courte 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 app de transport à la demande, Luber, a prévu des créatifs avec 3 modèles de couleur : bleu, jaune et rouge. Linda, marketeuse mobile, veut tester les modèles pour voir quelle couleur génère le plus d'installations. Pour cela, elle ajoute &af_sub3=blue
aux liens d'attribution de toutes les publicités bleues pour 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.
Quel est le nombre de caractères autorisé pour les noms de campagne ?
- La longueur maximale du nom d'une campagne dans l'URL du lien d'attribution est de 100 caractères. En cas de dépassement, le nom de la campagne est modifié et devient :
c_name_exceeded_max_length
- Le nom de la campagne ne doit pas commencer ou se terminer par un espace vide car cela peut entraîner des divergences dans les tableaux de bord et les rapports