Inspecter les données de personnalisation avec BigQuery

Remote Config la personnalisation enregistre un événement personalization_assignment Analytics lorsqu'une personnalisation est attribuée à un utilisateur. Vous pouvez ainsi utiliser BigQuery pour inspecter et analyser les événements de personnalisation et les événements associés.

Conseil Dans la console Firebase, vous pouvez également afficher les événements personalization_assignment dans le tableau de bord Analytics > Événements et consulter un graphique détaillé des résultats sur la page des résultats de la personnalisation.

Les sections suivantes décrivent comment activer l'exportation BigQuery pour les événements Analytics, comment les événements de personnalisation sont stockés et fournissent quelques requêtes de base pour vous aider à démarrer.

Activer l'BigQuery exportation pour Google Analytics pour Firebase

Si vous disposez du forfait Spark, vous pouvez utiliser le BigQuery bac à sable pour accéder BigQuery sans frais, sous réserve des limites du bac à sable. Pour en savoir plus, consultez Tarifs et bac à sable BigQuery.

Tout d'abord, assurez-vous d'exporter vos données Analytics vers BigQuery :

1. Dans la console Firebase, accédez à Paramètres > Intégrations.

2. Sur la fiche BigQuery, cliquez sur Associer. Si vous utilisez déjà BigQuery avec d'autres services Firebase, cliquez sur Gérer.

3. Consultez À propos de l'association de Firebase à BigQuery, puis cliquez sur Suivant.

4. Dans la section Configurer l'intégration, activez le Google Analytics bouton.

5. Sélectionnez une région et choisissez les paramètres d'exportation.

   Remarque : Pour en savoir plus sur les paramètres Google Analytics, consultez Collecte de données.

6. Cliquez sur Associer à BigQuery.

Selon la méthode d'exportation des données choisie, les tables peuvent mettre jusqu'à un jour à être disponibles. Pour en savoir plus sur l'exportation des données de projet vers BigQuery, consultez Exporter les données d'un projet vers BigQuery.

Ensuite, accédons à nos événements de personnalisation dans BigQuery et inspectons-les.

Accéder aux données de personnalisation Remote Config à l'aide de BigQuery

Pour interroger les données Analytics d'un test :

1. Ouvrez BigQuery dans la Google Cloud console. Vous pouvez également ouvrir BigQuery directement depuis la console Firebase en accédant au tableau de bord Analytics > Événements et en cliquant sur le lien Afficher vos événements bruts dans BigQuery en bas de la page.

2. Sélectionnez votre Firebase projet et développez-le, puis développez l' analytics_ANALYTICS_PROPERTY_ID entrée et cliquez sur events_.

   

3. Dans le menu déroulant Requête, sélectionnez Dans un nouvel onglet.

   Un exemple de requête généré automatiquement s'affiche.

4. Pour afficher les événements de personnalisation et les données associées, mettez à jour la requête afin de sélectionner les événements personalization_assignment. L'exemple de requête suivant renvoie un événement d'attribution de personnalisation complet pour un fragment de date spécifique, en limitant les résultats à 10 :

   # Select all personalization_assignment events
   SELECT *
   FROM `PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_DATE_SHARD`
   WHERE event_name = 'personalization_assignment'
   LIMIT 10
   

   Conseil : Pour rechercher dans toutes les tables d'événements au lieu de la table fragmentée, vous pouvez remplacer la date de la table d'événements par un astérisque (par exemple, PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_*). Cette approche n'est pas recommandée dans les scénarios autres que les tests ni pour les ensembles de données volumineux.

5. Dans l'éditeur de requête, sélectionnez Exécuter la requête. Les résultats s'affichent dans le volet inférieur.

Remarque : Si vous ne diffusez pas en streaming les données Analytics, les données Firebase dans BigQuery ne sont mises à jour qu'une fois par jour. Par conséquent, les données disponibles sur la page du test peuvent être plus récentes que celles disponibles dans la BigQuery console.

Dans la section suivante, nous allons examiner plus en détail ce qui est inclus dans un événement d'attribution de personnalisation.

Quelles données de personnalisation sont exportées vers BigQuery ?

Les données de personnalisation sont incluses dans les Google Analytics tables dans BigQuery et stockées dans les personalization_assignment événements.

Les champs de base fournis dans un événement de personnalisation sont les mêmes que ceux de n'importe quel Analytics événement, comme décrit dans [GA4] BigQuery schéma d'exportation. Vous vous intéresserez principalement à user_pseudo_id(qui peut être utilisé pour différencier les utilisateurs distincts), aux codes temporels des événements et à d'autres propriétés utilisateur.

Les détails spécifiques à la personnalisation sont stockés dans le champ event_params et sont décrits dans le tableau suivant :

Paramètre	Type de données	Description
personalization_id	STRING	Fournit l'identifiant unique universel (UUID) de la personnalisation attribuée.
group	STRING	Indique si l'utilisateur a été attribué au groupe de personnalisation (P13N) ou au groupe de référence (BASELINE).
arm_index	INTEGER	Représente la valeur alternative attribuée à l'utilisateur, un entier compris entre 0 et 4.
arm_key	STRING	Contient le nom du paramètre utilisé par la personnalisation.
arm_value	STRING	Contient la chaîne de valeur alternative attribuée par la personnalisation.
engaged_session_event	INTEGER	Inclut le nombre de sessions dans lesquelles l'utilisateur est engagé. Pour en savoir plus, consultez À propos des sessions.
firebase_event_origin	STRING	Indique l'origine de l'événement. Il s'agira toujours de fp pour les événements personalization_assignment.
firebase_screen_class	STRING	Fournit le nom de classe de l'écran sur lequel l'utilisateur était actif lorsque l'attribution de la personnalisation a eu lieu. Pour en savoir plus, consultez Événements collectés automatiquement.
firebase_screen_id	INTEGER	Affiche l'ID de l'écran sur lequel l'utilisateur se trouvait lorsque l'attribution de la personnalisation a eu lieu. Pour en savoir plus, consultez Événements collectés automatiquement.
first_open_time	STRING	Fournit le code temporel, en millisecondes UTC, de la première fois que l'utilisateur a ouvert l'application. Pour en savoir plus, consultez Événements collectés automatiquement.
ga_session_id	INTEGER	Fournit l'ID de session Google Analytics. Pour en savoir plus, consultez À propos des sessions. Vous pouvez l'utiliser pour corréler l'événement personalization_assignment avec d'autres Analytics événements.
ga_session_number	INTEGER	Fournit le numéro de session Google Analytics. Pour en savoir plus, consultez À propos des sessions.

Exemples de requêtes

Vous pouvez utiliser une instruction SQL comme celle-ci pour extraire les paramètres spécifiques à la personnalisation des événements personalization_assignment :

    # Expand nested personalization parameters
    SELECT
     timestamp_micros(event_timestamp) AS event_time,
     user_pseudo_id,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'group'
     ) AS personalization_group,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'personalization_id'
     ) AS personalization_id,
     (
       SELECT event_params.value.string_value,
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_key'
     ) AS arm_key,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_value'
     ) AS arm_value,
     (
       SELECT event_params.value.int_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'ga_session_id'
     ) AS ga_session_id,
    FROM `PROJECT_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10