Changement de nom : le secteur de la vente au détail s'appelle Vertex AI Search pour le commerce. Nous sommes en train de mettre à jour le contenu pour refléter le nouveau branding.

Afficher les données analytiques

Cette page décrit les métriques qui peuvent vous aider à déterminer l'impact de Vertex AI Search pour le commerce sur votre activité.

Sources de données pour l'analyse

Passez en revue les conditions préalables décrites dans cette section avant d'utiliser le tableau de bord d'analyse.

Le tableau de bord d'analyse utilise les événements utilisateur ingérés comme sources de données pour les métriques. Vous devez terminer l'intégration des événements utilisateur pour pouvoir afficher les données analytiques sur les événements utilisateur.

Événements utilisateur

Les événements utilisateur suivants sont requis pour afficher certaines métriques:

Événements de recherche : Obligatoire pour tous les types de métriques.
Événements de vue de la page d'informations : Obligatoire pour les métriques des pages vues.
Événements d'ajout au panier Obligatoire pour le taux d'ajout au panier et le taux de conversion.
Événements d'achat terminé. Obligatoire pour le revenu total, les revenus générés par l'outil de recommandation, la valeur moyenne de la commande, le taux d'achat, le taux de revenus, la valeur unitaire moyenne, le taux de bon de commande et le taux de conversion.

Les informations suivantes sont également utilisées à des fins d'analyse:

Informations détaillées sur le produit : Pour garantir un calcul précis des métriques liées à la recherche, incluez UserInfo.productDetails dans vos événements utilisateur. Ces informations permettent à Vertex AI Search pour le commerce d'attribuer les recherches à des interactions avec des produits spécifiques. Si le champ UserInfo.ProductDetail.quantity est omis dans les événements utilisateur, la valeur par défaut 1 sera utilisée pour les calculs.
Revenus : Le champ UserInfo.PurchaseTransaction.revenue est essentiel pour générer des métriques de revenus précises. Assurez-vous que ce champ est renseigné dans vos événements utilisateur pour permettre une analyse pertinente des données sur les revenus.
Jetons d'attribution : Les jetons d'attribution sont des identifiants uniques générés par Vertex AI Search pour le commerce et renvoyés avec chaque requête de recherche. Veillez à inclure ce jeton d'attribution en tant que UserEvent.attributionToken avec tous les événements utilisateur résultant d'une recherche. Cela est nécessaire pour déterminer si une recherche est diffusée par Vertex AI Search pour le commerce.
User-agent : Incluez UserInfo.userAgent avec les événements utilisateur résultant d'une recherche afin de pouvoir filtrer les métriques d'événements utilisateur par type d'appareil.

Afficher les données analytiques des recommandations

Dans la console Google Cloud, accédez à la page Search for Retail.

Accéder à la console Search for Retail
Dans le menu de navigation, cliquez sur Analytics.
Cliquez sur l'onglet Recommandations.
Sélectionnez un type de métrique dans la liste Métrique pour afficher son graphique du mois précédent.

Afficher les données analytiques sur la recherche

Les métriques sont actualisées toutes les six heures environ. Une fois votre application de recherche créée, plusieurs heures peuvent s'écouler avant que vous ne puissiez utiliser la page Analytics.

En l'absence d'événements utilisateur, les valeurs par défaut sont affichées pour toutes les métriques.

Pour afficher les données analytiques sur la recherche:

Dans la console Google Cloud, accédez à la page Search for Retail.

Accéder à la console Search for Retail
Dans le menu de navigation, cliquez sur Analytics.
Cliquez sur l'onglet Rechercher.
Cliquez sur un onglet pour afficher ce groupe de métriques:
- Par recherche : Les métriques sont regroupées par recherches.
- Par visite. Les métriques sont regroupées par visites avec recherche.
Pour filtrer vos métriques, utilisez les filtres suivants:
- Plage de dates : Sélectionnez une plage de dates prédéfinie ou, le cas échéant, saisissez une plage de dates personnalisée.
- Type d'appareil : Sélectionnez un type d'appareil sur lequel des requêtes ont été effectuées.

