Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Inspecter les données de personnalisation avec BigQuery

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

La personnalisation de Remote Config consigne un événement Analytics personalization_assignment lorsqu'une personnalisation est attribuée à un utilisateur, ce qui vous permet d'utiliser BigQuery pour inspecter et analyser les événements de personnalisation et les événements associés.

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'exportation BigQuery pour Google Analytics pour Firebase

Si vous avez souscrit au forfait Spark, vous pouvez utiliser le bac à sable BigQuery pour accéder gratuitement à BigQuery, sous réserve des limites du bac à sable . Consultez Tarification et bac à sable BigQuery pour plus d'informations.

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 des > 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 Lien .
  3. Consultez À propos de l'association de Firebase à BigQuery , puis cliquez sur Suivant .
  4. Dans la section Configurer l'intégration , activez la bascule Google Analytics .
  5. Sélectionnez une région et choisissez les paramètres d'exportation.

  6. Cliquez sur Associer à BigQuery .

Selon la manière dont vous avez choisi d'exporter les données, il peut s'écouler jusqu'à un jour avant que les tables ne soient disponibles. Pour plus d'informations sur l'exportation de données de projet vers BigQuery, consultez Exporter des données de projet vers BigQuery .

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

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

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

  1. Ouvrez BigQuery dans Google Cloud Console . Vous pouvez également l'ouvrir directement à partir d' Analytics Events à 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_ .

    Access personalization events in the Cloud console

  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 pour sélectionner les événements de personalization_assignment . L'exemple de requête suivant renverra un événement d'affectation de personnalisation complet pour une partition 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 effectuer une recherche 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_* ). Ceci n'est pas recommandé dans les scénarios de non-test ou pour les ensembles de données volumineux.

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

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

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

Les données de personnalisation sont incluses dans les tables Google Analytics dans 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 pour tout événement Analytics, comme décrit dans [GA4] Schéma d'exportation BigQuery . Vous serez principalement concerné par user_pseudo_id i (qui peut être utilisé pour différencier des utilisateurs distincts), les horodatages d'é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 La description
ID_personnalisation CHAÎNE Fournit l'identifiant universel unique (UUID) de la personnalisation attribuée.
groupe CHAÎNE Indique si l'utilisateur a été affecté au groupe de personnalisation (P13N) ou au groupe de référence (BASELINE).
arm_index ENTIER Représente la valeur alternative attribuée à l'utilisateur, un entier compris entre 0 et 4.
arm_key CHAÎNE Contient le nom du paramètre utilisé par la personnalisation.
arm_value CHAÎNE Contient la chaîne de valeur alternative affectée par la personnalisation.
engagé_session_event ENTIER Inclut le nombre de sessions dans lesquelles l'utilisateur est engagé. Voir À propos des sessions pour plus d'informations.
firebase_event_origin CHAÎNE Indique l'origine de l'événement. Ce sera toujours fp pour les événements de personalization_assignment .
firebase_screen_class CHAÎNE Fournit le nom de classe de l'écran sur lequel l'utilisateur était actif lorsque l'affectation de personnalisation s'est produite. Voir Événements collectés automatiquement pour plus d'informations.
firebase_screen_id ENTIER Affiche l'ID de l'écran sur lequel se trouvait l'utilisateur lorsque l'affectation de personnalisation s'est produite. Voir Événements collectés automatiquement pour plus d'informations.
first_open_time CHAÎNE Fournit l'horodatage, en millisecondes UTC, de la première ouverture de l'application par l'utilisateur. Voir Événements collectés automatiquement pour plus d'informations.
ga_session_id ENTIER Fournit l'ID de session Google Analytics. Voir À propos des sessions pour plus d'informations. Vous pouvez l'utiliser pour corréler l'événement personalization_assignment avec d'autres événements Analytics.
ga_session_number ENTIER Fournit le numéro de session Google Analytics. Voir À propos des sessions pour plus d'informations.

Exemples de requêtes

Vous pouvez utiliser une instruction SQL comme celle-ci pour extraire les paramètres spécifiques à la personalization_assignment é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