Data Clean Room : création de rapports d’événements in-app

1. Allez à la page Rapports de l’onglet DCR.
2. Cliquez sur l’icône + Nouveau rapport bouton.
3. Choisissez Événements in-appcomme type de données source, puis cliquez sur Prochain dans le coin inférieur droit de l’écran.
4. Entrez un nom pour le rapport.
   • Il peut s’agir de n’importe quel nom qui vous aidera à identifier le rapport dans la plateforme DCR.
   • Attention ! Assurez-vous que le nom du rapport est différent de tous les autres rapports de votre compte, sinon vous ne pourrez pas Enregistrer le rapport.
   • Exigences relatives au nom du rapport :
     • Longueur: 2-80 caractères.
     • Caractères valides :
       • lettres (A-Z, a-z)
       • un chiffre (0-9) ne peuvent pas être le premier caractère d'un nom
       • un trait d’union (-), ne peut pas être le premier caractère d’un prénom
     • Caractères non valides :
       • espaces
       • tous les autres symboles ou caractères spéciaux

Spécifiez les données sources à utiliser pour le rapport :

Sources d'événements in-app

• Apps : Sélectionnez une ou plusieurs apps dans votre compte AppsFlyer.
• Période : Sélectionnez le nombre de jours de données historiques pendant lesquels vous souhaitez que la DCR recherche les événements in-app (de 1 à 30 jours).
• Évènements : Sélectionnez un ou plusieurs événements in-app à inclure dans le rapport.
  • Les événements disponibles incluent tous les événements in-app à partir des apps sélectionnées qui ont été configurés pour signaler des données à AppsFlyer via le SDK ou l’API de serveur à serveur (S2S).
• Types de sources : Sélectionnez un ou plusieurs types de données d’événement in-app :

  Installations	Événements in-app liés aux attributions d’installation Une installation est enregistrée lorsqu’un utilisateur télécharge, installe et lance une app mobile.
  Réengagements	Événements in-app liés aux réengagements Un réengagement est enregistré lorsqu’un utilisateur inactif d’une app spécifique s’engage dans une campagne de retargeting pour l’app et la lance par la suite.
  Réattributions	Événements in-app liés aux réattributions Une réattribution est enregistrée lorsqu’un ancien utilisateur d’une app spécifique (qui l’avait désinstallée) s’engage dans une campagne de retargeting pour cette app et la réinstalle par la suite.

Sources des données

1. [Facultatif] Ajoutez d’autres sources à utiliser dans le rapport. Lorsque vous choisissez d’ajouter d’autres sources, notez la différence significative entre les rapports qui utilisent et qui n’utilisent pas des sources personnalisées.
   • Un rapport qui n’utilise pas de sources personnalisées extrait des paramètres et des valeurs d’événement spécifiques à partir des données brutes de l'événement in-app.
   • Un rapport qui utilisedes sources personnalisées extrait des paramètres et des valeurs d'événements spécifiques des données brutes des événements in-app, puis fait correspondre ces données avec des données au niveau de l'utilisateur provenant de vos sources personnalisées (telles que les données de vos systèmes de BI ou de CRM).
2. Effectuez les étapes suivantes selon que votre rapport utilise ou non des sources personnalisées :
   • Si votre rapport n’utilise pas de sources personnalisées, passez à Sélectionner les dimensions, puis poursuivez ensuite les étapes dans tous les onglets restants.
   • Si votre rapport utilise des sources personnalisées, poursuivez les étapes de la section Joindre des sources (immédiatement après) et de tous les autres onglets.

Afin de faire correspondre les données entre les sources, chacune des sources personnalisées utilisées dans le rapport doivent inclure un identifiant mappé à un identifiant de clé dans les données d’événement in-app.

• Les rapports d’événements in-app comprennent tout les événements sélectionnés correspondant à l’identifiant de clé au cours de la période sélectionnée.

Qu’est-ce qu’un identifiant de clé ?

