Exporter vos métriques d'analyse dans 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 pour le commerce avec des 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 Les projets Vertex AI Search pour le commerce sont des vues autorisées, et non 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. Toutes les métriques générées avant la fin de la période de 180 jours ne peuvent pas être récupérés.

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 vos données analytiques les données de métriques.

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 région différente, vous exportez vos données Échec de BigQuery. CMEK de l'ensemble de données n'est pas pris en charge ; son activation 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 dans la documentation BigQuery.

    Cet ensemble de données sera utilisé pour contenir 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 du jeu 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. Pour 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 certains comptabilisent les métriques, car le filtrage des robots peut exclure certains événements des métriques et des calculs de calcul. 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, tandis que le filtrage des robots est appliqué à l'ensemble du trafic.

Dimensions des métriques

Les métriques de nombre correspondent aux décomptes bruts directement agrégés à partir d'é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 besoins des métriques d'analyse, Les événements de recherche et de navigation sont appelés événements d'impression. Les événements detail_page_view, add_to_cart et purchase sont appelés événements é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 la première impression de la session/du visiteur.
external_experiment_ids

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

Pour les métriques sur les impressions, il s'agit de l'ID de 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, s'il y a deux événements de recherche dans une session/visiteur, le premier événement de recherche a external_experiment_ids "test_arm_1,test_arm_2" et le deuxième événement de recherche a external_experiment_ids 'test_arm_1,test_arm_3', puis external_experiment_ids de la session/visiteur est 'test_arm_1,test_arm_2,test_arm_2
device_type

Type d'appareil des événements pertinents 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 de bureau).

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

Pour les métriques sur les sessions et les visiteurs, ce champ est vide si la session/le visiteur a plusieurs types d'appareils distincts ou s'il n'existe qu'un seul type d'appareil pour l'ensemble de la session/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 sur les sessions et les visiteurs, ce champ est vide si la session/le visiteur a plusieurs configurations de diffusion distinctes ou si elle n'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, il s'agit de "Mixte". si la session/le visiteur enregistre à la fois des événements d'impression diffusés 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 par des fournisseurs 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 des annonces sur plusieurs sites de marques ou régions avec un seul catalogue de produits. Une 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 principales entités comptabilisées parmi les événements d'impression pour la session/le visiteur.

Métriques d'impressions

Les métriques sur les impressions sont calculées conformément aux conditions préalables. Événements de conversion (detail_page_view, add_to_cart et purchase), peuvent être attribués à un événement d'impression uniquement s'ils répondent aux critères suivants.

  • L'événement d'impression et l'événement de conversion sont associés au même visiteur.

  • L'ID produit de l'événement de conversion doit apparaître dans le champ résultats.

  • 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
    Impression -> Ajout au panier 24 heures
    Impression -> Acheter 48 heures

Métriques d'impression 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 de 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 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 Nombre d'événements de navigation
detail_page_view_from_browse Nombre de vues de la page d'informations provenant 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 au cours d'une pour démarrer la session. 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 des 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 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 d'ajout au panier pendant 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 d'achat dans les sessions de recherche
revenue_in_search_session Revenus issus des sessions de recherche
bounce_count_in_search_session Nombre de sessions du visiteur qui a quitté le site après avoir consulté une seule page au cours des sessions 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" dans les 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 issus des sessions de navigation
bounce_count_in_browse_session Nombre de sessions du visiteur qui a quitté le site après avoir consulté une seule page au cours des sessions de navigation

Métriques sur les visiteurs

L'ID de visiteur permet d'identifier de manière unique un visiteur. Agrégation des métriques sur les visiteurs toutes les informations des é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 des métriques. comme la façon dont 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 Un visiteur ayant effectué une recherche peut également être un visiteur naviguant, tel que défini par Parcourir la visite métriques.

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 de la 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 vues de la page d'informations par les visiteurs 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 de la recherche

Parcourir les métriques sur les visiteurs

Un visiteur ayant effectué une navigation est un visiteur effectuant au moins un événement de navigation. Notez qu'un visiteur de la page de navigation peut aussi être un visiteur de la recherche, tel que défini par le visiteur de la recherche métriques.

Nom de la métrique Description
browse_visitor Nombre de visiteurs ayant effectué au moins une recherche
search_event_from_browse_visitor Nombre d'événements de recherche provenant des visiteurs de la navigation
browse_event_from_browse_visitor Nombre d'événements de navigation provenant des 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 d'ajout au panier générés par les visiteurs de la page de navigation
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.

Calculez 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

Obtenir les événements de consultation de la page d'informations provenant des événements de navigation pour le trafic Google avec external_experiment_ids contenant test_arm et afficher toutes les dimensions des informations. La valeur external_experiment_ids est répétée 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