En bref : créez des rapports de données d'attribution pour matcher les données de niveau utilisateur provenant des événements d'installation/ de retargeting avec les données de vos systèmes.
Créer un rapport de données d’attribution
Pour créer un rapport de données d'attribution, suivez les étapes détaillées dans les onglets ci-dessous.
Remarque : Ces étapes ont été divisées en onglets pour faciliter la lecture. Toutes les étapes doivent être complétées pour créer un rapport.
Préparation
- Allez sur la page Rapports de l’onglet DCR.
- Cliquez sur le bouton + Nouveau rapport.
- Choisissez Données d'attributioncomme type de données source, puis cliquez sur Suivant (en bas à droite de l’écran).
- Saisissez le nom du rapport.
- Vous pouvez choisir n'importe quel nom pourvu qu'il vous permette d’identifier le rapport sur la plateforme DCR.
- Attention ! Veillez à ce que le nom du rapport ne soit pas utilisé pour une autre source sur votre compte, ou vous ne pourrez pas enregistrer le rapport.
- Obligations pour le nom du rapport :
- Longueur : 2-80 caractères
- Caractères valides :
- toutes les lettres (A-Z, a-z)
- le premier caractère du nom ne doit pas être un chiffre (0-9)
- le premier caractère du nom ne doit pas être un trait d’union (-)
- Caractères non valides :
- les espaces
- tous les autres symboles ou caractères spéciaux
Sélectionner les sources
Pour définir les données sources à utiliser dans le rapport :
Source des données d'attribution
- Apps : Sélectionnez une ou plusieurs apps dans votre compte AppsFlyer.
-
Types d'attribution : Sélectionnez un ou plusieurs types de données d’attribution à utiliser dans le rapport :
Installations Une installation est enregistrée lorsqu’un utilisateur télécharge, installe et lance une app mobile.
Réinstallations Une réinstallation est enregistrée lorsqu'un utilisateur installe une app, puis la désinstalle et la réinstalle pendant la fenêtre de réattribution.
- Remarque : La durée de la fenêtre de réattribution est définie dans Paramètres > Paramètres de l'app.
Réengagements Un réengagement est enregistré lorsque l’utilisateur inactif d’une app donnée interagit avec une campagne de retargeting pour cette même app, avant de la lancer.
Ré-attributions Une ré-attribution est enregistrée lorsque l’ancien utilisateur d’une app donnée (l’utilisateur l’a désinstallée) interagit avec une campagne de retargeting pour cette même app, avant de la réinstaller. Installations organiques Les installations organiques sont celles qui ne sont attribuées à aucune source média.
- Remarque : En incluant les installations organiques dans votre rapport vous augmenterez considérablement le nombre de lignes scannées.
- Fenêtre temporelle : sélectionnez le nombre de jours de données historiques pendant lequel la DCR doit rechercher les événements d’attribution qui matchent les événements de votre source personnalisée (de 1 à 180 jours).
Sources personnalisées
Pour la structure de votre rapport, vous pouvez choisir d’utiliser les données de n’importe quelle source personnalisée que vous avez créée. Vous devez sélectionner au moins une source personnalisée.
Relier les sources
Pour matcher les données entre les sources, chacune des sources personnalisées utilisées dans le rapport doit inclure un identifiant mappé à un identifiant de clé dans les données d’attribution.
Qu’est-ce qu’un identifiant de clé ?
Vous pouvez mapper l’un de ces identifiants de données d’attribution comme identifiant de clé :
-
ID AppsFlyer (af_id) : un identifiant d'app unique généré par AppsFlyer lors de l'installation –
- Cet ID s'affiche dans tous les événements enregistrés par AppsFlyer.
- Un nouvel ID AppsFlyer est généré dans le cas où une app est supprimée puis réinstallée.
-
ID utilisateur client (CUID) : un identifiant utilisateur unique souvent généré et défini par le propriétaire de l’app au moment de l’inscription de l’utilisateur.
- L’utilisation du CUID pour mapper des données nécessite que votre app soit configurée pour envoyer le CUID à AppsFlyer via le SDK ou l’API de serveur à serveur (S2S).
Attention !
Toutes les sources média ne permettent pas de matcher à l’aide du CUID. Il est fortement recommandé d’utiliser l’ID AppsFlyer.
Schémas de mappage (direct/indirect)
Si le rapport utilise plusieurs sources personnalisées, seule l’une d’entre elles doit être mappée directement à un identifiant de clé des données d'attribution. Les autres sources personnalisées peuvent être mappées directement ou indirectement, comme l’illustre cet exemple :
Exemple
Dans le scénario ci-dessus :
- L’identifiant de source personnalisée #1 AF est mappé directement à l’identifiant de clé des données d'attribution af_id.
- La source personnalisée #2 est mappée indirectement : user_code --> AF --> af_id.
- La source personnalisée #3 est mappée indirectement (via une chaîne plus longue) :
user_id --> user_code --> AF --> af_id. - L’identifiant de source personnalisée #4 ID est mappé directement à l’identifiant de clé des données d'attribution af_id.
- Notez qu’il aurait aussi pu être mappé indirectement (via l’identifiant de la source personnalisée #3 user_id), mais les deux méthodes fonctionnent.
✓ Ce schéma de mappage permet de matcher les données entre toutes les sources, en effet, chaque source personnalisée est mappée directement ou indirectement à l’identifiant de clé d’événement des données d'attribution af_id.
Définir le traitement de multiples événements de matching
Remarque
Si les types d'attribution sélectionnés pour le rapport comprennent uniquement les installations et/ou installations organiques, cette section ne vous concerne pas. Veuillez vous rendre directement à la section Sélection des dimensions.
Matcher tous les événements
La méthode de matching la plus complète permet à votre rapport d'inclure tous les événements de matching. Pour obtenir ce résultat, vous devez mapper un identifiant dans l'une des sources personnalisées du rapport, à l'identifiant des données d'attribution install_time.
- L'identifiant dans votre source mappé à install_time doit être au format suivant : aaaa-MM-jj HH:mm:ss.
- Remarque : Même si le nom de l'identifiant des données d'attribution est install_time, il indique en réalité l'heure de l'événement lorsqu'il fait référence aux événements de réinstallation, ré-engagement ou ré-attribution.
Matcher un événement unique
Si les types d'attribution que vous sélectionnez pour votre rapport incluent les ré-installations, ré-engagements ou ré-attributions, mais que vous ne mappez pas d'identifiant à install_time, vous devrez choisir d'utiliser soit le dernier soit le premier événement de matching dans votre rapport.
- Dernier événement : l'événement d'attribution inclus dans le rapport est le dernier événement (le plus récent) sur la période qui matche un certain identifiant de clé.
- Premier événement : l'événement d'attribution inclus dans le rapport est le premier événement (le plus ancien) sur la période qui matche un certain identifiant de clé.
faites votre choix en fonction de l’événement qui vous semble le plus pertinent par rapport aux informations que vous souhaitez obtenir du rapport.
Sélectionner les dimensions
N’oubliez pas que les données de niveau utilisateur ne peuvent pas être rapportées par la DCR. Elles vous fournissent cependant des informations précieuses si vous agrégez (ou regroupez) les données selon les dimensions de votre choix.
Une dimension est généralement un attribut avec lequel vous catégorisez les utilisateurs d’une app (ex. géo, date d’installation, campagne, etc.)
Sélection des dimensions d’un rapport
Les dimensions du rapport des données d'attribution peuvent comprendre :
- N’importe quelle dimension de données d’attribution disponible
- N’importe quel champ des sources personnalisées dans le rapport qui a été catégorisé comme dimension
Pour sélectionner les dimensions à inclure dans votre rapport :
- Sélectionnez une ou plusieurs dimensions dans la liste des dimensions des sources sur la gauche, et utilisez le bouton Ajouter au milieu de l’écran pour les ajouter à la liste des dimensions du rapport.
- Vous pouvez utiliser la barre de recherche pour trouver les dimensions dans les listes.
- Pour supprimer une dimension, sélectionnez-la dans les dimensions du rapport, puis utilisez la fonction Retirer pour la remettre dans la liste des dimensions des sources.
- Répétez jusqu’à ce que vous ayez ajouté chaque dimension que vous souhaitez inclure dans le rapport.
Remarque : Par défaut, tous les rapports sont regroupés par la dimension des données d'attribution media_source. Si vous ne souhaitez pas utiliser cette dimension dans votre rapport, vous pouvez la retirer de la liste des dimensions du rapport.
[Facultatif] Personnaliser les noms d’affichage des dimensions
Par défaut, les noms des dimensions s’affichent dans votre rapport exactement tels que dans les données d’attribution ou dans vos sources personnalisées. Si vous le souhaitez, vous pouvez personnaliser les noms de dimension de votre rapport.
Pour personnaliser le nom d’affichage d’une dimension :
- Dans la liste des dimensions du rapport, passez la souris sur le nom de la dimension dont vous souhaitez modifier le nom d’affichage.
- Cliquez sur le bouton de modification
qui s’affiche à droite de la dimension.
- Remplacez le nom par le nom d’affichage de la dimension à utiliser dans votre rapport (jusqu’à 50 caractères).
- Cliquez sur OK pour enregistrer le nom d’affichage, ou X pour l’annuler.
Protection de la confidentialité lors du regroupement par dimension (regroupement)
En fonction de la taille de votre ensemble de données, du nombre de dimensions choisies et de différents facteurs, il peut arriver qu’un rapport contienne un ou plusieurs groupes avec trop peu d’utilisateurs pour permettre le reporting. Si les données étaient rapportées de cette façon, cela enfreindrait les règles concernant la fourniture de données au niveau de l’utilisateur.
- Attention ! Le nombre minimum d’utilisateurs pour autoriser le reporting varie d’une source média à l’autre.
Toutefois, au lieu de retirer ou masquer complètement les données du rapport, la DCR utilise un procédé de regroupement pour fournir autant de détails que possible tout en préservant la confidentialité de l’utilisateur.
Exemple de regroupement
Supposons que vous ayez configuré un rapport avec les dimensions suivantes (dans l’ordre) :
-
Dimensions des données d'attribution :
- media source
- campaign
- adset_name
- ad_id
-
Dimensions des sources personnalisées :
- user_type
Avant le regroupement
Après une première analyse des données, la DCR décide que les données se répartissent comme suit :
source média |
campagne | nom de l’adset |
ID publicitaire |
type d’utilisateur |
rév J0 |
rév J7 |
total | reporting ? |
---|---|---|---|---|---|---|---|---|
media_source | UA_100 | green | kjh867 | buyer | 1 | 4 | 120 |
✓ |
media_source | UA_101 | green | jkj987 | ultra | 2 | 23 | 220 |
✓ |
media_source | UA_200 | green | lkh123 | beg | 6 | 7 | x |
X |
media_source | UA_200 | green | ilk945 | beg | 3 | 21 | x |
X |
media_source | UA_200 | green | plm654 | beg | 8 | 17 | x |
X |
Ici, les 3 dernières lignes ne sont pas rapportées car il y a trop peu d’utilisateurs dans chacune. (Cette source média nécessite un minimum de y utilisateurs pour pouvoir être rapportée. Or, ici il n’y en a que x.)
Selon la logique du regroupement, la DCR « élimine » d’abord la dernière dimension des données d'attribution listée (dans ce cas précis ad_id). Elle analyse ensuite une seconde fois les données pour déterminer quelles lignes peuvent être incluses dans le rapport.
Après le regroupement
Après l’action de regroupement, le rapport s’affiche comme suit :
source média |
campagne | nom de l’adset |
ID publicitaire |
type d’utilisateur |
rév J0 |
rév J7 |
total | reporting ? |
---|---|---|---|---|---|---|---|---|
media_source | UA_100 | green | kjh867 | buyer | 1 | 4 | 120 |
✓ |
media_source | UA_101 | green | jkj987 | ultra | 2 | 23 | 220 |
✓ |
media_source | UA_200 | green | RESTREINTE | beg | 17 | 45 | y (x+x+x) |
✓ |
Résultats :
- La dernière ligne réunit maintenant les données qui se trouvaient avant sur 3 lignes. Maintenant, la ligne cumulée a un nombre d’utilisateurs égal à y, elle peut donc être rapportée.
- La dimension qui était éliminée est maintenant marquée comme RESTREINTE.
- S’il y a d’autres lignes non rapportables (avec moins de y utilisateurs), la DCR continue d’analyser les données sur une base itérative, en éliminant une dimension après l’autre jusqu’à ce que :
- Il soit possible de rapporter toutes les lignes ; ou
- Il n’y ait plus aucune dimension de données d'attribution à éliminer
Remarque : Par défaut, la DCR applique le regroupement uniquement aux dimensions des données d'attribution (et non aux dimensions des sources personnalisées). Si les données regroupées par une dimension de données d'attribution produisent une ligne avec moins de y utilisateurs, alors les données de cette ligne sont marquées comme RESTREINTES.
- Ci-dessous vous trouverez une fonctionnalité avancée que vous pouvez aussi utiliser pour appliquer le regroupement aux dimensions des sources personnalisées.
[Facultatif] Gérer la priorité d’une dimension
Par défaut, les dimensions des données d'attribution sont éliminées dans l’ordre inverse de leur apparition dans la liste des dimensions du rapport. Toutefois, vous pouvez modifier la séquence par défaut et/ou appliquer le regroupement aux dimensions source personnalisées sélectionnées pour conserver les dimensions qui vous semblent les plus importantes.
Pour modifier l’ordre dans lequel les dimensions sont éliminées :
- Cliquez sur le bouton Gérer la priorité des dimensions.
- Sélectionnez une dimension et faites-la glisser à l’emplacement souhaité dans la liste (vous pouvez aussi utiliser les flèches à droite pour la déplacer).
- Une dimension marquée comme Haute priorité (en haut de la liste) sera la dernière à être éliminée si un regroupement s’impose.
- [Facultatif] Pour appliquer le regroupement aux dimensions de source personnalisée :
- Cliquez sur Utiliser les options avancées pour modifier le regroupement
- Sélectionnez les dimensions de source personnalisée auxquelles vous souhaitez appliquer le regroupement.
- Les dimensions sélectionnées sont ajoutées à la liste Gérer la priorité des dimensions.
- Par défaut, ces dimensions sont ajoutées au bas de la liste, c’est-à-dire qu’elles sont en Basse priorité pour le regroupement. Vous pouvez cependant les réorganiser comme n’importe quelle dimension de données d'attribution, comme décrit ci-dessus.
- Cliquez sur OK pour enregistrer vos modifications.
- Sur l’écran principal, la liste des dimensions du rapport reste dans l’ordre d’origine, mais l’ordre corrigé a bien été enregistré. (Cliquez à nouveau sur le bouton Gérer la priorité des dimensions si vous souhaitez revoir ou modifier votre sélection.)
Sélectionner des métriques
Les métriques (mesures) sont les données numériques que vous avez collectées pour un utilisateur d’app ( le revenu, le nombre d’ouvertures de l’app, la LTV, etc.), elles peuvent avoir n’importe quel valeur numéraire dans les champs des sources que vous avez définies comme métrique.
Pour sélectionner les métriques (mesures) à inclure dans votre rapport :
- Sélectionnez une ou plusieurs mesures dans la liste Métriques provenant des sources (sur la gauche) et utilisez le bouton Ajouter au milieu de l’écran pour les ajouter à la liste des Métriques du rapport.
- Vous pouvez utiliser la barre de recherche pour localiser les métriques dans les listes.
- Pour chaque mesure dans la liste Métriques du rapport, indiquez si vous souhaitez que les données soient rapportée comme :
- la somme de valeurs numériques ; ou
- un décompte séparé des valeurs
- Pour retirer une métrique, sélectionnez-la dans la liste Métriques du rapport et utilisez la fonction Supprimer pour la remettre dans la liste Métriques provenant des sources.
- Répétez jusqu’à ce que vous ayez ajouté toutes les mesures que vous souhaitez inclure dans le rapport.
[Facultatif] Personnaliser les noms d’affichage des métriques
Par défaut, les noms des mesures s’affichent dans votre rapport exactement tels que dans les données d’attribution ou dans vos sources personnalisées. Si vous le souhaitez, vous pouvez personnaliser les noms des mesures de votre rapport.
Pour personnaliser les noms d’affichage des métriques :
- Dans la liste Métriques du rapport, passez la souris sur le nom de la mesure dont vous souhaitez modifier le nom d’affichage.
- Cliquez sur le bouton de modification
qui s’affiche à droite de la mesure.
- Remplacez le nom par le nom d’affichage de la métrique à utiliser dans votre rapport (jusqu’à 50 caractères).
- Cliquez sur OK pour enregistrer le nom d’affichage, ou sur X pour l’annuler.
[Facultatif] Sélectionnez les identifiants à comptabiliser
Par défaut, chaque ligne du rapport se termine par une colonne avec le nombre d’ID AppsFlyer regroupés dans les données de cette même ligne.
Si vous souhaitez ajouter des colonnes pour avoir le décompte des autres identifiants de vos sources, procédez comme suit :
- Sélectionnez un ou plusieurs identifiants dans la liste des Identifiants provenant des sources (sur la gauche), puis utilisez le bouton Ajouter au milieu de l’écran pour les envoyer dans le Décompte des identifiants.
- Vous pouvez utiliser la barre de recherche pour localiser les identifiants dans la liste.
- Pour retirer un identifiant, sélectionnez-le dans la liste Décompte des identifiants, puis utilisez la fonction Retirer pour le remettre dans la liste des Identifiants provenant des sources.
- Répétez jusqu’à ce que vous ayez ajouté tous les identifiants que vous souhaitez dénombrer dans le rapport.
Définir la destination du rapport et l’enregistrer
La DCR fournit des rapports aux services cloud que vous avez sélectionnés via Data Locker AppsFlyer. Pour définir la destination d’un rapport vous devez donc sélectionner ou créer une connexion Data Locker.
- Remarque : Obtenir les rapports de la DCR ne nécessite pas d’abonnement premium à Data Locker. Si vous souhaitez recevoir d’autres rapports AppsFlyer via Data Locker, contactez votre CSM, ou envoyez un e-mail à hello@appsflyer.com.
Pour définir la destination d’un rapport et l’enregistrer :
- Sélectionnez dans la liste l’une des connexions Data Locker disponibles dans votre compte AppsFlyer.
- Si aucune connexion n’a été paramétrée dans votre compte :
- Un nouvel onglet s’ouvrira dans votre navigateur (affichant la page AppsFlyer Data Locker)
- Une boîte de dialogue Nouvelle connexion s’ouvrira. Veuillez suivre ces instructions pour créer la connexion.
- Si vous avez déjà des connexions, mais que vous souhaitez en utiliser une nouvelle, cliquez sur le bouton
:
- Un nouvel onglet s’ouvrira dans votre navigateur (affichant la page AppsFlyer Data Locker)
- Une boîte de dialogue Nouvelle connexion s’ouvrira. Veuillez suivre ces instructions pour créer la connexion.
- Après avoir créé la connexion, revenez à l’onglet DCR de votre navigateur, puis sélectionnez la connexion que vous venez de créer dans la liste des connexions Data Locker.
- Si aucune connexion n’a été paramétrée dans votre compte :
- Cliquez sur Sauvegarder pour enregistrer le rapport.
- Le nouveau rapport s’affiche maintenant dans l’onglet Rapports de la Data Clean Room.
Quand le rapport est-il généré ?
Une fois qu’un rapport a été créé et enregistré, il s’exécute chaque fois que qu’une nouvelle version de n’importe quelle source personnalisée qu’il utilise est détectée :
- Pour les sources présentes dans entrepôts de données (BigQuery et Snowflake), la DCR décide que la nouvelle version d’une source a été créée lorsqu’elle détecte une nouvelle valeur dans la colonne du tableau de la source.
- Attention ! Pour avoir la certitude que votre rapport est bien complet, pensez à alimenter le tableau de la source avec un ensemble complet de données à chaque fois que la valeur de la colonne est modifiée.
- Pour les sources situées dans des compartiments de stockage sur le cloud (Amazon S3 et GCS), la DCR décide que la nouvelle version d’une source a été créée lorsqu’elle détecte que l’importation d’une nouvelle version d’un fichier source, avec le dossier _SUCCESS qui l’accompagne.
AppsFlyer recherche en continu les nouvelles versions des fichiers sources pour le jour en cours et les 2 jours qui le précèdent.
Référence
Dimensions des données d’attribution disponibles
En plus des dimensions de vos sources personnalisées, les dimensions des données d'attribution suivantes peuvent servir dans le regroupement des rapports :
- media_source (inclus comme dimension de rapport par défaut)
- ad
- ad_id
- ad_type
- adset_id
- adset_name
- app_id
- app_version
- attributed_touch_type
- brand
- campaign
- campaign_id
- channel
- city
- contributor_1_campaign¹
- contributor_1_engagement_type¹
- contributor_1_match_type¹
- contributor_1_media_source¹
- contributor_1_partner¹
- contributor_1_touch_type¹
- contributor_2_campaign¹
- contributor_2_engagement_type¹
- contributor_2_match_type¹
- contributor_2_media_source¹
- contributor_2_partner¹
- contributor_2_touch_type¹
- contributor_3_campaign¹
- contributor_3_engagement_type¹
- contributor_3_match_type¹
- contributor_3_media_source¹
- contributor_3_partner¹
- contributor_3_touch_type¹
- conversion_type
- country
- customer_id
- device_type
- dma
- engagement_type
- geo_region
- keywords
- match_type
- media_source
- model
- original_url
- partner
- platform
- site_id
¹ Pour les ré-engagements et les ré-attributions, les champs resteront vides dans le rapport.