Vous pouvez mapper l’un de ces identifiants de données d’événement in-app en tant qu’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é si une app est supprimée puis réinstallée.
• ID utilisateur client (CUID) : un identifiant utilisateur unique généralement 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).

Schémas de mappage (direct/indirect)

Si le rapport comprend plusieurs sources personnalisées, une seule d’entre elles doit être mappée directement à un identifiant de clé d’événement in-app. D’autres sources personnalisées peuvent être mappées soit directement ou indirectement, comme illustré dans l’exemple suivant :

N’oubliez pas que les données au niveau de l’utilisateur ne peuvent pas être signalées par le DCR. Au lieu de cela, elles vous fournissent les informations décisionnelles dont vous avez besoin en agrégeant (ou en regroupant) les données selon les dimensions que vous choisissez.

Une dimension est généralement un attribut par lequel vous catégorisez les utilisateurs de l’app (par exemple, géo, date d’installation, campagne, etc.)

Extraction de dimensions à partir de event_value

Lorsque des événements in-app sont signalés à AppsFlyer via le SDK ou l’API S2S, une grande partie des données brutes est contenue dans un seul champ appelé event_value. Ce champ de données structurées inclut tous les paramètres d’événement in-app spécifiques qui ont été configurés pour les événements que vos apps envoient à AppsFlyer.

L’un des principaux avantages des rapports d’événements in-app est qu’ils vous permettent d’extraire des paramètres spécifiques et leurs valeurs de la event_value pour les événements que vous choisissez.

Pour extraire des dimensions du champ event_value à utiliser dans les rapports DCR :

1. Dans la liste Dimensions des sources, cliquez sur le bouton .

   La fenêtre Extraire le champ d’event_value s’ouvre.

2. Dans le Champ de rapport , entrez le nom de la dimension extraite tel que vous souhaitez qu’elle apparaisse dans votre rapport.
3. De la liste Event_value parameter, sélectionnez le paramètre d’événement in-app qui doit être mappé par défaut au champ de rapport (dimension) que vous avez défini à l’étape 2.
   • Les paramètres disponibles incluent ceux qui ont été configurés dans le événements in-app sélectionnés dans les apps sélectionnées.
4. Il se peut que le mappage par défaut diffère selon l’app et/ou l’événement. Si tel est le cas :
   1. Cliquez sur le bouton Ajouter une exception
   2. Sélectionnez l’app et l’événement pour lesquels le champ de rapport doit être mappé différemment.
   3. Sélectionnez le paramètre d’événement in-app qui doit être mappé au champ de rapport pour cette combinaison app/évènement.
   4. Suivez ces étapes pour autant d’exceptions que vous souhaitez configurer.
5. Lorsque vous avez terminé de configurer le mappage de la dimension extraite, cliquez sur Enregistrer et ajouter un autre pour extraire une autre dimension du champ event_value ou Sauvegarder pour revenir à l’écran principal.

Pour modifier les dimension extraites :

1. Dans les Dimensions des sources ou les Dimensions du rapport, passez la souris sur le nom de la dimension que vous souhaitez modifier.
2. Cliquez sur l’icône qui s’affiche à droite de la dimension.
3. Choisir Modifier le champ extrait.
4. Apportez des modifications au nom du Champ de rapport et/ou au mappage de paramètres si nécessaire.
5. Cliquez sur Sauvegarder pour enregistrer vos modifications.

Pour supprimer les dimensions extraites :

1. Dans les Dimensions des sources ou les Dimensions du rapport, passez la souris sur le nom de la dimension que vous souhaitez supprimer.
2. Cliquez sur l’icône qui s’affiche à droite de la dimension.
3. Choisissez Supprimer le champ.
   • Attention ! Si vous supprimez un champ extrait de la Dimensions du rapport, cela supprimera la définition du champ extrait. Si vous souhaitez supprimer le champ du rapport tout en conservant sa définition, sélectionnez-le et utilisez le bouton Enlever à la place.

Sélection des dimensions d’un rapport

