Structure et paramètres des liens d'attribution

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 pour télécharger l'application. Des paramètres supplémentaires peuvent être ajoutés au lien après le caractère ? pour enregistrer des informations supplémentaires.

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

Le lien d'attribution suivant pour l'application com.greatapp utilise plusieurs paramètres, notamment l'ID éditeur (pid), le nom de la campagne (c), et l'ID d'ad set (af_adset_id). Consultez le tableau ci-dessous pour voir la liste complète des paramètres des liens d'attribution pris en charge et leur explication.
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 Raw-data field Name Description

Type de champ

pid Source média Fourni par AppsFlyer pour les partenaires intégrés. Ne doit pas être modifié. 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

  • Le nom de compte de l'agence permet d'attribuer les installations à l'agence
  • Remarque : n'utilisez pas ce paramètre avant de vous assurer que lesautorisations d'agence sont activées

Chaîne 50

af_mp

Partenaire marketing

  • Active l'envoi de postbacks aux partenaires marketing des éditeurs pour chaque installation.
  • Remarque : actuellement, ce paramètre ne sert qu'aux partenaires marketing de Pinterest.

 

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

  • Fourni par l'annonceur/l'éditeur
  • Adset représente un niveau intermédiaire dans la hiérarchie entre campagne et publicité. En savoir plus

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é

Le type de publicité suit la convention de dénomination suivante :

  • text :unbloc d'annonces contenant uniquement 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, c'est-à-dire non-rewarded
  • 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

Chaîne 24

af_click_lookback

Fenêtre rétrospective pour l'attribution de clics.  La durée de cette fenêtre est le CTIT (Click Time to Install) pour que le nouvel utilisateur soit attribué à la source affichant la publicité/le lien.

  • Nombre de jours configurable pour la période d'attribution rétrospective de clics. Valeurs de paramètres disponibles : 1j - 30j (jours) OU 1h - 23h (heures). La valeur par défaut est 7j. 
  • La fenêtre d'attribution peut être personnalisée pour les OneLinks et les SRN.

Remarque : n'affecte que les URL des clics, pas les URL d'impression.

3 car. max.

af_viewthrough_lookback

Fenêtre rétrospective pour l'attribution post vue

  • Nombre configurable de jours pour la période d'attribution post vue rétrospective.  Valeurs de paramètre disponibles : 1h. - 48h. (heures) OU 1j. - 7j. (jour). La valeur par défaut est 1j. 
  • La fenêtre d'attribution peut être personnalisée pour les SRN.

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

  • Le modèle de coût, CPI (par défaut) est actuellement le seul modèle pris en charge pour le signalement du coût par clic, qui renseigne la valeur du coût dans les rapports de données agrégées d'AppsFlyer .
  • Dans la mesure du possible, indiquez le coût par API. Dans les cas où le coût est signalé à la fois dans le lien et par API, c'est l'API qui a la priorité.  

Chaîne 20

af_cost_currency

Devise des coûts

  • Code de devise à 3 lettres conforme à la norme ISO-4217. Par exemple, USD, ZAR, EUR
  • [Par défaut] : USD

Enum 3 car 

af_cost_value

Valeur des coûts

  • Valeur de coût en utilisant la devise de coût.
  • Jusqu'à 4 chiffres après la virgule.
  • Utilisez UNIQUEMENT des chiffres (utilisez un point en guise de virgule si nécessaire) ex. «56» ou «2.85»

Chaîne 20

af_sub[n] 

(n=1-5) exemple : af_sub1

