Extraire les données agrégées de l'API

Recommandé pour
Marketeurs Développeurs
Dernière mise à jour :

En bref : utilisez les API Pull pour créer vos rapports agrégés AppsFlyer en fichiers CSV.

PullAPIAverage_us-en.png

 Vous recherchez les données brutes de l'API Pull ?

Pour tout savoir sur le sujet rendez-vous ici.

Extraire les données agrégées de l'API

  • L'API Pull vous permet d'obtenir des rapports de données agrégées pour l'acquisition d'utilisateurs (AU) et le retargeting dans des fichiers CSV.
  • Les taux d'actualisation des données sont les mêmes que ceux du rapport équivalent des pages Données d'exportation et Tableau de bord général. La mise à jour du coût peut nécessiter un délai de plusieurs heures, en fonction du partenaire qui fournit les données de coût. 
  • Filtrer par options disponibles  : source média et plage de dates.
  • Les capacités supplémentaires de l'API Pull sont les suivantes :
    • Ajout d'un type de touch d'attribution
    • Sélection du fuseau horaire 

Les rapports de performance agrégés disponibles via API Pull

Catégorie  UA Retargeting*
Partenaires (source média) ✓ ✓

Partenaires par date

 ✓ ✓

Quotidien

 ✓ ✓

Géo

 ✓ ✓

Rapport géo par date

 ✓ ✓

* Pour les rapports de retargeting, ajoutez &reattr=true à l'URI.

Lectures connexes :

Utilisation des données agrégées de l'API Pull 

Pour utiliser les données agrégées 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 ci-dessous. 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 agrégées de l'API Pull du dev hub.

Paramètres

Paramètre Description
app_id ID de l'app
from
  • La plage de dates se compose des paramètres FROMet TO . La plage est la plage LTV, la date d'installation.
  • Format : aaaa-mm-jj, 
  • Exemple : 2010-01-01
to Date de fin. Comme pour from
media_source

À utiliser pour limiter (filtrer) à une source média donnée.

  • Exemple :media_source=facebook
attribution_touch_type

Réglez ce paramètre comme indiqué dans l'exemple pour obtenir les KPI d'attribution post vue.

Exemple : attribution_touch_type=impression

Certains KPI d'attribution post vue, comme les clics, les impressions et les API de coût n'ont pas de valeurs associées et affichent la valeur N/A à la place.
devise

Devise des revenus et des coûts

Les rapports d'API Pull agrégés utilisent toujours la devise spécifique à l'app.
reattr

Obtenir les données de conversion de retargeting.

  • Si [Default] est false, les campagnes de données d'acquisition d'utilisateurs (AU) sont renvoyées.
  • Si true, les conversions de retargeting sont envoyées.
  • Exemple :reattr=true
Fuseau horaire

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

  • Les URI du template sont remplis avec le paramètre de fuseau horaire réglé sur le fuseau horaire spécifique à l'app. 
  • [Default] Si le paramètre n'est pas envoyé, les données sont renvoyées en utilisant le fuseau horaire UTC.
  • Si vous envoyez timezone=[Joda-Time], les données sont retournées en utilisant le fuseau horaire propre à l'app.

Remarques sur la sélection des fuseaux horaires

  • Le format de fuseau horaire Joda-Time tient compte de l'heure d'été.
  • La valeur Joda-Time doit être identique à la valeur définie à la page des paramètres de l'app. Par exemple, si le fuseau horaire sélectionné est Paris, la valeur du fuseau horaire de l'URL de l'API Pull doit être timezone=Europe%2fParis.
  • Le regroupement de données dans le fuseau horaire spécifié est uniquement disponible à partir de la date à laquelle le paramètre de fuseau horaire a été défini. Toutes les données antérieures à la date de la modification s'affichent selon le fuseau horaire UTC. 

Particularités et limites

Particularité Commentaires 
Type de jeton API requis AppsFlyerAdmin_us-en.pngJeton V2.0
Accès du réseau publicitaire N
Autorisations de l'agence Y
Transparence de l'agence Y
Devise spécifique à l'app Y
Fuseau horaire spécifique à l'app Y
Coût Les données de coût concernent uniquement les campagnes UA, elles ne s'appliquent pas aux campagnes de retargeting ou aux campagnes inactives (qui n'ont pas d'installations).
Actualisation des données En continu
Données historiques Y
Données non organiques Y
Données organiques Y
Limitations des taux

Limitation
Limitations de taille
  • Les appels d'API renvoient un max. de 200 000 lignes.
  • Si un rapport contient exactement 200 000 lignes, supposez que des lignes sont manquantes.
  • Effectuez plusieurs appels d'API, en utilisant des paramètres from/to qui incluent l'heure de la journée.  

Attention ! Les API Pull ne prennent en charge qu'un million de lignes pour les données brutes. Les rapports de données agrégées sont limités à 200 000 lignes. 
Changements de nom de campagne Les rapports API Pull ne prennent pas en charge les changements de nom de campagne