Les dimensions du rapport d’événement in-app peuvent inclure :

• Les dimensions que vous avez extraites de event_value
• Les dimensions d’événement in-app par défaut
• Tout champ des sources personnalisées de l’état qui a été catégorisé en tant que dimension (le cas échéant)

Pour sélectionner les dimensions à inclure dans votre rapport :

1. Sélectionnez une ou plusieurs dimensions dans les 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 rechercher des dimensions dans les listes.
2. Pour supprimer une dimension, sélectionnez-la dans les dimensions du rapport et utilisez la fonction Supprimer pour la renvoyer à la liste des dimensions des sources.
3. Répétez ce processus 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 d’événement in-app media_source. Si vous ne souhaitez pas utiliser cette dimension dans votre rapport, vous pouvez la supprimer de la liste des dimensions du rapport.

[Facultatif] Personnalisation des noms d’affichage des dimensions

Par défaut, les noms des dimensions s’affichent dans votre rapport exactement comme ils sont nommés dans les données d’événement in-app ou dans vos sources personnalisées. Si vous le souhaitez, vous pouvez personnaliser les noms de dimension de votre rapport.

Pour personnaliser les noms d’affichage des dimensions :

1. Dans la liste des dimensions du rapport, passez la souris sur le nom de la dimension dont vous souhaitez modifier le nom d’affichage.
2. Cliquez sur le bouton de modification qui s’affiche à droite de la dimension.
3. Remplacez le nom par le nom d’affichage de la dimension à utiliser dans votre rapport (jusqu’à 50 caractères).
4. Cliquez sur OK pour enregistrer le nom d’affichage, ou X pour l’annuler.

Remarque : Si vous souhaitez changer le nom d’une dimension extraite, suivez les étapes de modification des dimensions extraites (ci-dessus).

Préservation de la confidentialité lors du regroupement par dimension (regroupement)

En fonction de la taille de votre ensemble de données, du nombre de dimensions que vous choisissez et d’autres facteurs, il est possible qu’un rapport comprenne un ou plusieurs groupes contenant trop peu d’utilisateurs pour permettre la création de rapports. Si les données étaient déclarées de cette façon, cela enfreindrait les restrictions contre la fourniture de données au niveau de l’utilisateur.

Toutefois, au lieu de supprimer ou de masquer complètement les données du rapport, le DCR utilise un mécanisme de regroupement pour fournir autant de détails que possible tout en préservant la confidentialité de l’utilisateur.

[Facultatif] Gestion de la priorité de dimension

Par défaut, les dimensions d’événement in-app sont éliminées dans l’ordre inverse de l’ordre dans lequel elles apparaissent 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 (le cas échéant) afin de conserver les dimensions les plus importantes pour vous.

Pour modifier l’ordre dans lequel les dimensions sont éliminées :

1. Cliquez sur le bouton Gérer la priorité des dimensions.
2. Sélectionnez une dimension et faites-la glisser à l’emplacement souhaité dans la liste (ou utilisez les boutons fléchés à droite pour la déplacer).
   • La dimension étiquetée comme Priorité (en haut de la liste) signifie qu’elle sera la dernière à être éliminée si un regroupement est nécessaire.
3. [Facultatif] Pour appliquer le regroupement aux dimensions de source personnalisées (pour les rapports utilisant des sources personnalisées) :
   1. Cliquez sur Utiliser les options avancées pour affiner le regroupement
   2. Sélectionnez les dimensions source personnalisées auxquelles vous souhaitez appliquer le regroupement.
   3. 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, comme Priorité la plus basse pour le regroupement. Toutefois, vous pouvez les réorganiser comme les dimensions d’événement in-app, comme décrit ci-dessus.
4. Cliquez sur OK pour enregistrer vos modifications.
   • La liste des dimensions du rapport sur l’écran principal reste dans son ordre d’origine, mais l’ordre révisé a été enregistré. (Cliquez à nouveau sur le bouton Gérer la priorité des dimensions si vous souhaitez revoir ou modifier votre sélection.)

