Données brutes d'API Pull

Premium
Recommandé pour
Marketeurs
Dernière mise à jour :

En bref : utilisez cette API pour obtenir des rapports de données brutes en fichiers CSV.

PullAPIRaw_us-en.png

Données brutes d'API Pull

  • L'API Pull permet d'obtenir les rapports de données brutes en fichier de format CSV. En savoir plus sur les rapports de données brutes
  • Filtrer par options disponibles  : source média, plage de dates, nom de l'événement in-app et géo.
  • Les capacités supplémentaires de l'API Pull sont les suivantes :
    • Sélectionner une devise
    • Sélectionner un fuseau horaire

Rapports de données brutes disponibles via API Pull

Rapport Description Fréquence d'actualisation
Rapports de données brutes (non organiques)
Installations Enregistre les installations non organiques. L’enregistrement est généré lorsqu’un utilisateur ouvre l’app pour la première fois.
 temps réel
Évènement in-app Enregistre les événements réalisés par les utilisateurs.
 temps réel
Désisntallations Enregistre lorsqu’un utilisateur désinstalle l’app.
 Quotidien
Réinstallations
 Enregistre les utilisateurs qui, après avoir désinstallé l’app, interagissent avec une source média UA puis réinstallent l’app au cours de la fenêtre de réattribution. temps réel
Rapports de données brutes (organiques)
Installations organiques
 Enregistre lorsqu'un utilisateur ouvre l'app pour la première fois.
 En continu
Évènements in-app organiques
 Enregistre les détails des événements réalisés par les utilisateurs.
 En continu
Désinstallations organiques Enregistre les utilisateurs qui désinstallent l’app.
 Quotidien
Réinstallations organiques Enregistre le revenu publicitaire des utilisateurs qui sont attribués à une source média de retargeting au cours de la fenêtre de réengagement.
 Chaque jour
Données brutes des revenus publicitaires
Revenu publicitaire attribué
 		Enregistre le revenu publicitaire des utilisateurs attribués à une source média. Quotidien
Revenus publicitaires organiques Enregistre le revenu publicitaire des utilisateurs non attribués à une source média. Quotidien
Antifraude Protect360
d'installations Enregistre les installations identifiées comme frauduleuses et par conséquent attribuées à aucune source média. temps réel
Installations post-attribution Enregistre les événements in-app issus d'installations frauduleuses et par conséquent non attribuées. temps réel
Évènement in-app Enregistre les événements in-app identifiés comme frauduleux par Protect360. Quotidien
Évènements in-app post-attribution Enregistre les événements in-app des installations identifiées comme frauduleuses après avoir été attribuées à une source média, ou jugées frauduleuses sans égard à l'installation elle-même. Quotidien
Clics Enregistre les clics générés par les utilisateurs bloqués par Protect360. Quotidien
Postbacks d'installations bloquées Enregistre les copies des postbacks envoyés à la source média à l'origine de l'installation bloquée. temps réel
Les postbacks
Postback d'installation Enregistre les événements d'installation générés lorsqu'un utilisateur ouvre l'app pour la première fois. Quotidien
Postback d'évènements in-app Enregistre les postbacks d'événements in-app envoyés à la source média. Quotidien
Postbacks d'évènements in-app de retargeting Enregistre les événements in-app effectués par les utilisateurs au cours de la fenêtre de réengagement. temps réel
Postbacks de conversion de retargeting Enregistre les événements in-app effectués par les utilisateurs au cours de la fenêtre de réengagement. temps réel

Utiliser les données brutes de l'API Pull

Pour utiliser les données brutes de l'API Pull :

  1. AppsFlyerAdmin_us-en.pngObtenez le jeton de l'API. Un administrateur doit récupérer le jeton.
  2. Donnez à votre développeur le jeton d'API à utiliser dans l'en-tête d'authentification.
  3. Transmettez à vos développeurs les paramètres à saisir lorsqu'ils effectuent l'appel d'API, tels que décrits dans les paragraphes suivants. Les paramètres déterminent les points clés du rapport, comment il est organisé, et ils fournissent un calendrier de rapport.
  4. Demandez à votre développeur de suivre les instructions relatives aux données brutes de l'API Pull du dev hub.

Paramètres

