Remarque : Vertex AI Search est renommé Agent Search. Nous sommes en train de mettre à jour le contenu pour refléter le nouveau branding.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Afficher les statistiques

Cette page explique comment afficher les données analytiques de vos applications de recommandations 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, ainsi que de l'engagement des utilisateurs finaux avec votre application. La console Agent Search fournit un tableau de bord interactif alimenté par Looker.

Pour les applications de recommandations multimédias : version Preview publique. Vous pouvez consulter les métriques par recommandation en fonction des événements utilisateur. Vous pouvez filtrer les métriques par période et par type d'appareil.
Pour les applications de recherche personnalisée et de recherche multimédia : vous pouvez consulter les 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, par requête et par type d'appareil.
Pour les applications de recherche de données de santé : version Preview publique. Vous pouvez consulter les métriques par recherche en fonction des journaux de recherche.

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.

Sources de données pour les analyses

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

Vous devez effectuer l'intégration des événements utilisateur pour pouvoir consulter les analyses des événements utilisateur.

Les événements utilisateur que vous importez ont une incidence sur les analyses générées.

Les applications de recommandations 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 lecture complète du contenu multimédia. Obligatoire pour le taux de lecture complète par lecture et le taux de lecture complète par recommandation.
Événements de lecture du contenu multimédia. Obligatoire pour le nombre de lectures du contenu multimédia recommandé, le taux de lecture complète, 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 les impressions (vues ou clics sur un article) attribuables à Agent Search 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 Agent 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 est nécessaire pour 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 à Agent Search d'identifier les sessions utilisateur afin de fournir des analyses par session et des résultats de recherche de meilleure qualité, Google vous recommande vivement de définir le champ facultatif userPseudoId.

S'il n'existe pas encore de journaux de recherche ni d'événements utilisateur, les valeurs par défaut s'affichent pour toutes les métriques.

Afficher les analyses des recommandations multimédias

Suivez les instructions ci-dessous pour afficher les analyses des recommandations multimédias.

Dans la Google Cloud console, accédez à la page AI Applications.

AI Applications
Cliquez sur le nom de l'application pour laquelle vous souhaitez afficher les analyses.
Cliquez sur Analytics.
Pour filtrer vos métriques, spécifiez l'un des filtres suivants, puis cliquez sur le bouton Refresh (Actualiser) pour les appliquer :
- Période. Sélectionnez une période prédéfinie ou, si disponible, saisissez une période personnalisée.
- Type d'appareil. Sélectionnez un type d'appareil sur lequel les requêtes ont été effectuées.

Afficher les analyses de recherche

Suivez les instructions ci-dessous pour afficher les analyses des applications de recherche.

Dans la Google Cloud console, accédez à la page AI Applications.

AI Applications
Cliquez sur le nom de l'application pour laquelle vous souhaitez afficher les analyses.
Cliquez sur Analytics.
Cliquez sur un onglet pour afficher ce groupe de métriques :
- Par recherche. Les métriques sont regroupées par recherche. Pour la recherche de données de santé, il s'agit du seul groupe de métriques disponible.
- Par session. Les métriques sont regroupées par session 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 périodes pour les métriques de référence (période antérieure) et les métriques de comparaison (période ultérieure). Ces périodes ne peuvent pas se chevaucher.
Pour filtrer vos métriques, spécifiez les filtres, puis cliquez sur le bouton Refresh (Actualiser) pour les appliquer.

Pour les applications multimédias et les applications de recherche personnalisée, les filtres suivants sont disponibles :
- Période. Sélectionnez une période prédéfinie ou, si disponible, saisissez une période 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 les requêtes ont été effectuées.
Pour les applications de recherche de données de santé, les filtres suivants sont disponibles :
- Période. Sélectionnez une période prédéfinie ou, si disponible, saisissez une période personnalisée. Lorsque vous sélectionnez une date spécifique pour une période personnalisée, il s'agit de la date à laquelle la recherche a eu lieu dans le fuseau horaire UTC-08:00.
- 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.
- Position de l'utilisateur. Sélectionnez l'emplacement de l'hôpital, de la clinique ou du prestataire de soins de santé défini dans la requête de recherche. Ce filtre n'est disponible que s'il a été défini dans la requête de recherche.
- Rôle utilisateur. Sélectionnez la catégorie de poste de l'utilisateur qui a envoyé la requête de recherche. Ce filtre n'est disponible que s'il a été défini dans la requête de recherche.
- Paramètre utilisateur. Sélectionnez le paramètre de santé défini dans la requête de recherche, tel qu'un traitement en hospitalisation, en ambulatoire ou hybride. Ce filtre n'est disponible que s'il a été défini dans la requête de recherche.

