Exporter vos métriques d'analyse vers BigQuery

Cette page explique comment exporter les métriques d'analyse Vertex AI Search pour le commerce vers BigQuery. L'exportation des métriques d'analyse vous permet de les conserver et d'écrire du code SQL pour votre propre analyse.

Les métriques d'analyse Vertex AI Search pour le commerce sont générées automatiquement pour vous. Pour en savoir plus sur la mesure de l'impact commercial de Vertex AI Search pour le commerce à l'aide de métriques d'analyse, consultez Afficher les données analytiques.

L'exportation de données de métriques vers BigQuery est soumise aux limites suivantes :

  • Les données exportées vers les tables BigQuery de votre projet Vertex AI Search pour le commerce sont des vues autorisées, et non des vues matérialisées.

  • Vous ne pouvez pas modifier ni mettre à jour les données de ces tables. Si vous devez modifier ou mettre à jour vos données, exportez ou copiez la vue vers une autre destination.

  • Vous ne pouvez pas exporter les métriques pour les événements utilisateur datant de plus de 180 jours ni les métriques générées il y a plus de 180 jours. Il n'est pas possible de récupérer les métriques générées avant cette période de 180 jours.

Avant de commencer

Avant de pouvoir exporter vos métriques dans BigQuery, vous devez avoir suivi les procédures décrites dans Avant de commencer. Cela inclut l'importation de vos événements utilisateur et, éventuellement, des informations de votre catalogue.

Pour en savoir plus sur l'importation, consultez les ressources suivantes :

Créer un ensemble de données dans BigQuery

Vous devez créer un ensemble de données dans BigQuery pour stocker vos données de métriques Analytics.

Vous devez créer les ensembles de données dans le même projet que celui dans lequel vous avez implémenté Vertex AI Search pour le commerce.

  1. Si vous n'avez jamais utilisé BigQuery dans votre projet, activez l'API BigQuery et assurez-vous de disposer du rôle IAM qui vous permet de créer des ensembles de données et des tables.

    Consultez Avant de commencer et Contrôle des accès avec IAM.

    dans la documentation BigQuery.

  2. Créez un ensemble de données dans BigQuery dans la zone multirégionale US (plusieurs régions aux États-Unis). Par exemple, nommez-le retail_data. Si vous créez votre ensemble de données dans une autre région, l'exportation de vos données vers BigQuery échouera. Le CMEK pour l'ensemble de données n'est pas compatible. Si vous l'activez, l'exportation échouera.

    Pour savoir comment créer un ensemble de données, consultez Créer des ensembles de données dans la documentation BigQuery.

    Cet ensemble de données servira à stocker les tables de données que vous exportez. Les procédures suivantes décrivent comment exporter des données.

Exporter vos métriques Analytics vers une table BigQuery

Utilisez la méthode exportAnalyticsMetrics pour exporter votre catalogue Retail dans une table BigQuery.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet d'API Vertex AI Search for Commerce dans lequel vous avez créé l'ensemble de données BigQuery.
  • DATASET_ID : nom de l'ensemble de données que vous avez créé dans Créer un ensemble de données dans BigQuery. Par exemple, utilisez retail_data ou retail_metrics_data.
  • TABLE_ID_PREFIX : préfixe de l'ID de la table. Ce préfixe ne peut pas être une chaîne vide. Un suffixe retail_analytics_metrics est ajouté pour compléter le nom de la table. Par exemple, si le préfixe est test, la table est nommée test_retail_analytics_metrics.

Corps JSON de la requête :

{
  "catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
  "outputConfig":
  {
    "bigqueryDestination":
    {
      "datasetId": "DATASET_ID",
        "tableIdPrefix": "TABLE_ID_PREFIX",
        "tableType": "view"
    }
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/12310973052792775280",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2.ExportAnalyticsMetricsResponse",
    "outputResult": {
      "bigqueryResult": [
        {
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID_PREFIX_retail_analytics_metrics"
        }
      ]
    }
  }
}

Définitions des métriques

Les métriques exportées sont des métriques de nombre. Il peut y avoir une légère dérive pour certaines métriques de nombre, car le filtrage des robots peut exclure certains événements du calcul des métriques. Le filtrage des robots peut vous aider à obtenir des mesures de performances plus précises. Cela n'affecte pas les tests A/B, qui dépendent de la dimension external_experiment_ids, alors que le filtrage des robots s'applique à l'ensemble du trafic.