Les métriques sont les données numériques que vous avez collectées concernant un utilisateur d’app (par exemple, le chiffre d’affaires, le nombre d’ouvertures d’apps, la LTV, etc.) et peuvent être n’importe quel champ de données numériques de vos sources que vous avez classé en tant que métrique.

Extraction de métriques à partir de event_value

Tout comme vous pouvez le faire pour Dimensions du rapport, vous pouvez extraire les paramètres d’événement in-app à partir du champ event_value pour les utiliser comme mesures dans vos rapports.

Pour extraire des dimensions du champ event_value à utiliser dans les rapports DCR :

1. Dans la liste Métriques provenant des sources, cliquez sur le bouton bouton.

   La fenêtre Extraire le champ d’event_value s’ouvre.

2. Dans le Champ de rapport, entrez le nom de la mesure extraite tel que vous souhaitez qu’elle apparaisse dans votre rapport.
3. Dans la liste Event_value parameter, sélectionnez le paramètre d’événement in-app qui doit être mappé par défaut au champ de rapport (métrique) que vous avez défini à l’étape 2.
   • Les paramètres disponibles incluent ceux qui ont été configurés dans les événements in-app sélectionnés dans les apps sélectionnées.
4. Il se peut que le mappage par défaut diffère selon l’app et/ou l’événement. Si tel est le cas :
   1. Cliquez sur le bouton Ajouter une exception
   2. Sélectionnez l’app et l’événement pour lesquels le champ de rapport doit être mappé différemment.
   3. Sélectionnez le paramètre d’événement in-app qui doit être mappé au champ de rapport pour cette combinaison app/évènement.
   4. Suivez ces étapes pour autant d’exceptions que vous souhaitez configurer.
5. Lorsque vous avez terminé de configurer le mappage de la métrique extraite, cliquez sur Enregistrer et ajouter autre pour extraire une autre métrique du champ event_value ou Sauvegarder pour revenir à l’écran principal.

Pour modifier les métriques extraites :

1. Dans la liste Métriques des sources ouMétriques du rapport, passez la souris sur le nom de la dimension que vous souhaitez modifier.
2. Cliquez sur l’icône qui s’affiche à droite de la métrique.
3. Choisir Modifier le champ extrait.
4. Apportez des modifications au nom du Champ de rapport et/ou au mappage de paramètres si nécessaire.
5. Cliquez sur Sauvegarder pour enregistrer vos modifications.

Pour supprimer les métriques extraites :

1. Dans la liste Métriques des sources ou Métriques du rapport, passez la souris sur le nom de la métrique que vous souhaitez supprimer.
2. Cliquez sur l’icône qui s’affiche à droite de la métrique.
3. Choisissez Supprimer le champ.
   • Attention ! Si vous supprimez un champ extrait de la liste des métriques du rapport, cela supprimera la définition du champ extrait. Si vous souhaitez supprimer le champ du rapport tout en conservant sa définition, sélectionnez-le et utilisez le bouton Supprimer à la place.

Sélectionner les statistiques du rapport

Pour sélectionner les statistiques à inclure dans votre rapport :

1. 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 rechercher des statistiques dans les listes.
2. Pour chaque métrique de la liste Métriques du rapport, indiquez si vous souhaitez que les données soient signalées comme suit :
   • une somme de valeurs numériques ; ou
   • un décompte de valeurs distinctes
3. Pour supprimer une métrique, sélectionnez-la dans la liste Statistiques du rapport et utilisez la fonction Supprimer pour la renvoyer à la liste Métriques provenant des sources.
4. Répétez ce processus jusqu’à ce que vous ayez ajouté chaque mesure que vous souhaitez inclure dans le rapport.

[Facultatif] Personnalisation des noms d’affichage des métriques

Par défaut, les noms des métriques s’affichent dans votre rapport exactement comme ils sont nommés dans les données d’événement in-app ou dans vos sources personnalisées. Si vous le souhaitez, vous pouvez personnaliser les noms des métriques de votre rapport.