Afficher les données analytiques de navigation

Les métriques sont actualisées toutes les six heures environ. Par conséquent, plusieurs heures peuvent s'écouler avant que vous puissiez utiliser la page Analytics après avoir créé votre application de recherche.

S'il n'y a pas encore d'événements utilisateur, les valeurs par défaut sont affichées pour toutes les métriques.

Pour afficher les données analytiques de navigation:

Dans la console Google Cloud, accédez à la page Search for Retail.

Accéder à la console Search for Retail
Dans le menu de navigation, cliquez sur Analytics.
Cliquez sur l'onglet Parcourir.
Cliquez sur un onglet pour afficher ce groupe de métriques:
- Par navigation : Les métriques sont regroupées par navigation.
- Par visite. Les métriques sont regroupées par visites de navigation.
Pour filtrer vos métriques, utilisez les filtres suivants:
- Plage de dates : Sélectionnez une plage de dates prédéfinie ou, le cas échéant, saisissez une plage de dates personnalisée.
- Type d'appareil : Sélectionnez un type d'appareil sur lequel la navigation a été effectuée.

Afficher les analyses de configuration de diffusion

Dans la console Google Cloud, accédez à la page Search for Retail.

Accéder à la console Search for Retail
Dans le menu de navigation, cliquez sur Configurations de diffusion.
Cliquez sur le nom de la configuration de diffusion pour laquelle vous souhaitez afficher les analyses.
Cliquez sur l'onglet Analytics.
Sélectionnez un type de métrique dans la liste déroulante Métrique pour afficher son graphique du mois précédent.

Définitions des métriques

Métriques récapitulatives

Les sections ci-dessous définissent les métriques de l'ensemble du site affichées sur la page Analytics:

Métriques récapitulatives des recommandations: métriques représentant l'engagement des utilisateurs avec les résultats des recommandations générés par les recommandations.
Métriques récapitulatives de recherche :
- Métriques récapitulatives de la recherche de requête textuelle: métriques représentant l'engagement avec les résultats de recherche de requête textuelle générés par la recherche.
- Parcourir les métriques du résumé de la recherche: métriques représentant l'engagement avec les résultats de recherche de navigation par catégorie générés par recherche.

Métriques récapitulatives des recommandations

Les métriques suivantes s'affichent pour les recommandations dans l'onglet Recommandations.

Sélectionnez un type de métrique dans la liste déroulante Métrique pour afficher son graphique pour le mois dernier.

Métrique	Description
Total des revenus	Il s'agit du total des revenus générés par tous les événements d'achat enregistrés. Cette valeur inclut les frais d'expédition et les taxes.
Revenus générés par l'outil de recommandation	Revenus générés par les événements d'achat incluant un ou plusieurs produits sélectionnés dans un volet de recommandations. Cette valeur inclut les frais de port et les taxes, ainsi que toute remise appliquée.
Panier moyen	Il s'agit de la valeur moyenne des commandes pour tous les événements d'achat. Montant total des revenus divisé par le nombre de commandes.
Panier moyen généré par l'outil de recommandation	Valeur moyenne des commandes comprenant au moins un produit sélectionné dans un panneau de recommandations. Revenus générés par l'outil de recommandation divisés par le nombre de commandes contenant au moins un produit sélectionné dans un panneau de recommandations.

Métriques récapitulatives de Text Search

Les métriques suivantes pour les recherches de texte de recherche s'affichent dans l'onglet Rechercher.

