Analyse des cohortes via Data Locker

En bref : L'analyse des cohortes dans Data Locker contient des données agrégées de tous les éléments de la hiérarchie publicitaire. Les rapports contiennent des données sur les utilisateurs qui ont effectué des attributions au cours des 365 jours précédents. Ce rapport est accessible aux annonceurs qui disposent de données brutes ou de l'API Cohort, ou des deux, dans le cadre de leur abonnement. Cela signifie qu'aucun abonnement Data Locker n'est requis pour ce rapport.

Analyse des cohortes dans Data Locker

Dans certains cas, les données brutes d'attribution dans AppsFlyer sont limitées en raison des politiques de partage des données des sources média ou de vos politiques de protection de la vie privée. La restriction inclut tous les champs liés à l'attribution, tels que la campagne et l'adset. Les rapports de cohorte vous fournissent des données agrégées qui peuvent être utilisées comme alternative aux données brutes. 

Télécharger un exemple de rapport

Activer Data Locker

Le rapport est disponible pour Data Locker, l'API Cohort et les abonnés aux données brutes. Pour activer le rapport dans Data Locker, effectuez l'une des procédures suivantes. 

Obtenez-vous actuellement des données via Data Locker ?  Marche à suivre

 

Oui 

AppsFlyerAdmin_us-en.pngPour ajouter les rapports de cohorte à Data Locker :

  1. Dans AppsFlyer, dans le menu latéral, sélectionnez Rapport > Data Locker.
  2. Sélectionnez tous les rapports dans la section Analyse des cohortes
  3. Cliquez sur Enregistrer la configuration
    Les rapports seront disponibles le lendemain à 10:00 UTC.
Non

AppsFlyerAdmin_us-en.pngPour configurer Data Locker :

  1. Achevez la toute première configuration Data Locker (annonceur | partenaire).
  2. Ajoutez les rapports de cohorte à Data Locker :
    1. Dans AppsFlyer, dans le menu latéral, sélectionnez Rapport > Data Locker.
    2. Sélectionnez tous les rapports dans la section Analyse des cohortes
    3. Cliquez sur Enregistrer la configuration
      Les rapports seront disponibles le lendemain à 10:00 UTC.

Vous pouvez charger les données dans vos systèmes de BI et les utiliser dans le cadre de vos processus de performance et d’optimisation des campagnes ;

Métriques disponibles

Les métriques disponibles sont les revenus, les utilisateurs uniques qui effectuent un événement et le nombre d’occurrences d’événements. Pour calculer des indicateurs liés aux coûts tels que le ROI (retour sur investissement) et le ROAS (retour sur les dépenses publicitaires), vous avez besoin à la fois de données liés aux revenus et aux coûts. Les mesures de revenus sont dans la partie Cohorte. Les mesures de coûts sont fournies par l’ETL des coûts ROI360.

Faits relatifs à l'analyse des cohortes

Rapports disponibles

Les rapports suivants peuvent être téléchargés. Les types de rapports sont décrits plus en détail dans le tableau de bord «Cohorte».

  • Acquisition d'utilisateurs : attribués à une source média d'acquisition d'utilisateurs, y compris la lifetime value (LTV) se produisant pendant les fenêtres de réengagement.
  • Retargeting : attribués à une source média de retargeting pour les événements qui ont lieu :
    • pendant une fenêtre de réengagement ;
    • suite à une réattribution
  • Unifiés : affichent les données sous la dernière source média ayant attiré l'utilisateur, selon les règles de double attribution d'AppsFlyer. Cela signifie que les LTV survenant lors de réengagements s'affichent sous la source média de retargeting et non sous la source média d'UA.
Période de reporting Utilisateurs ayant effectué des conversions au cours des 365 derniers jours. En d'autres termes, chaque jour, les rapports incluent les conversions effectuées par les utilisateurs au cours des 365 jours précédents. 
Structure du rapport Le schéma de chaque rapport (dimensions et métriques incluses) est fixe et ne peut pas être modifié. Voir la structure du rapport.
Livraison du rapport  Voir Activer les rapports de cohorte dans Data Locker.
Actualisation des données
  • Quotidiennement.
  • Les mesures sont calculées à l'aide des données disponibles à minuit UTC. En d'autres termes, en fin de journée. 
  • Les rapports sont disponibles dans Data Locker dans le dossier date-heure (dt) avant 10 h UTC. Par exemple, les données du lundi sont disponibles le mardi à 10 h UTC dans le dossier Lundi. 
L'impact des politiques de rétention des partenaires

