Dictionnaire des champs de données brutes (spécifiques à la version V5.0)

En quelques mots : le dictionnaire de champs de données (spécifiques aux données brutes) contient les champs trouvés dans les rapports de données brutes.

Champs de date dans les fichiers CSV : les champs de date dans les fichiers CSV sont au format aaaa-mm-jj. Lorsque vous ouvrez un fichier CSV dans Excel, les champs de date sont formatés en fonction des paramètres de date et d'heure de votre ordinateur. Assurez-vous de sélectionner le format de date approprié dans Excel

À propos du dictionnaire des données

Les colonnes du dictionnaire sont les suivantes :

  • Nom de l'API : nom utilisé par l'API Push et Data Locker
  • Nom d'affichage : nom du champ utilisé dans les rapports, comme CSV, Pull API,
  • Source : l'emplacement de la source d'origine du contenu du champ, comme suit :
  • Description
    • Certains champs ont des significations différentes en fonction du contexte de l'événement. La signification résulte d'une UA ou d'une campagne de retargeting.
  • Contexte : lorsqu'un champ est disponible dans des rapports spécifiques, ou possède une signification légèrement différente selon le contexte du rapport, cela vous sera spécifié comme suit :
    • Retargeting : ces champs ont une signification spécifique dans le cadre d'une campagne de retargeting.
    • Data Locker : disponible uniquement dans Data Locker.
    • Protect360 : disponible uniquement dans les rapports Protect360
    • Champs ajoutés après décembre 2019, date d'ajout du champ
  • Type et longueur du champ :
    • Chaîne : la longueur maximale de la chaîne. En général nous ne limitons pas la longueur des champs à réception des données, mais les données peuvent être tronquées par la suite. Veuillez ne pas dépasser la longueur de champ spécifiée.
    • Date Heure :
      • Chaîne au format, aaaa-mm-jj hh:mm:ss. Exemple : 2019-09-17 00:09:25 Le fuseau horaire utilisé pour afficher les données dépend de l'outil qui transporte des données, voir ci-dessous :
        • Page des données d'exportation : fuseau horaire sélectionné par l'app.
        • API Push : les champs horaires proposent l'option selected_time_zone qui induit un fuseau horaire spécifique à l'app et qui n'est pas en UTC.
        • API Mater : la valeur par défaut est le fuseau horaire sélectionnable par l'app.
        • Data Locker : UTC
      • Remarque : en ouvrant les fichiers CSV avec Excel, le champ s'affiche en utilisant les paramètres régionaux par défaut. Vous pouvez modifier le format d'affichage dans Excel. Pour voir la valeur non formatée, ouvrez le fichier avec un éditeur.
      • API push :
        • Pour les champs horodateur en UTC : format aaaa-mm-jj hh:mm:ss.sss.Exemple : 2019-09-17 00:09:25.123 
        • Pour les champs horodateur dans le fuseau horaire sélectionné : format aaaa-mm-jj hh:mm:ss.sss±th:tm. Exemple : 2019-01-20 04:51:16.000+0000
    • Enum n char : les champs Enum ne peuvent contenir que des valeurs spécifiques. Par exemple, la devise Coût a 3 caractères et peut contenir que les codes de devise spécifiés
    • Enum 5 char boolean : la valeur du champ peut être TRUE ou FALSE
    • Exemple d'enregistrement d'installation au format csv

Champs de données brutes

Nom du paramètre API

Nom du champ

Source

Description


Contexte

Type de champ

af_ad

Publicité

Lien

   

Chaîne 100

af_ad_id

Identifiant de publicité

Lien

   

Chaîne 24

af_ad_type

Type de publicité

Lien

Type de publicité (bannière, pied de page, etc.)

 

Chaîne 24

af_adset

Ensemble de publicités

Lien

   

Chaîne 100

af_adset_id

Identifiant de l'ensemble de publicités

Lien

 

 

Chaîne 24

af_c_id

Identifiant de la campagne

Lien

    Chaîne 24

af_channel

Canal

Lien

Canal de la source média, par exemple YouTube pour Google, Instagram pour Facebook   Chaîne Enum dynamique 20

af_cost_
devise*

Devise des coûts

