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 en savoir plus sur la mesure de l'impact commercial de Vertex AI Search for retail à l'aide de métriques analytiques, 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 for retail 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 tableaux. Si vous devez modifier ou mettre à jour vos données, exportez ou copiez la vue vers une autre destination.

  • Vous ne pouvez pas exporter de métriques pour des événements utilisateur datant de plus de 180 jours ni de métriques générées il y a plus de 180 jours. Les métriques générées avant la période de 180 jours ne sont pas récupérables.

Avant de commencer

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

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

Créer un ensemble de données dans BigQuery

Vous devez créer un ensemble de données dans BigQuery pour stocker les données de vos métriques d'analyse.

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 les sections 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 États-Unis (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 échoue. Le CMEK pour l'ensemble de données n'est pas compatible. L'activation de cette fonctionnalité entraîne l'échec de l'exportation.

    Pour en savoir plus sur la création d'un ensemble de données, consultez la section Créer des ensembles de données dans la documentation BigQuery.

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

Exporter vos métriques d'analyse vers une table BigQuery

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

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

  • PROJECT_ID: ID du projet de l'API Vertex AI Search for retail 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 les métriques de nombre. Il peut y avoir une légère dérive pour certaines métriques de nombre, car le filtrage des bots 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'a aucune incidence sur les tests A/B, qui dépendent de la dimension external_experiment_ids, tandis que le filtrage des robots s'applique à tout le trafic.

Dimensions des métriques

Les métriques de nombre correspondent aux 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 d'analyse, 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 de métrique.

Dimension métrique Description
date

Date du ou des événements pertinents ayant généré les métriques.

Pour les métriques sur les impressions, 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 de l'événement de première impression de la session/du visiteur.
external_experiment_ids

ID du ou des événements pertinents ayant généré les métriques.

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

Pour les métriques sur les sessions et les visiteurs, il s'agit de la concaténation des ID de test 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, le premier ayant pour valeur external_experiment_ids "test_arm_1,test_arm_2" et le second "test_arm_1,test_arm_3", la valeur de external_experiment_ids de la session/du visiteur est "test_arm_1,test_arm_2,test_arm_3".
device_type

Type d'appareil du ou des événements pertinents ayant généré les métriques, par exemple, s'il s'agit d'un appareil mobile ou d'un ordinateur de bureau.

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

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

Configuration de diffusion du ou des événements pertinents ayant généré les métriques.

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

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

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

Pour les métriques sur les impressions, 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 "Mélangé" si la session/le visiteur a des événements d'impression diffusés à la fois par Google et par votre propre solution. Il s'agit de "Google" si les événements d'impression sont uniquement diffusés par Google, ou de "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 diffusent un catalogue de produits sur plusieurs sites ou régions de marques. L'entité représente généralement les marques ou les établissements.

Pour les métriques sur les impressions, 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 entités les plus comptabilisées des événements d'impression pour la session/le visiteur.

Métriques d'impression

Les métriques sur les impressions sont calculées en fonction des conditions préalables. 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 apparaître dans les résultats de l'événement d'impression.

  • L'événement de conversion se situe 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 de la date et de l'heure de la conversion
    Impression -> Affichage de la page d'informations 60 secondes
    Impressions -> Ajouter 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" à partir de la recherche
add_to_cart_unit_from_search Nombre d'unités ajoutées au panier à partir d'une recherche
purchase_unit_from_search Nombre d'unités achetées à partir de la recherche
revenue_from_search Revenus générés par la recherche
search_event_without_result Nombre d'événements de recherche qui ne génèrent 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 affichés

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" à partir de 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 page de navigation
revenue_from_browse Revenus générés par la navigation
browse_event_without_result Parcourir le nombre d'événements qui ne génère aucun résultat
browse_request_personalization_enabled Nombre de requêtes de navigation avec 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 continue d'interaction entre un utilisateur et le système. Tout événement utilisateur marque le début d'une session, et 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 supplémentaires chaque fois qu'un événement utilisateur se produit dans une session lancée. Une fois qu'une session se termine, une nouvelle session 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 au cours de la session. Consultez les dimensions de métrique pour savoir comment les valeurs des dimensions sont définies pour la session.

Nom de la métrique Description
session Nombre de sessions

Métriques de session 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 impliquant 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 pages vues 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'unités ajoutées 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 dans les sessions de recherche
revenue_in_search_session Revenus générés au cours des sessions de recherche
bounce_count_in_search_session Nombre de sessions du visiteur qui quitte le site après avoir consulté une seule page au cours d'une session de recherche

Parcourir les métriques des sessions

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 de session 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 Nombre d'événements de navigation dans les sessions de navigation
detail_page_view_in_browse_session Nombre de pages vues dans les sessions de navigation
add_to_cart_in_browse_session Nombre d'événements "Ajouter au panier" au cours des sessions de navigation
add_to_cart_unit_in_browse_session Nombre d'unités ajoutées au panier dans les 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 au cours des sessions de navigation
revenue_in_browse_session Revenus générés au cours des sessions de navigation
bounce_count_in_browse_session Nombre de sessions du visiteur qui quitte le site après avoir consulté une seule page au cours d'une session de navigation

Métriques sur les visiteurs

L'ID de visiteur permet d'identifier de manière unique un visiteur. 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 les dimensions de métriques pour savoir comment les valeurs des dimensions 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 de recherche est un visiteur qui effectue au moins un événement de recherche. Notez qu'un visiteur issu d'une recherche peut également être un visiteur qui navigue, comme défini par les métriques sur les visiteurs qui naviguent.

Nom de la métrique Description
search_visitor Nombre de visiteurs effectuant au moins une recherche
search_event_from_search_visitor Nombre d'événements de recherche provenant des visiteurs de recherche
browse_event_from_search_visitor Parcourir le nombre d'événements provenant des visiteurs de recherche
detail_page_view_from_search_visitor Nombre de pages d'informations consultées par les visiteurs provenant de la recherche
add_to_cart_from_search_visitor Nombre d'événements d'ajout au panier provenant des 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 de la recherche
purchase_unit_from_search_visitor Unité de mesure du nombre d'achats provenant des visiteurs 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 qui consulte votre site est un visiteur qui effectue au moins un événement de navigation. Notez qu'un visiteur qui consulte le site peut également être un visiteur qui effectue une recherche, comme défini par les métriques sur les visiteurs effectuant une 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 qui effectuent des recherches
browse_event_from_browse_visitor Nombre d'événements de navigation par visiteurs de navigation
detail_page_view_from_browse_visitor Nombre de vues de la page d'informations par les visiteurs qui ont effectué une recherche
add_to_cart_from_browse_visitor Nombre d'événements "Ajouter au panier" provenant des visiteurs qui ont consulté le site
add_to_cart_unit_from_browse_visitor Nombre d'unités ajoutées au panier par les visiteurs qui ont effectué une navigation
purchase_order_from_browse_visitor Nombre de bons de commande des visiteurs qui ont consulté le site
purchase_unit_from_browse_visitor Nombre d'unités achetées par les visiteurs qui effectuent des recherches
revenue_from_browse_visitor Revenus générés par les visiteurs qui effectuent des recherches

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. Les sections suivantes présentent quelques méthodes courantes d'exploration de vos métriques exportées à l'aide de SQL.

Calculer le taux de clics (CTR)

Calculez le CTR pour les recherches par date, par type d'appareil et par destination de 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 pages vues générées par la navigation

Obtenez les événements de vue de la page d'informations provenant des événements de navigation pour le trafic Google avec external_experiment_ids contenant test_arm, et affichez toutes les informations de dimension. 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. Une configuration de diffusion doit être associée à chaque événement de recherche.

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