Dimensions des métriques

Les métriques de nombre sont les nombres bruts directement agrégés à partir des événements utilisateur pertinents avec les mêmes dimensions. Pour interpréter les métriques, vous devez connaître les dimensions sur lesquelles elles sont basées. Pour les métriques Analytics, les événements de recherche et de navigation sont appelés événements d'impression, et les événements detail_page_view, add_to_cart et purchase sont appelés événements de conversion. Le tableau suivant définit les dimensions des métriques.

Dimension de métrique Description
date

Date de l'événement ou des événements pertinents ayant généré les métriques.

Pour les métriques d'impression, il s'agit de la date des événements d'impression.

Pour les métriques sur les sessions et les visiteurs, il s'agit de la date du premier événement d'impression de la session/du visiteur.
external_experiment_ids

ID des tests de l'événement ou des événements concernés ayant généré les métriques.

Pour les métriques d'impression, il s'agit de l'ID de test de l'événement d'impression.

Pour les métriques de session et de visiteur, il s'agit de la concaténation des ID externes uniques de tous les événements d'impression qui apparaissent dans la session/le visiteur. Par exemple, si une session/un visiteur comporte deux événements de recherche, que le premier événement de recherche a pour external_experiment_ids "test_arm_1,test_arm_2" et que le deuxième événement de recherche a pour external_experiment_ids "test_arm_1,test_arm_3", alors external_experiment_ids de la session/du visiteur est "test_arm_1,test_arm_2,test_arm_3".
device_type