Lien

Devise des coûts (liste)   Enum 3 car

af_cost_model

Modèle de coût

Lien

CPC/CPI/CPM/Autre. Tous les coûts sont actuellement calculés selon l'IPC, quelle que soit cette valeur

 

Chaîne 20

af_cost_value

Valeur des coûts

Lien

Coût dans la devise d'origine. Prend en charge jusqu'à 4 chiffres après la virgule. Exemple : 320,5095   Chaîne 20

af_keywords

Mots-clés

Lien

Reçu de l'ad network

 

Chaîne 100

af_attribution_
lookback

Attribution rétrospective Lien

UA : fenêtre rétrospective pour l'attribution de clic. La durée de la fenêtre est le CTIT maximal (Click Time to Install) pour que le nouvel utilisateur soit attribué à la source affichant la publicité/le lien. Remarque : le paramètre équivalent dans le lien d'attribution est af_click_lookback.

Retargeting : fenêtre rétrospective post-clic de retargeting.

 Retargeting

 

 

3 car. max.

af_prt

Partenaire

Lien

Agence ou PMD

 

Chaîne 50

af_reengagement
_window

Fenêtre de réengagement

Lien

La fenêtre d'attribution de réengagement correspond à la même période durant laquelle un évènement peut être attribué à une campagne de retargeting.

Limitation : le champ n'est pas rempli dans les campagnes de retargeting.

Retargeting 3 car. max.

af_siteid

ID site

Lien

ID éditeur   Chaîne 24

af_sub_siteid

Identifiant du sous-site

Lien

ID sous-éditeur

 

Chaîne 50

af_sub1

Sous-paramètre 1

Lien

Paramètre personnalisé facultatif défini par l'annonceur   Chaîne 100

af_sub2

Sous-paramètre 2

Lien

Paramètre personnalisé facultatif défini par l'annonceur   Chaîne 100

af_sub3

Sous-paramètre 3

Lien

Paramètre personnalisé facultatif défini par l'annonceur   Chaîne 100

af_sub4

Sous-paramètre 4

Lien

Paramètre personnalisé facultatif défini par l'annonceur   Chaîne 100

af_sub5

Sous-paramètre 5

Lien

Paramètre personnalisé facultatif défini par l'annonceur   Chaîne 100

campagne

Campagne

Lien

Nom de la campagne

 

Chaîne 100

is_retargeting

Retargeting en cours

Lien

UA : FALSE

Retargeting  : TRUE pour les conversions et les événements de retargeting

Retargeting

Enum 5 car boolean

media_source

Source média

Lien

La source média attribuée à un événement ou soumise à restriction

 

Chaîne 50

original_url

URL d'origine

Lien

UA : l'URL de clic / d'impression utilisée

Si le lien est un lien de marque : le champ est complété avec le lien de marque.

Retargeting : contient l'un des éléments suivants : lien de retargeting, données de deep linking, ou est laissé vide pour les SRN.

Retargeting Chaîne 2083 (URL)

user_agent

Agent utilisateur

Lien

L'agent utilisateur de l'URL   Chaîne 200

advertising_id

ID publicitaire

SDK

L'ID publicitaire est un ID réinitialisable par l'utilisateur, unique et anonyme, utilisable à des fins publicitaires et fourni par les services Google Play (GAID).   Chaîne 40

android_id

ID Android 

SDK

ID d'appareil Android    Chaîne 20
app_id ID d'app

SDK

ID d'app :
  • iOS : id123456789
  • Android : com.appsflyer.referrersender
 

iOS : chaîne 12

Android : chaîne 100

app_name

Nom de l'app

SDK

Nom de l'app   Chaîne 100

app_version

Version de l'app

SDK

Version de l'app   8 car. max.

appsflyer_id

ID AppsFlyer

SDK

UA : identifiant d'installation unique. (EN: AppsFlyer ID or appsflyer_id) Un ID unique généré par AppsFlyer lorsque l'application se lance pour la première fois. L'ID est unique pour chaque app et installation. Cela signifie qu'un nouvel ID est attribué si l'app est supprimée puis réinstallée. Voir également la section ID Utilisateur-Client.

