Afficher les statistiques

Cette page explique comment afficher les données analytiques de vos applications de recommandations multimédias et de recherche.

Les données analytiques vous donnent un aperçu des tendances d'utilisation, de la qualité de la recherche et des recommandations, et de l'engagement des utilisateurs finaux de votre application. La console Vertex AI Agent Builder offre une expérience de tableau de bord interactif optimisée par Looker.

• Pour les applications de recommandations de médias: version Preview publique. Vous pouvez consulter des métriques par recommandation en fonction des événements utilisateur. Vous pouvez filtrer les métriques par période et type d'appareil.
• Pour les applications de recherche générique et de recherche de contenus multimédias: vous pouvez consulter des métriques par recherche et par session de recherche en fonction des journaux de recherche et des événements utilisateur. Vous pouvez filtrer les métriques par période, requête et type d'appareil.

Les métriques sont actualisées toutes les six heures environ. Il peut donc s'écouler plusieurs heures avant que vous puissiez utiliser la page Analytics après avoir créé votre application.

Sources de données pour l'analyse

Cette section décrit les sources de données pour les données analytiques en fonction du type d'application.

Vous devez terminer l'intégration des événements utilisateur pour pouvoir consulter les données analytiques sur les événements utilisateur.

Les événements utilisateur que vous importez déterminent les données analytiques générées.

Les applications de recommandations de contenus multimédias nécessitent les événements utilisateur suivants pour afficher certaines métriques:

• Événements d'affichage de l'article Obligatoire pour le taux de clics.
• Événements de fin de contenu multimédia Obligatoire pour le taux de finalisation par lecture et le taux de finalisation par recommandation.
• Événements de lecture multimédia. Obligatoire pour le nombre de lectures de médias de recommandation, le taux de lecture, le taux de lecture complète par lecture et la durée moyenne de visionnage par lecture.

Les applications de recherche nécessitent les événements utilisateur suivants pour afficher certaines métriques:

• Événements de recherche Obligatoire pour le taux de clics.
• Événements d'affichage de l'article Obligatoire pour le taux de clics.

Les informations suivantes sont également utilisées pour certaines analyses:

• Impressions Vous pouvez fournir des impressions (vues ou clics sur des articles) attribuables à la recherche Vertex AI en incluant l'article associé dans UserEvent.Documents lors de l'ingestion des événements utilisateur. Ces informations sont nécessaires pour l'attribution et pour calculer les métriques par recherche.
• Jetons d'attribution Les jetons d'attribution sont des ID uniques générés par Vertex AI Search 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 permet d'identifier si une recherche est diffusée par l'API. Seuls les événements utilisateur avec un jeton d'attribution généré par Google sont utilisés pour calculer les métriques.
• User-agent. Incluez UserInfo.userAgent avec les événements utilisateur afin de pouvoir filtrer les métriques des événements utilisateur par type d'appareil.

Journaux de recherche

Les applications de recherche utilisent les journaux de recherche comme sources de données pour certaines métriques.

Les journaux de recherche sont basés sur les requêtes de recherche. Pour permettre à Vertex AI Agent Builder d'identifier les sessions utilisateur afin de pouvoir fournir des analyses par session et des résultats de recherche de meilleure qualité, Google vous recommande vivement de définir le champ facultatif SearchRequest.UserPseudoId.

Si aucun journal de recherche ni aucun événement utilisateur n'est encore enregistré, des valeurs par défaut sont affichées pour toutes les métriques.

Afficher les données analytiques sur les recommandations multimédias

Suivez les instructions ci-dessous pour afficher les données analytiques sur les recommandations multimédias.

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Cliquez sur le nom de l'application pour laquelle vous souhaitez afficher les données analytiques.

3. Cliquez sur Analytics.

4. Pour filtrer vos métriques, spécifiez l'un des filtres suivants, puis cliquez sur le bouton Actualiser pour les appliquer:

   • 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 sur les recherches

Suivez les instructions ci-dessous pour afficher les données analytiques des applications de recherche générique ou de recherche multimédia.

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Cliquez sur le nom de l'application pour laquelle vous souhaitez afficher les données analytiques.

3. Cliquez sur Analytics.

4. Cliquez sur un onglet pour afficher ce groupe de métriques:

   • Par recherche Les métriques sont regroupées par recherche.
   • Par session Les métriques sont regroupées par sessions de recherche.
   • Comparer Les métriques de référence sont affichées à côté des métriques d'une période de comparaison. Sélectionnez des plages de dates pour les métriques de référence (une période antérieure) et les métriques de comparaison (une période ultérieure). Ces périodes ne peuvent pas se chevaucher.