Type d'appareil de l'événement ou des événements concernés ayant généré les métriques(par exemple, si l'événement est généré à partir d'un appareil mobile ou d'un ordinateur).

Pour les métriques d'impression, il s'agit du type d'appareil de l'événement d'impression.

Pour les métriques sur les sessions et les visiteurs, cette dimension est vide si la session/le visiteur comporte plusieurs types d'appareils distincts, ou elle est définie sur "1" s'il n'y a qu'un seul type d'appareil pour l'ensemble de la session/du visiteur.
serving_config

Configuration de diffusion des événements concernés ayant généré les métriques.

Pour les métriques d'impression, il s'agit de la configuration de diffusion de l'événement d'impression.

Pour les métriques de session et de visiteur, cette valeur est vide si la session/le visiteur comporte plusieurs configurations de diffusion distinctes, ou égale à 1 s'il n'y a qu'une seule configuration de diffusion pour l'ensemble de la session/du visiteur.
traffic_destination

Source des événements pertinents ayant généré les métriques.

Pour les métriques d'impression, la valeur est "Google" si l'impression est diffusée par Google ou "Non Google" si elle est diffusée par votre propre solution.

Pour les métriques sur les sessions et les visiteurs, la valeur est "Mixte" si la session/le visiteur a vu des événements d'impression diffusés à la fois par Google et par votre propre solution. Indiquez "Google" si les événements d'impression sont uniquement diffusés par Google ou "Non-Google" si les événements d'impression sont uniquement diffusés par votre solution pour l'ensemble de la session/du visiteur.
entité

Il est utilisé par les marchands qui proposent plusieurs sites ou régions de marque avec un seul catalogue de produits. Une entité représente généralement des marques ou des lieux.

Pour les métriques d'impression, il s'agit de l'entité de l'événement d'impression.

Pour les métriques sur les sessions et les visiteurs, il s'agit des cinq premières entités comptabilisées des événements d'impression pour la session/le visiteur.

Métriques sur les impressions

Les métriques d'impression sont calculées en fonction des conditions requises. Les événements de conversion (événements detail_page_view, add_to_cart et purchase) ne peuvent être attribués à un événement d'impression que s'ils répondent aux critères suivants.

  • L'événement d'impression et l'événement de conversion concernent le même visiteur.

  • L'ID produit de l'événement de conversion doit figurer dans les résultats de l'événement d'impression.

  • L'événement de conversion se trouve dans la période requise après l'événement d'impression. Différentes périodes de suivi des conversions s'appliquent à différents types d'événements de conversion.

    Chemin de conversion Période de suivi des conversions
    Impression > Affichage de la page d'informations 60 secondes
    Impression > Ajout au panier 24 heures
    Impression > Achat 48 heures

Métriques sur les impressions sur le Réseau de Recherche

Nom de la métrique Description
search_event Nombre d'événements de recherche
detail_page_view_from_search Nombre d'événements "Affichage de la page des détails" provenant de la recherche
add_to_cart_unit_from_search Nombre d'ajouts au panier depuis la recherche
purchase_unit_from_search Nombre d'unités achetées à partir de la recherche
revenue_from_search Revenus issus de la recherche
search_event_without_result Nombre d'événements de recherche n'ayant généré aucun résultat
search_request_personalization_enabled Nombre de requêtes de recherche pour lesquelles la personnalisation est activée
search_request_personalization_result_served Nombre de requêtes de recherche pour lesquelles des résultats personnalisés sont fournis

Parcourir les métriques d'impression

Nom de la métrique Description
browse_event Parcourir le nombre d'événements
detail_page_view_from_browse Nombre d'événements "Affichage de la page des détails" depuis la navigation
add_to_cart_unit_from_browse Nombre d'unités ajoutées au panier depuis la navigation
purchase_unit_from_browse Nombre d'unités achetées depuis la navigation
revenue_from_browse Revenus générés par la navigation
browse_event_without_result Parcourir le nombre d'événements sans obtenir de résultats
browse_request_personalization_enabled Nombre de requêtes de navigation avec la personnalisation activée
browse_request_personalization_result_served Nombre de requêtes de navigation pour lesquelles des résultats personnalisés sont diffusés

Métriques de session

Une session est définie comme une période d'interaction continue entre un utilisateur et le système. Tout événement utilisateur marque le début d'une session. La fin d'une session est marquée lorsqu'aucun autre événement ne se produit pendant les 30 minutes suivantes. La session est prolongée de 30 minutes chaque fois qu'un événement utilisateur se produit dans une session démarrée. Lorsqu'une session se termine, une nouvelle commence lorsque l'utilisateur interagit à nouveau avec le système.

Les dimensions qui caractérisent les métriques de session sont définies conjointement par tous les événements utilisateur de la session. Consultez Métriques et dimensions pour savoir comment définir les valeurs de dimension pour la session.

Nom de la métrique Description
session Nombre de sessions

Métriques sur les sessions de recherche

Une session de recherche est une session qui contient au moins un événement de recherche. Notez qu'une session de recherche peut également être une session de navigation, comme défini par les métriques de session de navigation.

Nom de la métrique Description
search_session Nombre de sessions incluant une recherche
search_event_in_search_session Nombre d'événements de recherche dans les sessions de recherche
browse_event_in_search_session Parcourir le nombre d'événements dans les sessions de recherche
detail_page_view_in_search_session Nombre de vues de la page d'informations dans les sessions de recherche
add_to_cart_in_search_session Nombre d'événements "Ajouter au panier" dans les sessions de recherche
add_to_cart_unit_in_search_session Nombre d'ajouts au panier dans les sessions de recherche
purchase_order_in_search_session Nombre de bons de commande dans les sessions de recherche
purchase_unit_in_search_session Nombre d'unités achetées lors des sessions de recherche
revenue_in_search_session Revenus générés par les sessions de recherche
bounce_count_in_search_session Nombre de sessions des visiteurs qui quittent le site après avoir consulté une seule page au cours des sessions de recherche

Parcourir les métriques de session

Une session de navigation est une session qui contient au moins un événement de navigation. Notez qu'une session de navigation peut également être une session de recherche, comme défini par les métriques sur les sessions de recherche.

Nom de la métrique Description
browse_session Nombre de sessions impliquant la navigation
search_event_in_browse_session Nombre d'événements de recherche dans les sessions de navigation
browse_event_in_browse_session Parcourir le nombre d'événements dans les sessions de navigation
detail_page_view_in_browse_session Nombre de vues de la page d'informations dans les sessions de navigation
add_to_cart_in_browse_session Nombre d'événements "Ajouter au panier" dans les sessions de navigation
add_to_cart_unit_in_browse_session Nombre d'unités ajoutées au panier lors des sessions de navigation
purchase_order_in_browse_session Nombre de bons de commande dans les sessions de navigation
purchase_unit_in_browse_session Nombre d'unités achetées lors des sessions de navigation
revenue_in_browse_session Revenus générés par les sessions de navigation
bounce_count_in_browse_session Nombre de sessions des visiteurs qui quittent le site après avoir consulté une seule page lors de sessions de navigation

Métriques sur les visiteurs

Un visiteur est identifié de manière unique par son ID. Les métriques sur les visiteurs agrègent toutes les informations sur les événements utilisateur pour le visiteur.

Les dimensions qui caractérisent les métriques sur les visiteurs sont définies conjointement par tous les événements utilisateur pour le visiteur. Consultez Dimensions des métriques pour savoir comment les valeurs de dimension sont définies pour le visiteur.

Nom de la métrique Description
visiteur Nombre de visiteurs

Métriques sur les visiteurs de la recherche

Un visiteur effectuant une recherche est un visiteur qui a effectué au moins un événement de recherche. Notez qu'un visiteur de recherche peut également être un visiteur de navigation, tel que défini par les métriques sur les visiteurs de navigation.

Nom de la métrique Description
search_visitor Nombre de visiteurs ayant effectué au moins une recherche
search_event_from_search_visitor Nombre d'événements de recherche provenant des visiteurs
browse_event_from_search_visitor Parcourir le nombre d'événements des visiteurs provenant de la recherche
detail_page_view_from_search_visitor Nombre de vues de la page d'informations par les visiteurs provenant de la recherche
add_to_cart_from_search_visitor Nombre d'événements d'ajout au panier générés par les visiteurs issus de la recherche
add_to_cart_unit_from_search_visitor Nombre d'unités ajoutées au panier par les visiteurs provenant de la recherche
purchase_order_from_search_visitor Nombre de bons de commande provenant des visiteurs du Réseau de Recherche
purchase_unit_from_search_visitor Unité de nombre d'achats des visiteurs provenant de la recherche
revenue_from_search_visitor Revenus générés par les visiteurs provenant de la recherche

Parcourir les métriques sur les visiteurs

Un visiteur de navigation est un visiteur qui effectue au moins un événement de navigation. Notez qu'un visiteur de navigation peut également être un visiteur de recherche, tel que défini par les métriques sur les visiteurs de recherche.

Nom de la métrique Description
browse_visitor Nombre de visiteurs ayant effectué au moins une navigation
search_event_from_browse_visitor Nombre d'événements de recherche provenant des visiteurs parcourant le site
browse_event_from_browse_visitor Parcourir le nombre d'événements des visiteurs parcourant le site
detail_page_view_from_browse_visitor Nombre de vues de la page d'informations par les visiteurs parcourant le site
add_to_cart_from_browse_visitor Nombre d'événements "Ajouter au panier" des visiteurs parcourant le site
add_to_cart_unit_from_browse_visitor Nombre d'unités ajoutées au panier par les visiteurs du site
purchase_order_from_browse_visitor Nombre de bons de commande des visiteurs de la navigation
purchase_unit_from_browse_visitor Nombre d'unités achetées par les visiteurs du parcours
revenue_from_browse_visitor Revenus générés par les visiteurs qui parcourent le site

Exemple d'utilisation

Si vous copiez ou exportez vos données de métriques vers une autre destination, vous pouvez utiliser SQL pour obtenir des informations générales ou spécifiques sur les métriques exportées. Vous trouverez dans les sections suivantes quelques méthodes courantes pour explorer vos métriques exportées à l'aide de SQL.

Calculer le taux de clics (CTR)

Calculez le CTR pour la recherche par date, par type d'appareil et par destination du trafic.

SELECT
  `date`,
  device_type,
  traffic_destination,
  SUM(detail_page_view_from_search) / SUM(search_event) as search_CTR
FROM copied_table
GROUP BY `date`, device_type, traffic_destination

Obtenir le nombre de vues de pages d'informations générées par la navigation

Obtenez les événements de vue de page de détails provenant des événements de navigation pour le trafic Google avec external_experiment_ids contenant test_arm et affichez toutes les informations sur les dimensions. external_experiment_ids est répété string.

SELECT
  `date`,
  external_experiment_ids,
  device_type,
  serving_config,
  traffic_destination,
  entity,
  detail_page_view_from_browse
FROM copied_table
WHERE
  traffic_destination = 'Google' AND 'test_arm' in UNNEST(external_experiment_ids)

Obtenir les configurations de diffusion les plus utilisées

Obtenez les configurations de diffusion les plus utilisées entre le 1er octobre 2023 et le 1er novembre 2023 pour le trafic Google. Chaque événement de recherche doit être associé à une configuration de diffusion.

SELECT
  serving_config,
  SUM(search_event) as total_search_count
FROM copied_table
WHERE `date` between '2023-10-01' and '2023-11-01' AND traffic_destination = 'Google'
GROUP BY serving_config
ORDER BY total_search_count