Retargeting : 
réattribution : un nouvel ID est attribué, réengagement : l'ID reste le même 

Retargeting

iOS : chaîne 24

Android : chaîne 33

bundle_id

ID de groupe

SDK

Identifiant correspondant à une seule app ou un groupe d'apps (pour iOS)   Chaîne 100

carrier

carrier

SDK

Le nom de l'opérateur fourni par Android à l'aide de getSimCarrierIdName(). Voir également mappage d'opérateur.

  Chaîne 50

country_code

Code pays

SDK

Code pays utilisant ISO 3166 (alpha-2) Exemple : US, CN.

Le code implémenté pour le Royaume-Uni est UK et non pas GB. 

  Enum chaîne 2

custom_data

Données personnalisées

SDK

  • Données envoyées à l'aide du SDK
  • Voir Android et iOS
  Chaîne 1024

customer_user_id

ID utilisateur du client

SDK

Un identifiant unique, défini par le propriétaire de l'app.    Chaîne 100
deeplink_url

URL de deep link

SDK

Le chemin vers une activité interne à l'app à laquelle les utilisateurs sont deep linkés. Vous pouvez l'utiliser pour le deep linking et le deep link différé.

Disponible depuis janvier 2020

Chaîne 1024

device_category

Catégorie d'appareil

SDK

  • Les valeurs possibles comprennent : téléphone, tablette, autre
  • Compatible avec le SDK Android v4.8.8 et versions ultérieures
  Chaîne 20

device_type

Type d'appareil

SDK

Le nom de modèle commercial de l'appareil.Exemple : SM-GM284 ou iPhone7

 

Chaîne 100

device_download_
time

Temps de téléchargement de l'appareil

SDK

Heure de fin du téléchargement de l'app basée sur l'horloge de l'appareil (Android, IOS) convertie au format UTC. La valeur s'affiche systématiquement en heure UTC.

Format : aaaa-mm-jj hh:mm:ss.sss

Disponible dans Data Locker depuis octobre 2019. Disponibilité globale depuis janvier 2020. -

event_name

Nom de l'événement

SDK

Le nom de l'évènement survenu   Chaîne 100

event_revenue

Revenu de l'évènement

SDK

Montant des revenus selon la devise des revenus d'événements.   Chaîne 20

event_revenue_

devise*

Devise du revenu des évènements

SDK

La devise du revenu des évènements retournée par le SDK.   Chaîne 20

event_time

Heure de l'évènement

SDK

UA : l'heure où l'évènement est survenu

Retargeting : même heure que celle de l'installation

Retargeting Date Heure

event_value

Valeur de l'événement

SDK

La valeur de l'évènement

Remarque : veillez à ne pas envoyer pas plus de 1000 caractères depuis le SDK car en fonction du type de rapport, nous risquons de les tronquer.

  Chaîne 1000

idfa

idfa

SDK

iOS : ID de l'annonceur   40 caractères max.

idfv

IDFV

SDK

Identifiant du niveau de l'app d'un fournisseur donné   40 caractères max.

imei

imei

SDK

IMEI de l'appareil pour Android et iOS   14 caractères max.

install_app_store

App store d'installation

Lien

Identifie la boutique Android depuis laquelle l'app a été téléchargée (détails)   Chaîne 50

install_time

Temps d'installation

SDK

UA : heure du premier lancement de l'app suite à l’installation.

Retargeting : le premier lancement de l'app après le réengagement ou la réattribution.

Retargeting

Date Heure

ip

IP

SDK

Adresses IP   Chaîne 15 pour IP V4

is_lat

Is LAT

SDK

Limite du suivi des publicités (LAT) : lorsque la valeur est true, l'utilisateur a activé la LAT sur son appareil et aucun ID d'annonceur n'est disponible pour AppsFlyer.  À compter de janvier 2020 Enum 5 car boolean

langue

langue

SDK

Langue de l'appareil   Chaîne 20

oaid

OAID

SDK

Android : ID annonceur disponible sur certains appareils en remplacement ou en supplément de l'ID Android. À compter de janvier 2020 40 caractères max.

operator

operator

SDK