5. Pour filtrer vos métriques, spécifiez l'un des filtres suivants, puis cliquez sur le bouton Actualiser pour les appliquer:

   • Plage de dates Sélectionnez une plage de dates prédéfinie ou, le cas échéant, saisissez une plage de dates personnalisée.
   • Requête de recherche Sélectionnez une condition et une valeur de requête de recherche. Vous pouvez ajouter plusieurs filtres de requête de recherche. Disponible pour les métriques Par recherche et Comparer.
   • Type d'appareil Sélectionnez un type d'appareil sur lequel des requêtes ont été effectuées.

Définitions des métriques

Les tableaux suivants décrivent la définition des métriques.

Métriques sur les recommandations de contenus multimédias

Nom de la métrique	Définition de la métrique	Remarques
Nombre de recommandations	Nombre total de recommandations
Nombre de lectures de la recommandation	Nombre de fois où les éléments multimédias recommandés ont été lus
Nombre de clics sur les recommandations	Nombre de fois où les utilisateurs ont cliqué sur des éléments multimédias recommandés
Taux de clics	Nombre de clics sur les recommandations / nombre de recommandations	Les clics sur les recommandations sont des événements de visionnage d'un article qui peuvent être attribués à une recommandation.
Nombre de recommandations de contenus multimédias terminées	Nombre de fois où des éléments multimédias recommandés ont été lus jusqu'à la fin
Taux de visionnage par recommandation	Nombre de fois où les éléments multimédias recommandés ont été lus / Nombre de recommandations
Taux de lecture complète par lecture	Nombre de fois où les éléments multimédias recommandés ont été lus jusqu'à la fin / nombre de fois où les éléments multimédias ont été lus
Durée moyenne de visionnage par lecture	Durée (en secondes) pendant laquelle les éléments multimédias recommandés ont été lus / nombre de fois où les éléments multimédias recommandés ont été lus
Taux d'achèvement par recommandation	Nombre de fois où les éléments multimédias ont été lus jusqu'à la fin / Nombre de recommandations
Durée moyenne de visionnage par recommandation	Durée (en secondes) pendant laquelle les éléments multimédias recommandés ont été regardés / Nombre de recommandations

Métriques de recherche

Nom de la métrique	Définition des métriques	Remarques
Nombre de recherches	Nombre d'événements de recherche	En fonction des journaux de recherche
Taux de résultats nuls	Nombre d'événements de recherche sans résultats / Nombre de recherches	En fonction des journaux de recherche
Taux de clics (CTR) par recherche	Nombre de clics sur la recherche/Nombre de recherches	Les clics sur la recherche sont des événements de vue d'élément qui peuvent être attribués à un événement de recherche précédent. En fonction des événements utilisateur
Nombre de sessions de recherche	Nombre de sessions de recherche	Une session de recherche est une session utilisateur contenant au moins un événement de recherche. Une session utilisateur, également appelée visite, est un ensemble continu d'événements utilisateur. Au bout de 30 minutes d'inactivité, la session se termine. Sur la base des journaux de recherche
Pages vues par visite	Nombre d'événements de visionnage d'éléments dans les sessions de recherche / Nombre de sessions de recherche	Cette métrique inclut toutes les pages vues dans les visites liées aux recherches, que ces pages puissent être attribuées à la recherche Vertex AI ou non. En fonction des événements utilisateur
Taux de rebond	Nombre de rebonds dans les sessions de recherche / Nombre de sessions de recherche	Un rebond de session de recherche est défini comme une session avec une seule recherche, où l'utilisateur a quitté la page après avoir effectué une seule recherche. Basé sur les événements utilisateur

Désactiver l'analyse

Vous ne pouvez pas désactiver les données analytiques pour une application existante, mais lorsque vous créez une application, vous pouvez choisir de la créer avec les données analytiques désactivées.

Pour créer une application de recherche qui ne collecte pas de données analytiques:

1. Suivez les instructions REST de la section Créer une application de recherche, en ajoutant ce qui suit à la commande curl:

      "disableAnalytics": true
   

   Exemple de commande

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "App without analytics",
     "dataStoreIds": ["my-data-store"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "searchEngineConfig": {
        "searchTier": "SEARCH_TIER_ENTERPRISE",
        "searchAddOns": ["SEARCH_ADD_ON_LLM"]
      },
     "disableAnalytics": true
   }'
   
       

   Cette commande crée une application qui ne collecte pas de données d'analyse des recherches.