Sub Param [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 Redirige les utilisateurs vers l'URL indiquée pour les deux plates-formes (Android et iOS)  
af_web_dp S/O URL qui redirige les utilisateurs d'ordinateur portable 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 portable 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 vrai/faux
Campagnes avec incitations ou sans incitations
 
af_param_forwarding Lorsque la valeur est définie sur false, les paramètres du lien d'attribution ne sont pas transférés à la page redirigée.
Utilisez ce paramètre pour obtenir une URL plus claire dans la page redirigée, ou si les paramètres du lien d'attribution entraînent des problèmes en raison de la gestion des paramètres de requête sur la page redirigée
 
Paramètres du lien d'attributionUA et retargeting
Paramètres Nom d'affichage Description

Type de champ

is_retargeting

S'agit-il d'une campagne de retargeting ? 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 :

  • Jours : 1-90  ou heures 1-36
  • Durée de vie : cela signifie que la fenêtre de réengagement est illimitée. Exemple : &af_reengagement_window=lifetime

Valeur par défaut : 30 jours

Exemple : &af_reengagement_window=60d définit la fenêtre de réengagement à 60 jours.

3 car. max.

Paramètres du lien d'attribution—retargeting uniquement

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 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é Fire d'Amazon

 


Paramètres iOS spécifiques

Paramètres Nom d'affichage Description

Type de champ

idfa

IDFA

Identifiant d'annonceur Apple - doit être fourni en utilisant un format en majuscules. Doit être pris en charge par le réseau publicitaire

40 caractères max.

af_ios_url

Redirige les utilisateurs iOS vers une URL différente de la page des applications sur iTunes

Utilisez pour les redirections sur la page d'accueil

 

af_ios_fallback

S/O

Fournit une URL de secours pour les utilisateurs d'iOS 10.3 

 

sha1_idfa

S/O

Identifiant d'annonceur Apple haché avec SHA1. Doit être pris en charge par le réseau publicitaire

 

mac

S/O

Adresse mac des appareils. Doit être pris en charge par le réseau publicitaire

 

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 :

Why is PID (publisher ID) the Most Important Parameter?

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.

PID, Publisher ID, is actually the media source name. This is the primary field for attributing the install to its source.

Chaque partenaire intégré à AppsFlyer possède son propre PID unique, 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.

Here are some examples of important integrated publisher IDs: organic, googleadwords_int (Google AdWords), Facebook ads, Twitter. You can use any name for non-integrated sources like email, sms or mail pigeons.

Évitez ces problèmes fréquents avec les PID

Pensez aux règles suivantes pour les PID quand vous utilisez ce paramètre :

1. Intégrez toujours le PID dans vos liens d'attribution

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.

2. For Custom Sources Use non-integrated partner PIDs
Pour chaque source intégrée, utilisez uniquement le PID désigné pour une attribution correcte de ses installations.  Pour toute source média personnalisée, comme les e-mails, les SMS, ou même les publication virales non payées sur Facebook, utilisez d'autres valeurs de PID non intégrés.
 
3. N'utilisez que des caractères autorisés
Si le paramètre du PID dans le lien d'attribution contient l'un des caractères suivants « :<>*&?/ » - le clic/l'installation apparaît dans le tableau de bord sous invalid_media_source_name.

 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 :

  1. Source média (pid=)
  2. nom de campagne (c=) 
  3. Ensemble de publicités (af_adset=)
  4. 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 ?

You can use either but you must be consistent. If you set a custom parameter with upper or lower case characters, make sure to always use that parameter.

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 ?

Les liens d'attribution d'AppsFlyer ne sont pas des trackers et peuvent être 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 :

TL_error_message.png

C'est parce que le lien d'attribution comprend un caractère #. Par exemple :
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 ?

Les paramètres de souscripteur, c-à-d. af_sub1 à af_sub5 peuvent être utilisés pour enregistrer tout KPI utile. Ces paramètres sont analysés et apparaissent dans le rapport des données brutes, ce qui les rend très utiles pour l'agrégation ou le filtre des données.

 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 ?

AppsFlyer limite la longueur du nom de campagne dans l'URL du lien d'attribution à 100 caractères. Si la limite des caractères est dépassée, le nom de campagne est remplacé par : 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.

Cet article vous a-t-il été utile ?