Le nom de l'opérateur mobile dérivé de la carte SIM MCCMNC, disponible si l'utilisateur s'est enregistré sur le réseau à l'aide d'Android getNetworkOperatorName   Chaîne 50

os_version

Version du système d'exploitation

SDK

La version du système d'exploitation   Chaîne 8

platform

Plate-forme

SDK

Valeurs possibles : iOS, Android ou Windows Mobile

 

Enum chaîne 8

sdk_version

Version du SDK

SDK

Version du SDK   Chaîne 8

wifi

wifi

SDK

vrai / faux

 

Enum 5 car boolean

store_reinstall

Réinstallation de l'Apple store

SDK

Pour le trafic généré par Apple Search Ads, l'utilisation de l'ID utilisateur Apple permet de savoir s'il s'agit d'un :

  • False : nouvel utilisateur
  • True : réinstallation par un utilisateur existant
À compter de janvier 2020 Enum 5 car boolean

amazon_aid

ID Amazon Fire

SDK

ID publicitaire Amazon

  Chaîne 100

city

city

AF

La localisation de l'utilisateur la plus précise basée sur l'adresse IP de son appareil. La valeur comprend normalement un nom de ville, mais parfois également le quartier pour une meilleure précision.

 

Chaîne 100

attributed_touch_

time

Temps de touch attribué

AF

UA : heure du touch que nous avons attribué.

Retargeting : heure d'engagement du retargeting

Retargeting

Date Heure

attributed_touch_

Type

Type de touch attribué

AF

UA : le type de touch attribué par AppsFlyer. Valeurs possibles : clic/impression/TV/préinstallé

Ré-engagement : clic ou impression (réattributions uniquement)

Retargeting

Enum 10 car max

contributor_1_

af_prt

Partenaire du contributeur 1

AF

Agence ou PMD -
toujours converti(e) en minuscules

 

Chaîne 50

contributor_1_

campagne

Campagne du contributeur 1

AF

Campagne du contributeur   Chaîne 100

contributor_1_

match_type

Type de correspondance du contributeur 1

AF

Les valeurs possibles comprennent :

gp_referrer, id_matching, srn

  Chaîne 50

contributor_1_

media_source

Source média du contributeur 1

AF

Source média du contributeur   Chaîne 50

contributor_1_

touch_time

Heure de touch du contributeur 1

AF

L'heure du touch

 

Date Heure

contributor_1_

touch_type

Type de touch du contributeur 1

AF

Le type de touch

click, impression, TV

 

Enum 10 car max

contributor_2_af_
prt

Partenaire du contributeur 2

AF

Agence ou PMD   Chaîne 50

contributor_2_

campagne

Campagne du contributeur 2

AF

Campagne du contributeur   Chaîne 100

contributor_2_

match_type

Type de correspondance du contributeur 2

AF

Les valeurs possibles comprennent :

gp_referrer/id_matching/srn

  Chaîne 50

contributor_2_

media_source

Source média du contributeur 2

AF

Source média du contributeur   Chaîne 50

contributor_2_

touch_time

Heure de touch du contributeur 2

AF

L'heure du touch   Date Heure

contributor_2_

touch_type

Type de touch du contributeur 2

AF

Le type de touch

(clic/impression/TV)

 

Enum 10 car max

contributor_3_af_
prt

Partenaire du contributeur 3

AF

Agence ou PMD   Chaîne 50

contributor_3_

campagne

Campagne du contributeur 3

AF

Campagne du contributeur   Chaîne 100

contributor_3_

match_type

Type de correspondance du contributeur 3

AF

Les valeurs possibles comprennent :

gp_referrer/id_matching/srn

  Chaîne 50

contributor_3_

media_source

Source média du contributeur 3

AF

Source média du contributeur   Chaîne 50

contributor_3_

touch_time

Heure de touch du contributeur 3

AF

L'heure du touch   Date Heure

contributor_3_

touch_type

Type de touch du contributeur 3

AF

Le type de touch

(clic/impression/TV)

 

Enum 10 car max

dma

DMA

AF

Région de marché désignée : les régions sont les zones géographiques des États-Unis où l'audience de la télévision locale est mesurée par la société Nielsen.   Chaîne 10

event_revenue_usd

event_revenue_
selected_currency

 