Définitions des métriques

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

Métriques des recommandations 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 recommandations	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 éléments multimédias recommandés ont été cliqués
Taux de clics	Nombre de clics sur les recommandations / nombre de recommandations	Les clics sur les recommandations sont des événements d'affichage d'articles qui peuvent être attribués à une recommandation
Nombre de lectures complètes du contenu multimédia recommandé	Nombre de fois où les éléments multimédias recommandés ont été lus jusqu'à la fin
Taux de lecture complète 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 de lecture complète 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é visionnés / nombre de recommandations

Métriques de recherche personnalisée et multimédia

Nom de la métrique	Définition des métriques	Remarques
Nombre de recherches	Nombre d'événements de recherche	Basé sur les journaux de recherche.
Taux d'absence de résultats	Nombre d'événements de recherche sans résultat/nombre de recherches	Basé sur les journaux de recherche.
Taux de clics (CTR) par recherche	Nombre de clics sur les pages de recherche/nombre de recherches	Les clics sur les pages de recherche sont des événements d'affichage d'articles qui peuvent être attribués à un événement de recherche précédent. Basé sur les événements utilisateur.
Nombre de "J'aime" et de "Je n'aime pas" dans les commentaires	Nombre de "J'aime" et de "Je n'aime pas"	Enregistrement des réponses aux commentaires "J'aime"/"Je n'aime pas" envoyées par les utilisateurs de l'application.
Répartition des motifs de "Je n'aime pas" dans les commentaires	Pourcentage des motifs de "Je n'aime pas"	Lorsqu'un utilisateur n'aime pas une réponse générée, il peut sélectionner plusieurs raisons pour expliquer son choix. Le pourcentage indique la fréquence à laquelle chaque motif a été sélectionné.
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. La session se termine après 30 minutes d'inactivité. Basé sur les journaux de recherche.
Pages vues par visite de recherche	Nombre d'événements d'affichage d'articles dans les sessions de recherche / nombre de sessions de recherche	Cette métrique inclut toutes les pages vues lors des visites de recherche, qu'elles puissent ou non être attribuées à Agent Search. Basé sur les é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 n'avoir effectué qu'une seule recherche. Basé sur les événements utilisateur.

Métriques de recherche de données de santé

Les métriques de recherche suivantes sont disponibles pour les applications de recherche de données de santé.

Nom de la métrique	Définition des métriques	Remarques
Nombre de recherches	Nombre d'événements de recherche
Nombre d'absence de résultats	Nombre d'événements de recherche sans résultat
Taux d'absence de résultats par recherche	Nombre d'événements de recherche sans résultat par recherche
Nombre de patients	Nombre d'ID de patients pour lesquels des recherches ont été effectuées	Cette valeur est dédupliquée par utilisateur de recherche, mais pas par patient. Par exemple, si l'utilisateur 1 recherche les patients A et B, et que l'utilisateur 2 recherche uniquement le patient B, le nombre est de trois.
Nombre de sessions de recherche client	Nombre de sessions définies par l'utilisateur de recherche	Vous pouvez envoyer un ID de session dans votre recherche. Pour en savoir plus, voir `session`.
Nombre de visiteurs de recherche	Nombre d'utilisateurs ayant envoyé une requête de recherche	Les utilisateurs sont comptabilisés basés sur le `userInfo` champ.
Nombre de sessions de recherche synthétiques	Nombre de sessions de recherche définies par Google	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. La session se termine après 30 minutes d'inactivité.

Désactiver les analyses

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

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

Suivez les instructions REST de la section Créer une application de recherche, en ajoutant les éléments suivants à 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 analytiques de recherche.