Métrique	Description
Nombre de recherches	Nombre total de recherches effectuées sur l'ensemble du site.
Taux d'absence de résultat	Nombre de recherches sans résultat, divisé par le nombre total de recherches.
Taux de clics (CTR) par recherche	Nombre de clics provenant des résultats de recherche divisé par le nombre total de recherches.
Taux d'ajout au panier (ATC) par recherche	Nombre d'événements d'ajout au panier se produisant à partir des résultats de recherche, divisé par le nombre total de recherches.
Taux d'achat par recherche	Nombre d'unités dans les événements d'achat terminé qui se produisent à partir des résultats de recherche, divisé par le nombre total de recherches.
Taux de revenu par recherche	Revenu généré par les événements d'achat finalisé, divisé par le nombre total de recherches.
Valeur unitaire moyenne par recherche	Revenus générés par les événements d'achat terminé, divisé par la quantité d'unités totales générées par les événements d'achat terminé. Calculé uniquement sur la base des événements de confirmation d'achat attribués aux recherches.
Taux de personnalisation	Nombre de recherches personnalisées divisé par le nombre total de recherches.
Rechercher le nombre de visites	Nombre total de visites avec recherche effectuées sur l'ensemble du site.
Pages vues par visite avec recherche	Nombre total d'événements de consultation de page d'informations qui se sont produits au cours de la visite avec recherche, divisé par le nombre total de visites avec recherche.
Taux d'ajout au panier (ATC) par visite avec recherche	Nombre d'événements d'ajout au panier se produisant au cours de la visite avec recherche, divisé par le nombre total de visites avec recherche. Calculé en incluant tous les événements d'ajout au panier, qu'ils puissent être directement attribués à la recherche ou non.
Taux de bons de commande par visite de recherche	Nombre d'événements de confirmation d'achat qui se produisent au cours de la visite avec recherche, divisé par le nombre total de visites avec recherche. Il est calculé en incluant tous les événements d'achat terminé, qu'ils puissent être directement attribués à la recherche.
Taux de revenu par visite avec recherche	Chiffre d'affaires généré par les événements de type achat terminé lors d'une visite avec recherche, divisé par le nombre total de visites avec recherche. Il est calculé en incluant tous les événements d'achat terminé, qu'ils puissent être directement attribués à la recherche.
Valeur moyenne de la commande par visite avec recherche	Revenus générés par les événements de confirmation d'achat lors de la visite de recherche, divisé par le nombre d'événements de confirmation d'achat qui se sont produits lors de cette visite. Il est calculé en incluant tous les événements d'achat terminé, qu'ils puissent être directement attribués à la recherche.

Parcourir les métriques du récapitulatif de recherche

Les métriques suivantes pour les recherches par navigation sont affichées dans l'onglet Parcourir.

Métrique	Description
Nombre de navigations	Nombre total de recherches par navigation effectuées sur l'ensemble du site.
Taux d'absence de résultat	Nombre de recherches de navigation sans résultat divisé par le nombre total de recherches de navigation.
Taux de clics (CTR) par navigation	Nombre de clics provenant des résultats de navigation divisé par le nombre total de recherches sur l'ensemble du site Le nombre total de recherches par navigation inclut les requêtes paginées.
Tarif d'ajout au panier par navigation	Nombre d'événements d'ajout au panier se produisant à partir des résultats de navigation divisé par le nombre total de recherches de navigation.
Taux d'achat par navigation	Nombre d'unités dans les événements d'achat terminé qui se produisent à partir des résultats de navigation, divisé par le nombre total de recherches de navigation. Le nombre total de recherches par navigation inclut les requêtes paginées.
Taux de revenus par navigation	Montant des revenus générés par les événements d'achat terminé, divisé par le nombre total de recherches de navigation.
Valeur unitaire moyenne par navigation	Revenus générés par les événements d'achat terminé, divisé par la quantité d'unités totales générées par les événements d'achat terminé. Il est calculé uniquement sur la base des événements d'achat terminé attribués aux recherches de navigation.
Taux de personnalisation	Nombre de recherches de navigation personnalisées divisé par le nombre total de recherches de navigation.
Parcourir le nombre de visites	Nombre total de recherches pour navigation effectuées sur l'ensemble du site.
Pages vues par visite de navigation	Nombre total d'événements de consultation de page d'informations qui se produisent au cours de la visite de recherche de navigation, divisé par le nombre total de visites de recherche de navigation.
Tarif d'ajout au panier (ATC) par visite de navigation	Nombre d'événements d'ajout au panier se produisant au cours de la visite de recherche par navigation divisé par le nombre total de visites avec recherche de navigation. Il est calculé en incluant tous les événements d'ajout au panier, qu'ils puissent être directement attribués à la recherche de navigation.
Taux de bons de commande par visite de navigation	Nombre d'événements de confirmation d'achat qui se produisent au cours de la visite de recherche de navigation, divisé par le nombre total de visites de recherche de navigation. Il est calculé en incluant tous les événements d'achat terminé, qu'ils puissent être directement attribués à la recherche de navigation.
Taux de revenus par visite de navigation	Montant des revenus générés par les événements de type "achat terminé" lors de la visite de recherche de navigation, divisé par le nombre total de visites avec recherche de navigation. Il est calculé en incluant tous les événements d'achat terminé, qu'ils puissent être directement attribués à la recherche de navigation.
Valeur moyenne de la commande par visite de navigation	Chiffre d'affaires généré par les événements de confirmation d'achat lors de la recherche de navigation, divisé par le nombre d'événements de confirmation d'achat se produisant lors de cette visite. Il est calculé en incluant tous les événements d'achat terminé, qu'ils puissent être directement attribués à la recherche de navigation.

