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 des renseignements sur les tendances d'utilisation, la qualité de la recherche et des recommandations, ainsi que l'engagement des utilisateurs finaux dans votre application. La console Applications d'IA fournit un tableau de bord interactif alimenté par Looker.

• Pour les applications de recommandation multimédia : version Preview publique. Vous pouvez consulter les métriques par recommandation basées sur les événements utilisateur. Vous pouvez filtrer les métriques par plage de dates et par type d'appareil.
• Pour les applications de recherche personnalisée et de recherche de contenus multimédias : 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 plage de dates, requête et 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 environ toutes les six heures. 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 intégrer les événements utilisateur pour pouvoir consulter leurs données analytiques.

Les événements utilisateur que vous importez ont une incidence sur les analyses 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 "view-item" Obligatoire pour le taux de clics.
• Événements "Media-complete" : Obligatoire pour le taux de lecture complète par lecture et le taux de lecture complète par recommandation.
• Événements de lecture de contenu multimédia : Obligatoire pour le nombre de lectures de contenus recommandés, le taux de lecture complète, le taux de lecture complète par lecture et la durée moyenne de visionnage par lecture.

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

• Recherchez des événements. Obligatoire pour le taux de clics.
• Événements "view-item" 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 à Vertex AI 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 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 pour pouvoir filtrer les métriques d'é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 demandes de recherche. Pour permettre aux applications d'IA 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 SearchRequest.UserPseudoId.

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

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

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

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

   AI Applications

2. Cliquez sur le nom de l'application dont 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 :

   • Période Sélectionnez une plage de dates prédéfinie ou, si disponible, saisissez une plage de dates personnalisée.
   • Type d'appareil Sélectionnez un type d'appareil sur lequel les requêtes ont été effectuées.

Afficher les données analytiques sur la recherche

Suivez les instructions ci-dessous pour afficher les données analytiques des applications de recherche.

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

   AI Applications

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

3. Cliquez sur Analytics.

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

   • Par recherche : Les métriques sont regroupées par recherche. Pour la recherche médicale, il s'agit du seul groupe de métriques disponible.
   • 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é de celles 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 plages horaires ne peuvent pas se chevaucher.

5. Pour filtrer vos métriques, spécifiez les filtres, puis cliquez sur le bouton 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 plage de dates prédéfinie ou, si disponible, 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 les requêtes ont été effectuées.

   Pour les applications de recherche dans le domaine de la santé, les filtres suivants sont disponibles :

   • Période Sélectionnez une plage de dates prédéfinie ou, si disponible, saisissez une plage de dates 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-8: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 services de santé défini dans la demande de recherche. Ce filtre n'est disponible que s'il a été défini dans la demande de recherche.
   • Rôle utilisateur : Sélectionnez la catégorie de poste de l'utilisateur qui a envoyé la demande de recherche. Ce filtre n'est disponible que s'il a été défini dans la demande de recherche.
   • Paramètre utilisateur : Sélectionnez le paramètre de soins de santé défini dans la demande de recherche, tel que le traitement en hospitalisation, en ambulatoire ou hybride. Ce filtre n'est disponible que s'il a été défini dans la demande de recherche.

Définitions des métriques

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

Métriques des 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 les é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 "Afficher l'article" qui peuvent être attribués à une recommandation.
Nombre de recommandations de contenus multimédias appliquées	Nombre de fois où les éléments multimédias recommandés ont été lus jusqu'à la fin
Taux de lecture 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 en entier / nombre de fois où les éléments multimédias ont été lus
Durée moyenne de visionnage par lecture	Temps de lecture (en secondes) des éléments multimédias recommandés / Nombre de lectures des éléments multimédias recommandés
Taux d'achèvement par recommandation	Nombre de fois où les éléments multimédias ont été lus en entier / 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 média et de recherche personnalisées

Nom de la métrique	Définition des métriques	Remarques
Nombre de recherches	Nombre d'événements de recherche	D'après les journaux de recherche.
Taux d'absence de résultat	Nombre d'événements de recherche sans résultat/Nombre de recherches	D'après les journaux de recherche.
Taux de clics (CTR) par recherche	Nombre de clics sur les résultats de recherche/Nombre de recherches	Les clics sur les résultats de recherche sont des événements "Afficher l'article" 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" pour 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 raisons pour lesquelles les utilisateurs n'aiment pas 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 prend fin après 30 minutes d'inactivité. Basé sur les journaux de recherche.
Page vue par visite de recherche	Nombre d'événements view_item dans les sessions de recherche / Nombre de sessions de recherche	Cette métrique inclut toutes les pages vues lors des visites issues de la recherche, qu'elles puissent ou non être attribuées à Vertex AI 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 est parti 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 dans le secteur de la santé.

Nom de la métrique	Définition des métriques	Remarques
Nombre de recherches	Nombre d'événements de recherche
Nombre de résultats	Nombre d'événements de recherche sans résultat
Taux d'absence de résultat 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	Les résultats sont dédupliqués 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 pour la recherche	Vous pouvez envoyer un ID de session dans votre recherche. Pour en savoir plus, consultez la page session.
Rechercher le nombre de visiteurs	Nombre d'utilisateurs ayant envoyé une demande de recherche	Les utilisateurs sont comptabilisés en fonction du champ userInfo.
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 prend fin après 30 minutes d'inactivité.

Désactiver les données d'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 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 d'analyse de recherche.