Revenu de l'évènement en USD

Revenu de l'événement préféré

Revenu de l'évènement XXX

AF

Le montant du revenu. La devise dépendra de l'outil de reporting utilisé.

Préféré ou sélectionné induit la devise spécifique à l'app qui a été définie dans ses paramètres.

Data Locker : USD

Page d'exportation : devise sélectionnée

API Pull sélectionnable : soit USD soit sélectionné à l'aide de &currency=preferred.

API Push : contient toujours les deux champs, USD et devise sélectionnée

 

  Chaîne 20

event_source

Source de l'évènement

AF

La source de l'évènement (SDK ou S2S)   Enum 3 car max

http_referrer

Référent HTTP

AF

Identifie l'adresse de la page Web dont le lien renvoie à l'URL de clic AppsFlyer. Vérifiez le référent pour savoir d'où provient la requête   Chaîne 2083 car max

is_primary_
attribution

Est une attribution principale

AF

UA : true

Retargeting : au cours d'une fenêtre de réengagement, nous attribuons à la fois la source média d'origine (qui précède le réengagement) et la source média de réengagement. Tandis que l'événement se trouve dans la fenêtre de réengagement. La source média d'origine sera FALSE (pas d'attribution principale). La source média de réengagement sera TRUE.

Retargeting

Enum 5 car max

is_receipt_
validated

Possède une validation de reçu

AF

true/false/null lors d'un déploiement dans le SDK, sinon vide

 

Enum 5 car max

match_type

Type de correspondance

AF

Type de méthode d'attribution. Les valeurs possibles comprennent :

gp_referrer (chaîne de référent Google Play)

id_matching

Fingerprinting

srn (Self-Reporting Network - réseaux auto-reporting)

tv (attribution TV)

préinstallation

  Chaîne 50

postal_code

Code postal

AF

Basé sur l'adresse IP du SDK   Chaîne - 10 caractères max.

Région

Région

AF

Basé sur l'adresse IP à partir du SDK

 

Chaîne 100

retargeting_

conversion_type

Type de conversion de retargeting

AF

UA : N/A

Re-targeting : ré-engagement, réattribution

Retargeting

 

Enum 14 car max

state

État

AF

Basé sur l'adresse IP à partir du SDK

 

Chaîne 100

keyword_id

ID de mot clé

Lien

ID de mot clé renvoyé par l'ad network Il s'agit de l'ID du af_keyword.   Chaîne 100

keyword_match_
type

Type de correspondance de mots-clés

AF

Les types de correspondance de mot-clé retournés par les API ou les liens d'attribution des réseaux doivent être mappés au rapport brut.

Remarque : Google Adwords et Apple Search Ads sont les seuls réseaux qui retournent ce paramètre pour les campagnes de recherche.

  Chaîne 100

network_
account_id

ID de compte réseau

AF

ID du compte de l'annonceur auprès du partenaire

 

Chaîne 100

rejected_reason_

valeur

Motif du rejet (valeur)

AF

Dans les rapports derègles de validation de ciblage : ID d'ensemble de règles à l'origine du rejet

Validation de ciblage

Chaîne 100

rejected_reason Motif rejeté AF Dans les rapports de règles de validation de ciblage : le type de règle qui a provoqué le rejet. Exemple : install-validation-rule Validation de ciblage Chaîne 100
blocked_reason Motif bloqué AF Dans Protect360, la raison pour laquelle l'installation est bloquée. Exemple : install_hijacking, bots  Protect360  Chaîne 100
blocked_sub_
reason
Sous-motif bloqué AF

Dans Protect 360, sous-motif particulier d'une installation bloquée. Exemple : motif : install_hijacking. Sous-motif : referer hijack, CTCT_anomalies

Protect360  Chaîne 100

blocked_reason_

valeur

Valeur du motif bloqué AF Informations supplémentaires concernant le blocage. Exemple : ID de site. Protect360  Chaîne 100

blocked_reason_

rule

Règle du motif bloqué AF Ce champ sera rendu obsolète. En attendant la valeur sera toujours null.   Protect360  À rendre obsolète

gp_click_time

Heure du clic Google Play

Champ Google Play

Heure du chargement de la page d'app sur Google Play après avoir cliqué sur la publicité.

Source de l'heure : API Google

Disponible sur le SDK Android à partir de la version 4.8.5

Exemple de cas d'utilisation : en comparant la durée install_time to gp_click, vous pouvez savoir combien de temps cela prend aux utilisateurs du début du téléchargement de l'application à son ouverture. 

  Horodatage

gp_install_begin

Heure de début d'installation Google Play

Champ Google Play

Heure de début de l'installation 
Source de l'heure : appareil de l'utilisateur. L'heure qui s'affiche sur l'appareil.

Remarque :

Disponible sur le SDK Android à partir de la version 4.8.5

  Horodatage

gp_referrer

Google Play Referrer

Champ Google Play

L'URL du référent du package installé.

Disponible sur le SDK Android à partir de la version 4.8.5

  Chaîne 1024

gp_broadcast_
referrer

Référent de diffusion GP

Champ Google Play

Référent de diffusion Google Play

  Chaîne 1024

ad_unit

Unité publicitaire

API de revenu publicitaire

Type de publicité

Revenus publicitaires Chaîne 1024

segment

Segment

API de revenu publicitaire

Nom d'emplacement de la publicité Revenus publicitaires Chaîne 1024

monetization_network

Réseau de monétisation

API de revenu publicitaire

Réseau qui envoie la publicité

Revenus publicitaires Chaîne 1024

Impressions

Impressions

API de revenu publicitaire

Nombre de fois où l'utilisateur a vu la publicité

Revenus publicitaires Chaîne 1024

mediation_network

Réseau de médiation

API de revenu publicitaire

Réseau de médiation qui signale l'événement à AppsFlyer

Revenus publicitaires Chaîne 1024

Exemple d'enregistrement des données brutes d'un événement in-app

Sample_v5_in_app_event.csv

Exemple d'enregistrement des données brutes d'un événement in-app
Nom du champ valeur
wifi true
Publicité 101548
Ensemble de publicités 18212447
ID publicitaire 452c96af-7dc8-4d4c-9579-example
ID d'app abc.example
Nom de l'app Exemple : #1 app d'achat en ligne et offres
Version de l'app 4.0.11
ID AppsFlyer 1570515992667-612279933540example
Temps de touch attribué 2019-10-08 10:21.31
Type de touch attribué Clic
Attribution rétrospective 7j
ID de groupe abc.example
Campagne abc_ad_network_9999999
carrier example-carrier
city Johannesburg
Modèle de coût CPI
Valeur des coûts 1900-01-00 07:12.00
Code pays ZA
ID utilisateur du client abc123xyz
Catégorie d'appareil téléphone
Temps de téléchargement de l'appareil 2019-10-07 19:52.23
Type d'appareil vivo-vivo 1727
DMA Aucun
Nom de l'événement af_purchase
Revenu de l'évènement 100
Devise du revenu des évènements ZAR
Revenu de l'évènement en USD 13
Source de l'évènement SDK
Heure de l'évènement 2020-02-23 20:40.17
Valeur de l'événement {"af_content":"[{\"id\":\"99988089\",\"item_price\":100,\"quantity\":2}]",
"af_price":[100],"appsflyer_device_id":"99999992667-279933540example",
"af_order_id":"99998496842","af_receipt_id":"99998496842"
,"af_content_id":"99998089"],"af_content_type":"product",
"af_currency":"ZAR","af_revenue":100"af_description":["00008"],"af_quantity":[1],"af_param_1":"999963"}
Champ valeur
Temps d'installation 2019-10-08 13:26.41
IP 192.0.2.1.1
Est une attribution principale FALSE
Retargeting en cours FALSE
langue English
Type de correspondance id_matching
Source média abc_ad_network_int
operator example-carrier
Version du système d'exploitation 9
Plate-forme Android
Code postal 8100
Région AF 
Version du SDK v5.1.1
ID site abc.example_1099548_35281
État GAU
Sous-paramètre 1 99999
Identifiant du sous-site 99999
Agent utilisateur Dalvik/2.1.0 (Linux; U; Android 9; vivo 1727 Build/PKQ1.190118.001)
Cet article vous a-t-il été utile ?

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.