Métriques spécifiques aux configurations

Vous pouvez consulter les métriques d'une configuration de diffusion spécifique sur la page Configurations de diffusion. Pour les graphiques de métriques, cliquez sur le nom d'une configuration de diffusion pour accéder à sa page d'informations, puis sélectionnez l'onglet Analytics.

Le tableau ci-dessous fournit des définitions pour les métriques spécifiques aux configurations.

Métrique	Description	Détails
Taux de clics (CTR)	Nombre de vues des informations détaillées sur le produit provenant du panneau des recommandations d'une configuration de diffusion, divisé par le nombre total de requêtes `predict` pour cette configuration de diffusion.	Par exemple, si la configuration de diffusion pointe vers un modèle "Fréquemment achetés ensemble", le CTR correspond au nombre de pages d'informations détaillées sur le produit consultées depuis le panneau de recommandations du panier, divisé par le nombre de requêtes de prédiction sur la page du panier.
Taux de conversion	Nombre d'événements d'ajout au panier provenant du panneau des recommandations d'une configuration de diffusion, divisé par le nombre total de requêtes `predict` pour cette configuration de diffusion.	Comme pour le CTR, sauf qu'au lieu des pages d'informations détaillées de produits, le taux de conversion utilise les événements d'ajout au panier.
Revenus générés par l'outil de recommandation	Revenu total généré par les recommandations pour cette configuration de diffusion.	Semblable aux revenus générés par l'outil de recommandation pour les métriques récapitulatives, mais pour cette configuration de diffusion uniquement.

Pour suivre les clics à partir d'une configuration de diffusion, Vertex AI Search pour le commerce aligne les résultats des réponses predict et search avec les événements utilisateur ingérés. Si un élément sur lequel l'utilisateur a cliqué apparaît dans les réponses pour le même ID de visiteur dans un délai d'une heure, le clic ou l'achat est traité comme une conséquence de Vertex AI Search pour le commerce.

Ce processus est entièrement automatique. Vous n'avez rien à configurer. Toutefois, lorsque vous configurez vos requêtes de prédiction et de recherche pour la première fois, vous devez vérifier que :

Les ID de visiteur dans la requête sont identiques aux ID de visiteur que vous avez utilisés pour l'ingestion des événements.
L'horodatage dans la réponse correspond à peu près à l'horodatage de cet événement.

Lorsque les métriques sont comparées au résultat attendu idéal ou à la vérité terrain, les valeurs peuvent être inférieures, mais les tendances s'alignent.

Une alternative plus directe à la méthode ci-dessus consiste à utiliser des jetons d'attribution. Cette méthode nécessite une instrumentation importante et n'est recommandé que pour les cas d'utilisation de suivi avancé.