Paramètre Description
from
  • La plage de dates est définie par les paramètres fromet to . Les dates se rapportent à la date de l'activité.
  • Format : aaaa-mm-jj, aaaa-mm-jj hh:mm, ou aaaa-mm-jj-hh:mm:ss Attention ! L'espace doit être encodé comme suit from=2020-04-01%2001:00:00 -Les navigateurs encodent généralement l'espace. 
  • Exemple : 2010-01-01 ou 2010-01-01 20:15 (paramètres d'heures et de minutes disponibles pour les rapports de données brutes). 
to Date de fin. Comme pour from

media_source

media_source : pour limiter (filtrer) l'appel à une source média spécifique. 

Définissez les paramètres media_source et category comme suit :

  • Pour Meta ads, réglez la catégorie et la source média sur facebook
  • Pour Twitter, réglez la catégorie et la source média sur twitter
  • Pour toutes les autres sources média, réglez la catégorie sur standard et la source média sur le nom de la source média.
  • Exemples
    • media_source=facebook&category=facebook
    • media_source=abc_example&category=standard
maximum_rows

Nombre maxi de lignes renvoyées pour chaque appel d'API.

  • [Par défaut] si aucune valeur n'est transmise, le maxi est 200 000 lignes
  • 200 000 : jusqu'à 200 000 lignes envoyées
  • 100 0000 : Jusqu'à 100 000 lignes envoyées
  • Exemple : maximum_rows=1000000 permet d'avoir 100 000 lignes disponibles. 
event_name

Pour filtrer les événements in-app par évènement spécifique. Pour sélectionner plusieurs événements, créez une liste en les séparant par des virgules.

Exemple : event_name=af_purchase,ftd 
reattr

Configurer les données d'attribution de retargeting.

  • [Par défaut] si false, les campagnes de données d'acquisition d'utilisateurs (AU) sont transmises.
  • Si true, les données d'attribution de retargeting sont renvoyées.
  • Exemple :reattr=true
additional_fields

Pour obtenir des champs supplémentaires en plus des champs par défaut. 

Exemple : additional_fields=device_download_time,deeplink_url
devise

Devise des revenus et des coûts

  • [Par défaut] Si le paramètre n'est pas envoyé, les données sont acheminés en utilisant la devise USD. Cela signifie que si vous ne modifiez rien, les résultats sont transmis en USD.
  • Si vous envoyez currency=preferred, c'est la devise spécifique à l'app qui est utilisée. Il s'agit de la devise définie dans les paramètres de l'app.

Exemple : si la devise spécifique à l'app est EUR, en envoyant  currency=preferred ,les valeurs sont transmises en EUR.
Fuseau horaire

[Default] Les données sont renvoyées en utilisant le fuseau horaire UTC.

  • Pour obtenir des données dans le fuseau horaire spécifique à l'app, ajoutez timezone à l'appel, comme indiqué ci-dessous : 
  •  timezone=[Numerical value] 
  • Exemple : pour le fuseau horaire UTC+10:00, utiliseztimezone=+10:00 Attention ! Le +,-, et : doivent être encodés. Exemple : +10:00 s'encode %2B10%3A00
geo

Filtrer les données par code pays.

Limitation : vous ne pouvez définir qu'un seul filtre de code pays par appel d'API. 

Exemple : geo=ZA
from_install time
  • La plage de dates est définie par les paramètres fromet to . Les dates se rapportent à la date de l'activité.
  • Format : aaaa-mm-jj
  • Exemple : 2010-01-01
to_install_time

Date de fin. Comme pour from_install time
agence

Pour limiter (filtrer) l'appel à une agence précise.

Champs Protect360

Consultez le guide sur les données brutes Protect360

Champs temporels

Si les résultats de l'API dépassent le maximum autorisé, divisez le rapport en heures et minutes. Appliquez ce qui suit :

  • from/to : aaaa-mm-jj hh:mm 
  • from: 
    • Date uniquement = commence au début (00:00) du jour choisi
    • Date et heure = à partir de 00:00 inclus
  • Paramètre to : 
    • Date uniquement = termine à la fin (24:00) du jour choisi
    • Date et heure = jusqu'à l'heure indiquée (mais non incluse)

Exemple : un propriétaire d'app a 300 000 installations quotidiennes provenant de multiples sources. Pour ne pas dépasser la limite quotidienne de 200 000 lignes, le propriétaire de l'app divise la journée en deux appels d'URI de 12 heures chacun. Cf tableau suivant pour voir les options. 

Appel d'API De  À 
Premier appel d'API 

depuis=aaaa-mm-jj

Exemple :

  • from=2019-12-29
  • Commence la première minute de ce jour à 00:00

jusqu'à=aaaa-mm-jj 12:00

Exemple :

  • to=2019-12-29 12:00
  • Continue jusqu'à 11:59:59 (et non 12:00) 

Option A :deuxième appel d'API 

 

Exemple : 

&from=2019-12-29 12:00&to=2019-12-29

  • Commence à midi (12:00) le 29 déc 2019
  • Se termine à minuit (00:00) le 29 déc 2019
  

depuis=aaaa-mm-jj 12:00

Exemple :

  • from=2019-12-29 12:00
  • Commence à partir de ce moment, 12:00 inclus

 

to=aaaa-mm-jj

Exemple :

  • to=2019-12-29
  • Se termine à minuit

 
Option B : deuxième appel d'API

depuis=aaaa-mm-jj 12:00

Exemple :

  • from=2019-12-29 12:00
  • Commence à partir de ce moment, 12:00 inclus

to=aaaa-mm-jj+1 00:00

+1 = jour suivant à 00:00

Exemple :

  • to=2019-12-30 00:00
  • C'est-à-dire avant qu'une seule seconde ne se soit écoulée le 30 décembre.

Remarque ! Les options A et B donnent les mêmes résultats. 

Champs supplémentaires

Les champs de rapport complémentaires ne sont pas ajoutés à la liste des champs par défaut, et ce afin d'éviter que les nouveaux champs n'affectent vos processus d'importation et d'intégration. Utilisez le paramètre additional_fields pour obtenir des champs supplémentaires non disponibles par défaut.

  • Ne faites apparaitre chaque champ qu'une seule fois.
  • Voir la liste des champs disponibles.
  • Exemple : additional_fields=device_download_time,deeplink_url

Champs par défaut

Champs de l'API Pull par défaut
Temps de touch attribué
Temps d'installation
Heure de l'évènement
Nom de l'événement
Valeur de l'événement
Revenu de l'évènement
Devise du revenu des évènements
Revenu de l'évènement en USD
Source de l'évènement
Possède une validation de reçu
Partenaire
Source média
Canal
Mots-clés
Campagne
Identifiant de la campagne
Ensemble de publicités
Identifiant de l'ensemble de publicités
Publicité
Identifiant de publicité
Type de publicité
ID site
Identifiant du sous-site
Sous-paramètre 1
Sous-paramètre 2
Sous-paramètre 3
Sous-paramètre 4
Sous-paramètre 5
Modèle de coût
Valeur des coûts
Devise des coûts
Partenaire du contributeur 1
Source média du contributeur 1
Campagne du contributeur 1
Type de touch du contributeur 1
Heure de touch du contributeur 1
Partenaire du contributeur 2
Source média du contributeur 2
Campagne du contributeur 2
Type de touch du contributeur 2
Heure de touch du contributeur 2
Partenaire du contributeur 3
Source média du contributeur 3
Campagne du contributeur 3
Type de touch du contributeur 3
Heure de touch du contributeur 3
Région
Code pays
État
city
Code postal
DMA
IP
wifi
operator
carrier
langue
ID AppsFlyer
ID publicitaire
idfa
ID Android 
ID utilisateur du client
imei
IDFV
Plate-forme
Type d'appareil
Version du système d'exploitation
Version de l'app
Version du SDK
ID d'app
Nom de l'app
ID de groupe
Retargeting en cours
Type de conversion de retargeting
Attribution rétrospective
Fenêtre de réengagement
Est une attribution principale
Agent utilisateur
Référent HTTP
URL d'origine

Informations supplémentaires

Particularités et limites

Particularité Commentaires 
Type de jeton API requis AppsFlyerAdmin_us-en.pngJeton V2.0
Accès du réseau publicitaire Non
Autorisations de l'agence Oui
Transparence de l'agence Oui. Notez cependant que si vous utilisez en même temps un filtre d'agence et un filtre de source média, le filtre de source de média ne s'appliquera pas aux agences non transparentes. Cela signifie que pour les agences non transparentes, toutes les données sont incluses (et pas uniquement les données provenant des sources média filtrées). 
Devise spécifique à l'app Oui
Fuseau horaire spécifique à l'app Oui
Actualisation des données
  • A la même valeur que la disponibilité des données du tableau de bord.
  • Les rapports sont mis à jour avec un décalage de quelques heures :
    • Rapport In-App Events Organiques
  • Rapports mis à jour quotidiennement :
    • Désisntallations
    • Évènements in-app post-attribution
    • Revenus publicitaires
Données historiques Oui.  Conformément aux règles de rétention et de limitation des taux . 
Données non organiques Oui
Données organiques Oui
Limitation de taux

Limitations de l'API pour les données brutes. 
Limitations de taille
  • Les appels d'API renvoient un max. de 200 000 lignes.
  • Si un rapport contient exactement 200 000 lignes, il lui manque probablement des lignes.
  • Le paramètre maximum_rows permet de choisir le nombre maximum de lignes.
  • Effectuez plusieurs appels d'API, en utilisant des paramètres from/to qui incluent l'heure.  
Install_date from et install_date_to La date d'installation doit être antérieure à la date d'activité. 

Dépannage

Problème/message SOLUTION
Le rapport ne contient pas les données correspondant à la période définie, ou il y a une différence de résultats entre le rapport de données brutes et le rapport de données agrégées. 

Vérifiez que vous avez bien défini le paramètre timezone. Si timezone n'est pas configuré, les données sont envoyées en utilisant l'UTC et non le fuseau horaire de votre application. 

À consulter également