Considérez que certains partenaires mettent en œuvre une politique de conservation des données. Dans ce cas, les événements survenant après la fin de la période de rétention sont considérés comme organiques dans les rapports de cohorte.

Exemple : Le SRN A a une politique de conservation des données de 180 jours. Les événements utilisateur survenus jusqu'au 180e jour sont attribués au SRN A. Les événements survenant après 180 jours sont considérés comme organiques.

Structure du rapport

Le rapport est composé de mesures et de métriques.

Le format des champs est le suivant :

  • Mesures : chaînes. La longueur maximale de la chaîne est dynamique et, dans la plupart des cas, dépend de la façon dont vous renseignez les éléments de la hiérarchie publicitaire.
  • Indicateurs : nombres. Remarque : le format du champ selected_currency est une chaîne.

Dimensions

Nom du champ 

Description

app_id

--

media_source

--

conversion_type

Valeurs possibles : install, install-unified (représentant les installations dans le rapport unifié), réengagement, réattribution

attributed_touch_type

Valeurs possibles : clic, impressions, préinstallation, inconnu, tv, nul

days_post_attribution

  • Le nombre de jours écoulés depuis la date de conversion (pas l'horodatage spécifique de la conversion).
  • Astuce ! Utilisez ce tag pour calculer les jours de rétention et ceux des KPI.

event_date 

  • Date à laquelle un utilisateur effectue un événement donné.
  • Format : aaaa-mm-jj
  • Exemple : La date à laquelle un utilisateur a effectué un événement in-app donné. Dans le cas d’une conversion.
  • Important ! Si le event_name est af_conversion, la date de l’événement et la date de conversion seront les mêmes. 

conversion_date

  • La date à laquelle la conversion a eu lieu
  • Format : aaaa-mm-jj
  • Exemple : La date d’installation

event_name

Identifie l’événement. Certains noms d’événements ont une signification spécifique, tandis que d’autres sont liés à des événements intégrés définis par l’annonceur dans l’application. 

event_name

Qu’a fait l’utilisateur ?

af_conversion Utilisateur converti. Utilisez conversion_type pour identifier s’il s’agit d’une installation, d’un réengagement ou d’une réattribution.
af_session a ouvert l'application
cohort_uninstalls A désinstallé l'app 
Événement in-app défini par l’annonceur a effectué un événement dans l’application

campagne

Hiérarchie des campagnes

N'oubliez pas : il n’est pas possible de modifier le nom de la campagne, une fois celui-ci établi. Par conséquent, plusieurs noms peuvent être associés à un même identifiant de campagne. 

campaign_id

Hiérarchie des campagnes

adset

Hiérarchie des campagnes

adset_id

Hiérarchie des campagnes

ad

Hiérarchie des campagnes

ad_id

Hiérarchie des campagnes

canal

Hiérarchie des campagnes.

[À jour le 27 octobre 2021] À l'heure actuelle, les annonces Meta ne renseignent pas le canal dans les données fournies via le mécanisme de référencement d'installation de Google, le Google Install Referrer.

site_id

Hiérarchie des campagnes

is_primary_ attribution

Permet d’identifier et de dédupliquer les données de retargeting.

geo

Le code de pays ISO dérivé de l’adresse IP de l’utilisateur.

agency

  • Information sur l'agence prise en charge.
  • Lorsque les agences ne fournissent pas de détails complets sur leurs activités (non transparentes), plusieurs lignes avec le même nom de campagne peuvent apparaître si l'annonceur et l'agence lancent des campagnes portant le même nom. Pas d'inquiétude. Les lignes ne sont pas dupliquées.

install_app_store

Applications Android uniquement : La boutique Android à partir de laquelle l’application a été téléchargée. Alimenté par les annonceurs mettant en œuvre l'attribution multi-magasins sur Android. Si ce champ est vide, cela signifie Google Play Store. 

keywords

Le ou les mots utilisés par l'internaute lors de sa recherche. Tels que rapportés par le réseau publicitaire.

keyword_id

[Champ disponible depuis le 27 avril 2022] ID de mot clé renvoyé par le réseau publicitaire.

Métriques

Nom du champ

Description Format

unique_users

Nombre d’utilisateurs uniques le jour de l’événement.

Nombre

revenue_usd

  • Montant du chiffre d’affaires en USD. Par exemple, 100,56 $ est présenté comme 100,56.
  • Maximum de 2 décimales après la virgule.
Nombre

event_count

Nombre d'événements.

Nombre

selected_currency

Code de devise à 3 lettres (USD, EUR) que vous définissez dans les paramètres de l’application. Format ISO-4217. Il s’agit de la même devise que celle utilisée pour afficher les revenus dans Cohorte dans l’interface utilisateur. 

Chaîne

revenue_selected_currency

  • Montant du revenu dans la devise sélectionnée. Par exemple, si la devise sélectionnée est EUR, alors 1234,56 € est indiqué comme 1234,56
  • Maximum de 2 décimales après la virgule
Nombre

Considérations pour les développeurs BI

Portée des données dans le rapport

Les rapports contiennent les installations par les utilisateurs en acquisition, les ré-attributions et les ré-engagements de retargeting, ainsi que les événements associés dans l'application.

Vous pouvez charger des rapports unifiés, d’acquisition d’utilisateurs et de retargeting séparément ou ensemble dans votre BI. Si vous les chargez ensemble et que vous souhaitez filtrer les vues par vous-même : 

  • Pour consolider les données, utilisez le champ is_primary_attribution=true ou laissez le champ nul.
  • Pour l’acquisition d’utilisateurs, utilisez conversion_type=Install.
  • Pour le retargeting, utilisez conversion_type=réengagement ou réattribution.

Si vous utilisez simplement la vue unifiée dans votre processus de chargement des données, vous pouvez utiliser la logique pour répartir les données entre les types de campagne, c’est-à-dire l’attribution des utilisateurs (installations) et le retargeting (réengagements). Pour ce faire, utilisez les conversion_type=install, install-unified, re-engagement ou re-attribution. Double attribution d'événements de retargeting. 

Considérations au niveau du champ

  • Utilisez les jours de post-attribution pour faciliter le calcul des mesures de rétention.
  • Calcul des utilisateurs uniques à l’aide des mesures liées au nom et et à l’ID de campagne : Si vous pouvez ignorer la granularité des noms de campagne, vous pouvez totaliser un décompte unique à partir de l'ID de campagne. Les indicateurs seront ainsi fiables.  
  • Vous pouvez agréger les données à l’aide des champs de hiérarchie de campagne. 
  • Les revenus en USD sont calculés en utilisant le taux de change du jour de l’événement. 
  • Les événements liés aux revenus publicitaires sont inclus lorsqu'ils sont disponibles, mais ils peuvent être mis à jour avec un retard allant jusqu'à 3 jours.

Considérations générales

Les données de toutes les applications sont fournies dans un seul fichier. Utilisez le champ App ID pour séparer les données par application ou configurez Data Locker pour les séparer par application.

Cas d’utilisation

Voici quelques exemples d’applications populaires et pratiques des données de cohorte que les développeurs BI peuvent extraire via Data Locker. Chaque exemple est illustré par une requête SQL et un exemple de visuel Excel. 

1. Calcul de la rétention

Dans l’exemple suivant, nous :

  • Calculons la rétention Jour 1 et Jour 7, ainsi que le nombre total d’installations par campagne et publicité ;
  • Additionnons le nombre d’événements par événement de conversion en filtrant event_name pour qu’il soit af_conversion ;
  • Analysons spécifiquement les campagnes d’acquisition d’utilisateurs en filtrant les données afin que conversion_type=install.

instruction SQL

select
    campaign_id, ad_id,
    sum(if(event_name = 'af_conversion', event_count,0)) as installs,
    sum(if(event_name = 'af_session' and days_post_attribution = 1, unique_users,0)) / sum(if(event_name = 'af_conversion', event_count,0)) as retention_day1,
    sum(if(event_name = 'af_session' and days_post_attribution = 7, unique_users,0)) / sum(if(event_name = 'af_conversion', event_count,0)) as retention_day7
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    and conversion_type = 'install'
    and app_id = YOUR_APP
group by 1,2

Exemple d’Excel

ID de campagne ID publicitaire Installations Jour 1 de rétention Jour 7 de rétention
12345678 987654 100 30 % 10 %
98765432 123456 200 25 % 15 %
07315466 613770 300 20 % 12 %

2. Calcul de l’ARPU de plusieurs événements dans l’application

Dans l’exemple suivant, nous :

  • Calculons l’ARPU de plusieurs événements in-app par campagne.
  • Analysons spécifiquement les campagnes de reciblage en filtrant les données de sorte que conversion_type=re-engagement et conversion_type=re-attribution.
  • Additionnons le nombre d’événements par événement de conversion en filtrant event_name pour qu’il soit af_conversion ;
  • Additionnons les revenus de plusieurs événements, dans ce cas af_purchaseet af_coins.
  • Définissez days_post_attribution le minimum nécessaire (dans ce cas, 7) pour minimiser la charge de traitement des données.

Instruction SQL

select
    campaign_id,
    sum(if(days_post_attribution <= 1 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day1,
    sum(if(days_post_attribution <= 3 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day3,
    sum(if(days_post_attribution <= 7 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day7
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    and days_post_attribution <= 7
    and conversion_type in ('re-engagement', 're-attribution')
    and app_id = YOUR_APP
group by 1

Exemple Excel

ID de campagne Types de conversion

ARPU

Jour 1

ARPU

Jour 3

ARPU

Jour 7

12345678 Réengagement 6,23 5,11 2,34
98765432 Réengagement 3,57 1,34 4,86
07315466 Réattribution 7,41 6,79 5,29

3. Calcul du taux de conversion des événements in-app pour un jour de cohorte spécifique

Dans l’exemple suivant, nous :

  • Calculons le taux de conversion de l’événement dans l’application Jour 0 pour plusieurs mesures (dans ce cas, la date de conversion, la zone géographique, la campagne, l’annonce et l’ID du site).
  • Analysons les données unifiées (UA et campagnes de remarketing) en filtrant les données de sorte que is_primary=true.
  • Additionnons le nombre d’événements par événement de conversion en filtrant event_name pour qu’il soit af_conversion ;
  • Définissons days_post_attribution le minimum nécessaire (dans ce cas, 7) pour minimiser la charge de traitement des données.

Instruction SQL

select
    conversion_date, geo, campaign_id, ad_id, site_id,
    sum(if(days_post_attribution = 0 and event_name = 'af_complete_tutorial', unique_users, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as day0_af_tutorial_conversion
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    and is_primary = true
    and app_id = YOUR_APP
group by 1,2,3,4,5

Exemple Excel

Date de la conversion Géo

ID de campagne

ID publicitaire

ID de site

Jour 0 af_complete_tutorial

2022-11-07 États-Unis 12345678 123456 site_123 45 %
2022-11-05 GB 98765432 Nul site_654 70 %
2022-10-31 KR 07315466 Nul Nul 63%

4. Calcul des installations quotidiennes 

Dans l’exemple suivant, nous :

  • Calculons le nombre d’installations par ID d’application, date de conversion, source média, nom de l’événement et type de conversion.
  • Filtrons les données pour afficher les installations UA (pas le retargeting), en définissant conversion_type sur install.
  • Additionnons les installations en définissant event_name pour qu’elles soient af_conversion

Instruction SQL

select
    app_id,
    conversion_date,
    media_source,
    event_name,
    conversion_type,
    sum(events_count) as total
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    and conversion_type = 'install'
    and event_name = 'af_conversion'
    and app_id = YOUR_APP
group by 1,2,3,4,5

Exemple Excel

ID d'app Date de la conversion

Source média

Nom de l'événement

Total

id123456789 2022-11-07 adnet1_int af_conversion 105
id123456789 2022-11-05 adnet2_int af_conversion 216
id123456789 2022-10-31 adnet3_int af_conversion 327

5. Calcul des revenus à partir des publicités Facebook 

Dans l’exemple suivant, nous :

  • Calculons les revenus de Facebook du jour 3 par date de conversion et ID d’application.
  • Analysons les données Facebook en filtrant les données de sorte que media_source='Facebook Ads'.
  • Définissons days_post_attribution le minimum nécessaire (dans ce cas, 3) pour minimiser la charge de traitement des données.

Instruction SQL

select
    conversion_date,
    app_id,
    media_source,
    sum(if(days_post_attribution <= 3, revenue_usd, 0)) as revenue_day3
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2022-06-01' and '2023-05-31'
    and days_post_attribution <= 3
    and media_source = 'Facebook Ads'
    and app_id in (APP_ID1, APP_ID2, ...)
group by 1,2,3

Exemple Excel

Date de la conversion ID d'app

Source média

Revenus

Jour 3

2022-11-07 id123456789 adnet1_int 400,45
2022-11-05 id123456789 adnet2_int 99,23
2022-10-31 id123456789 adnet3_int 13,34

6. Calcul de l’ARPU par ID de mot-clé ASA pour un maximum de 365 jours de cohorte 

Dans l’exemple suivant, nous :

  • Calculons l’ARPU à partir d’Apple Search Ads par identifiant de mot-clé jusqu’au jour de cohorte 365.
  • Analysons les données Apple Search Ads en les filtrant de sorte que media_source='Apple Search Ads'.
  • Additionnons le nombre d’événements par événement de conversion en filtrant event_name pour qu’il soit af_conversion ;

Instruction SQL

select
    media_source,
    keyword_id,
    sum(if(days_post_attribution <= 365, revenue_usd,0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day365
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2022-06-01' and '2023-05-31'
    and media_source = 'Apple Search Ads'
    and app_id = YOUR_APP
group by 1

Exemple Excel

Source média

ID de mot clé

ARPU

Jour 365

adnet1_int 123456 57 019,93
adnet2_int 987654 64 867,84
adnet3_int 666854 48 160,02

7. Calcul du ARPU (revenu moyen par utilisateur) à J+7 par heure d'attribution et par zone géographique 

L’exemple suivant illustre comment utiliser les indicateurs de performance par heure d’attribution. :

  • Calcul de l’ARPU à J+7 par date d’attribution et par zone géographique ;
  • Les résultats sont triés en fonction du nombre de conversions, les 20 premières zones géographiques s’affichant ;
  • Les données sont filtrées de sorte que conversion_type='install' ;
  • La première colonne indique la zone géographique. La deuxième colonne indique le nombre total de conversions. Les colonnes suivantes affichent le revenu à J+7 pour chaque jour spécifié comme une ligne dans la requête.

Instruction SQL

select
    geo,
    sum(if(event_name = 'af_conversion', event_count, 0)) total_conversions,
    sum(if(cohort_day = '2023-07-11' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-11' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_11,
    sum(if(cohort_day = '2023-07-12' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-12' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_12,
    sum(if(cohort_day = '2023-07-13' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-13' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_13,
    sum(if(cohort_day = '2023-07-14' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-14' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_14,
    sum(if(cohort_day = '2023-07-15' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-15' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_15,
    sum(if(cohort_day = '2023-07-16' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-16' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_16
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-07-11' and '2023-07-16'
    and days_post_attribution <= 7
    and conversion_type = 'install'
    and app_id = 'YOUR_APP'
group by 1
order by 2 desc
limit 20

Exemple Excel

Géo

Total des conversions

ARPU Jour 7 pour 11/07/2023

ARPU Jour 7 pour 12/07/2023

ARPU Jour 7 pour 13/07/2023

ARPU Jour 7 pour 14/07/2023

ARPU Jour 7 pour 15/07/2023

ARPU Jour 7 pour 16/07/2023

Corée du Sud 120.660 7.798,89 $ 6.997,37 $ 8.258,95 $ 9.050,21 $ 10.018,04 $ 13.765,73 $
Canada 35.099 64.867,84 $ 7.050,19 $ 5.656,33 $ 9.553,75 $ 8.632,41 $ 11.308,06 $
Chili 26.750 48.160,02 $ 21.249,55 $ 22.584,57 $ 24.033,07 $ 31.118,91 $ 41.145,22 $

Informations supplémentaires

Caractéristiques et limitations

Caractéristique  
Données de coûts Non disponible. Utilisez Cost ETL.
Changements de nom de campagne Pas de prise en charge. 
Actualisation des données UTC quotidien Les rapports se trouvent dans le dossier date-heure (dt) de Data Locker du jour de rapport avant 10h00 UTC le lendemain. 
Revenus publicitaires
  • Disponible
  • Pour les événements af_ad_revenue, la mesure des utilisateurs uniques n'est pas disponible pour les dates comprises entre le 5 octobre 2022 et le 16 février 2023.
Devise  L’USD et la devise spécifique à l’application sont toutes deux disponibles par ligne
Fuseau horaire
  • UTC
  • Le fuseau horaire spécifique à l'application est disponible dans la version bêta.
Données organiques Disponible
Jours après la conversion (installation, réattribution, réengagement)
  • 365 jours de données post-installation sont disponibles.
  • 1 095 jours sont disponibles avec la version bêta.
Transparence de l'agence
  • Pris en charge 
  • Les données des publicités X et Meta sont toujours transparentes
Segmentation des apps Pris en charge
Données SKAN Non inclus. Cela signifie que les données sont fournies par les postbacks iOS.
Réinstallations
  • Si les événements survenus après la réinstallation sont considérés comme organiques non attribués :
    • Ils ne sont inclus qu'à compter du 26 mai 2024. En savoir plus
    • La date d'installation attribuée aux événements organiques non attribués est la date de la première installation, à l'exception des événements liés aux revenus. En savoir plus
  • S'ils sont attribués à la première installation, ils sont toujours inclus. En savoir plus

Articles connexes