API de date d'arrivée de postback agrégé SKAN

En bref : Postbacks SKAdNetwork agrégés par l'intermédiaire de l'API. Les données sont agrégées à l'aide de la date d'arrivée des postbacks. 

API de date d'arrivée de postback agrégé SKAN

L'API renvoie les postbacks SKAdNetwork agrégés, en utilisant leur plage de dates d'arrivée.

Remarque ! La date d'arrivée des postbacks diffère de la date d'installation utilisée dans le tableau de bord et les rapports SKAdNetwork.

Utilisation de l'API de rapport de performance agrégé SKAN

Pour utiliser l'API de rapport de performance agrégé SKAN :

  1. Obtenez le jeton API. Un administrateur doit récupérer le jeton.
  2. Donnez à votre développeur le jeton API à utiliser dans l'en-tête d'authentification.
  3. Fournissez à vos développeurs les paramètres à saisir lors de l'appel d'API, comme décrit dans la section suivante. Les paramètres déterminent les éléments sur lesquels se concentre le rapport, comment il est organisé et ils fournissent un calendrier de reporting.
  4. Demandez à votre développeur de suivre leur API de rapport de performance agrégé SKAN dans le hub des développeurs.

Paramètres

Nom du paramètre Détails Obligatoire

start_date

La plage de dates d'arrivée des postbacks est délimitée par start_date et end_date. Remarque! La date d'arrivée diffère de la date d'installation utilisée dans le tableau de bord et les rapports SKAdNetwork.

  • AAAA-MM-JJ 
  • Date la plus ancienne autorisée : 2020-11-01
    Exemple: 2020-11-05
Oui
end_date
  • AAAA-MM-JJ
  • Nombre maximum de jours par appel de rapport : 60 jours 
  • Exemple: 2020-11-12
Oui
ad_network_name

Filtrer par source média

Non

geo Filtrer par code pays en utilisant ISO 3166 (alpha-2). Exemple : US, CN

Non

skad_redownload

Filtrer par true ou false

Non

skad_source_app_id

Filtrer par ID d'application source

Non

ad_network_campaign_id

Filtrer par ID de campagne de réseau publicitaire.

Remarque : Ceci n'est pas l'ID de campagne signalé par SKAdNetwork.

Non

modeled_conversion_values
  • Pris en charge uniquement à partir de la version 2
  • La valeur peut être soit soit
  • Si true, le postback remplit la colonne « count » avec des données de valeur de conversion modélisées.  Voir le champ disponible pour les données modélisées
  • Si , le postback présente le nombre de valeurs de conversion et tous les champs disponibles tels que reçus, répertoriés dans la structure du rapport, sans données modélisées.
  • La valeur par défaut est .

Non

Structure et exemple de rapport

L'API retourne un fichier CSV.

Les colonnes et les mesures disponibles sont listées dans le tableau ci-dessous.

Exemples : V1 | V2

Structure du rapport agrégé SKAdNetwork
Nom de la colonne Dimension ou mesure Disponible avec le jeton API V1 Disponible avec le jeton API V2 Disponible avec le jeton API V2 (pour SKAN 4) Disponible avec le filtre de données modélisées uniquement
index_de_séquence_de_postback_skad Regrouper par N N O O

valeur_de_conversion_skad

Regrouper par O O O O

valeur_grossière_de_conversion_skad

Regrouper par N N O O

identifiant_réseau_skad_ad

Certains SRN ne partagent pas leur identifiant avec nous. Dans ce cas, le champ est vide et nom_du_réseau_publicitaire est renseigné.

Regrouper par

O

O

O

O

nom_du_réseau_publicitaire

Actuellement, dans la plupart des cas, ce champ est vide. Nous le renseignons dans le cas des SRN qui ne partagent pas leur identifiant_réseau_skad_ad.

Regrouper par O O O O

identifiant_source_skad

Regrouper par N N O O

identifiant_campagne_skad

Regrouper par O O O O

identifiant_campagne_réseau_publicitaire

Regrouper par O O O O

nom_campagne_réseau_publicitaire

Regrouper par O O O O

identifiant_adset_réseau_publicitaire

Regrouper par N O O O

nom_adset_réseau_publicitaire

Regrouper par N O O O

identifiant_pub_réseau_publicitaire

Regrouper par N O O N

nom_pub_réseau_publicitaire

Regrouper par N O O N

créatif_réseau_publicitaire

Regrouper par N N O N

canal_réseau_publicitaire

Regrouper par N N O N

version_skad

Regrouper par O O O N

skad_redownload

Regrouper par O O O N

identifiant_app_source_skad

Regrouper par O O O N

domaine_source_skad

Regrouper par N N O O

type_de_fidélité_skad

Regrouper par N O O N

géolocalisation

Regrouper par O O O N

date_d'arrivée

Regrouper par O O O O

compter

Mesure O O O O

Spécifications et limitations

Spécifications Remarques 
Actualisation des données

Le rapport est mis à jour quotidiennement.

La disponibilité des données dépend du taux d’actualisation des données SKAdNetwork.

Plage de dates
  • Date la plus ancienne prise en charge : Novembre 1, 2020
  • Plage de requête maximale : 60 jours
Limite de taux
  • Les requêtes retournent jusqu'à 200 000 lignes
  • 60 appels par minute
SRN

Google Ads : La date d'arrivée du postback est déterminée à partir de l'heure du dernier clic rapportée par Google. 

Accès au réseau publicitaire  Disponible pour les partenaires analytiques si l'annonceur donne son autorisation. 
Accès aux agences Non disponible
Fuseau horaire spécifique à l'application UTC uniquement
Devise spécifique à l'application  Toujours en USD
Données organiques Non disponible avec cette API
Données non organiques Calculé à partir des postbacks SKAdNetwork reçus par AppsFlyer
Données historiques Données de conversion les plus anciennes (installation ou reciblage) prises en charge : 1er novembre 2020
Accès utilisateur du compte Le jeton d'autorisation est disponible pour un utilisateur administrateur dans le tableau de bord.