Pour personnaliser les noms d’affichage des métriques :

1. Dans la liste Métriques du rapport, passez la souris sur le nom de la métrique dont vous souhaitez modifier le nom d’affichage.
2. Cliquez sur le bouton de modification qui s’affiche à droite de la métrique.
3. Remplacez le nom par le nom d’affichage de la métrique à utiliser dans votre rapport (jusqu’à 50 caractères).
4. Cliquez sur OK pour enregistrer le nom d’affichage, ou X pour l’annuler.

Remarque : Si vous souhaitez changer le nom d’une métrique extraite, suivez les étapes de modification des métriques extraites (ci-dessus).

[Facultatif] Sélectionnez les identifiants à compter

Par défaut, chaque ligne du rapport se termine par une colonne contenant le nombre d’ID AppsFlyer distincts regroupés dans les données de cette ligne.

Si vous souhaitez ajouter des colonnes pour les nombres distincts d’autres identifiants de vos sources, procédez comme suit :

1. Sélectionnez un ou plusieurs identifiants dans la section Identifiants provenant des sources sur la gauche et utilisez le bouton Ajouter au milieu de l’écran pour les ajouter à la liste des Identifiants de comptage distincts.
   • Vous pouvez utiliser la barre de recherche pour rechercher des identifiants dans les listes.
2. Pour supprimer un identifiant, sélectionnez-le dans la section identifiants de comptage distinctset utilisez la fonction Supprimer pour le renvoyer à la liste des identifiants provenant des sources.
3. Répétez ce processus jusqu’à ce que vous ayez ajouté chaque identifiant que vous souhaitez comptabiliser dans le rapport.

Planification (uniquement pour les rapports sans sources personnalisées)

Les rapports sans sources personnalisées sont exécutés selon la planification que vous définissez.

Pour définir la planification du rapport :

1. Indiquez si vous souhaitez exécuter le rapport quotidiennement ou un ou plusieurs jours par semaine.
2. Sélectionnez l’heure à laquelle vous souhaitez exécuter le rapport (le fuseau horaire est UTC).

Destination du rapport

Le DCR fournit des rapports aux services cloud que vous avez sélectionnés à l’aide de Data Locker AppsFlyer. Par conséquent, la spécification de la destination du rapport implique la sélection ou la création d’une connexion Data Locker.

• Remarque : La réception de rapports 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 du rapport et l’enregistrer :

1. Sélectionnez dans la liste des connexions Data Locker disponibles dans votre compte AppsFlyer.
   • Si aucune connexion n’est définie 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. Suivez 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. Suivez ces instructions pour créer la connexion.
   • Après avoir créé la connexion, revenez à l’onglet DCR de votre navigateur et sélectionnez la connexion nouvellement créée dans la liste des connexions Data Locker.
2. Cliquez sur Sauvegarder pour enregistrer le rapport.
3. Le nouveau rapport s’affiche maintenant dans l’onglet Rapports de la Data Clean Room.

En plus des dimensions extraites de event_value et de vos sources personnalisées (le cas échéant), les dimensions d’événement in-app suivantes peuvent être utilisées pour regrouper des rapports :

• media_source (inclus en tant que dimension de rapport par défaut)
• publicité
• ad_id
• ad_type
• adset_id
• adset_name
• app_id
• app_version
• attributed_touch_type
• marque
• campagne
• campaign_id
• canal
• ville
• conversion_type
• country
• device_type
• dma
• Type d’engagement
• event_name
• event_revenue_currency
• geo_region
• is_attributed
• Mots-clés
• match_type
• modèle
• partenaire
• platform
• site_id

En plus des métriques extraites de event_value et des métriques provenant de vos sources personnalisées (le cas échéant), les métriques d’événement in-app suivantes peuvent être incluses dans les rapports :

• event_revenue
• event_revenue_u_s_d