Inspecter les données de personnalisation avec BigQuery

La personnalisation Remote Config consigne 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.

Remarque :Vous pouvez également afficher les événements personalization_assignment sur la page Firebase Analytics Événements et un graphique détaillé des résultats sur la page Résultats de personnalisation Remote Config.

Les sections suivantes expliquent 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 à vous lancer.

Activer l'exportation BigQuery pour Google Analytics pour Firebase

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

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

1. Ouvrez l'onglet Intégrations, auquel vous pouvez accéder à l'aide de > Paramètres du projet dans la console Firebase.
2. Si vous utilisez déjà BigQuery avec d'autres services Firebase, cliquez sur Gérer. Sinon, cliquez sur Associer.
3. Consultez À propos de l'association de Firebase à BigQuery, puis cliquez sur Suivant.
4. Dans la section Configurer l'intégration, activez l'option Google Analytics.

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

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

6. Cliquez sur Associer à BigQuery.

Selon la méthode choisie pour exporter les données, l'accès aux tableaux peut prendre jusqu'à une journée. Pour en savoir plus sur l'exportation des données de projet vers BigQuery, consultez Exporter les données de projet vers BigQuery.

Accédons ensuite à nos événements de personnalisation dans BigQuery et examinons-les.

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

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

1. Ouvrez BigQuery dans la console Google Cloud. Vous pouvez également l'ouvrir directement depuis Analytics Événements à l'aide du lien Afficher vos événements bruts dans BigQuery en bas de la page.

2. Sélectionnez votre projet Firebase et développez-le, puis développez l'entrée analytics_ANALYTICS_PROPERTY_ID 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, modifiez la requête pour sélectionner les événements personalization_assignment. L'exemple de requête suivant renvoie un événement d'attribution de personnalisation complet pour un segment 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 partitionné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 opération 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 Run query (Exécuter la requête). Les résultats s'affichent dans le volet inférieur.

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

Dans la section suivante, nous verrons 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 tables Google Analytics de BigQuery et stockées dans les événements personalization_assignment.

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

Les informations spécifiques à la personnalisation sont stockées dans le champ event_params et sont décrites 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.
groupe	STRING	Indique si l'utilisateur a été affecté 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	Indique le nom du paramètre utilisé par la personnalisation.
arm_value	STRING	Inclut la chaîne de valeur alternative attribuée par la personnalisation.
engaged_session_event	INTEGER	Inclut le nombre de sessions auxquelles l'utilisateur participe. Pour en savoir plus, consultez la section À propos des sessions.
firebase_event_origin	STRING	Indique l'origine de l'événement. Cette valeur est toujours fp pour les événements personalization_assignment.
firebase_screen_class	STRING	Indique le nom de classe de l'écran sur lequel l'utilisateur était actif au moment de l'attribution de la personnalisation. Pour en savoir plus, consultez la section Événements collectés automatiquement.
firebase_screen_id	INTEGER	Indique l'ID de l'écran sur lequel l'utilisateur se trouvait au moment de l'attribution de la personnalisation. Pour en savoir plus, consultez la section Événements collectés automatiquement.
first_open_time	STRING	Indique le code temporel, en millisecondes UTC, de la première fois que l'utilisateur a ouvert l'application. Pour en savoir plus, consultez la section Événements collectés automatiquement.
ga_session_id	INTEGER	Fournit l'ID de session Google Analytics. Pour en savoir plus, consultez la section À propos des sessions. Vous pouvez l'utiliser pour mettre en corrélation l'événement personalization_assignment avec d'autres événements Analytics.
ga_session_number	INTEGER	Indique le numéro de session Google Analytics. Pour en savoir plus, consultez la section À 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