Les données analytiques vous permettent de mieux comprendre les tendances d'utilisation, la qualité de la recherche et l'engagement des utilisateurs finaux de votre application. La console fournit un tableau de bord interactif alimenté par Looker. Cette page explique comment afficher les données analytiques de vos applications.
Avant de commencer
Assurez-vous que votre application est connectée à un data store. Les métriques d'application ne sont disponibles qu'à partir du moment où un data store est associé à une application.
Si vous n'avez pas de data store, vous devez associer une source de données Google ou une source de données tierce à votre application.
Événements utilisateur pour Analytics
Cette section décrit les événements utilisateur que Gemini Enterprise utilise pour générer les métriques liées à la recherche, telles que le nombre de recherches et le taux de clics. Aucune configuration supplémentaire n'est requise si vous utilisez l'interface utilisateur pour effectuer des recherches et obtenir des réponses via l'assistant Gemini Enterprise. Toutefois, si vous utilisez les API Gemini Enterprise dans vos propres applications, vous devez configurer la recherche dans votre application pour capturer les événements utilisateur, puis les importer dans votre application.
Les applications Gemini Enterprise nécessitent les événements utilisateur suivants pour obtenir les métriques :
- 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 les impressions (vues ou clics sur des articles) attribuables à Google en incluant l'article associé dans
UserEvent.Documentslors 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 Google et renvoyés avec chaque requête de recherche. Veillez à inclure ce jeton d'attribution sous la forme
UserEvent.attributionTokendans 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. - Journaux de recherche Les journaux de recherche sont basés sur les demandes de recherche. Pour permettre à Google 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 de journaux de recherche ni d'événements utilisateur, les valeurs par défaut sont affichées pour toutes les métriques.
Afficher les données analytiques Gemini Enterprise
Vous pouvez consulter les données analytiques de recherche pour votre application. Vous verrez les métriques liées aux appels de recherche effectués dans votre application. Si votre application est connectée à plusieurs magasins de données, il est recommandé d'effectuer des appels de recherche dans l'application en spécifiant la ressource engine afin d'obtenir des résultats de tous les magasins de données connectés.
Suivez les instructions ci-dessous pour afficher les données analytiques concernant votre application.
Dans la console Google Cloud , accédez à la page Gemini Enterprise.
Cliquez sur le nom de l'application dont vous souhaitez afficher les données analytiques.
Cliquez sur Analytics.
Cliquez sur un onglet pour afficher le groupe de métriques correspondant :
Adoption : métriques sur l'état d'adoption des utilisateurs.
Utilisation et qualité : métriques sur les commentaires des utilisateurs et l'utilisation de l'application.
Agent : métriques pour les agents dans l'application Web Gemini Enterprise, y compris les agents conçus par Google, NotebookLM Enterprise et les agents que votre organisation a créés et enregistrés avec Gemini Enterprise.
Valeur : métriques sur les économies réalisées par les utilisateurs qui interrogent des données avec l'application.
Niveau utilisateur : les métriques incluent les adresses e-mail des utilisateurs de l'organisation et leurs interactions avec les agents créés par Google et ceux que l'organisation a créés et enregistrés avec Gemini Enterprise.
Afficher les données analytiques sur l'adoption Pour filtrer vos métriques, spécifiez les filtres disponibles pour l'onglet "Métriques", puis cliquez sur le bouton Actualiser pour les appliquer.
Définitions des métriques
Le tableau suivant décrit la définition des métriques.
| Groupe de métriques | Nom de la métrique | Définition de la métrique | Remarques |
|---|---|---|---|
| Adoption | Utilisateurs actifs par jour | Nombre d'utilisateurs actifs par jour | Un utilisateur est considéré comme actif s'il se connecte et déclenche des appels d'API, par exemple lorsqu'il accède à la page d'accueil. |
| Utilisateurs actifs chaque semaine | Nombre d'utilisateurs actifs par semaine. La semaine commence le lundi et se termine le dimanche. | ||
| Utilisateurs actifs par mois | Nombre d'utilisateurs actifs par mois | ||
| Taux de fidélisation sur 7 jours | Nombre d'utilisateurs connus au cours de la période de sept jours actuelle / nombre d'utilisateurs actifs au cours de la période de sept jours précédente | Un utilisateur est considéré comme un utilisateur régulier s'il est actif au cours de la période de sept jours actuelle et de la période de sept jours précédente. | |
| Taux de croissance sur sept jours | Différence en pourcentage entre le nombre d'utilisateurs actifs au cours de la période de sept jours actuelle et celui de la période de sept jours précédente | ||
| Taux de désabonnement sur sept jours | Nombre d'utilisateurs ayant résilié leur abonnement au cours de la période de sept jours actuelle / nombre d'utilisateurs actifs au cours de la période de sept jours précédente | Un utilisateur est considéré comme perdu s'il était actif au cours de la période de sept jours précédente, mais ne l'est pas au cours de la période de sept jours actuelle. | |
| Taux de rétention à 28 jours | Nombre d'utilisateurs connus au cours de la période de 28 jours actuelle / nombre d'utilisateurs actifs au cours de la période de 28 jours précédente | ||
| Taux de croissance sur 28 jours | Différence en pourcentage entre le nombre d'utilisateurs actifs au cours de la période de 28 jours actuelle et celui de la période de 28 jours précédente | ||
| Taux de perte de clients sur 28 jours | Nombre d'utilisateurs ayant résilié leur abonnement au cours de la période de 28 jours actuelle / nombre d'utilisateurs actifs au cours de la période de 28 jours précédente | ||
| Licences achetées | Nombre de licences (places) achetées par l'organisation | Inclut tous les sièges achetés depuis l'inscription à Gemini Enterprise. | |
| Sièges revendiqués | Nombre de licences utilisateur attribuées à des personnes de votre organisation et acceptées par celles-ci | Inclut tous les sièges revendiqués depuis l'inscription à Gemini Enterprise. | |
| Utilisation et qualité | Nombre de recherches | Nombre total de recherches | |
| Nombre de réponses | Nombre total de requêtes auxquelles Gemini Enterprise a généré une réponse | Les réponses générées par un agent ne sont pas incluses dans ce nombre. | |
| Nombre d'actions | Nombre total de requêtes auxquelles Gemini Enterprise a répondu | Inclut des actions telles que la création d'un modèle d'e-mail. | |
| Taux de clics (CTR) par recherche | Nombre total de clics sur les résultats de recherche / nombre de recherches | Les clics sur la recherche incluent les clics sur les résultats de recherche et les références internes. | |
| Page vue par catégorie | Nombre total de vues pour chaque page de catégorie | ||
| Nombre de "J'aime" et "Je n'aime pas" pour les commentaires | Nombre de "J'aime" et de "Je n'aime pas" envoyés par les utilisateurs | Enregistrement des réponses aux commentaires (pouce vers le haut/pouce vers le bas) envoyées par les utilisateurs de l'application. | |
| Répartition des motifs de "Je n'aime pas" | 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 l'expliquer. Le pourcentage indique la fréquence à laquelle chaque motif a été sélectionné. | |
| Taux de réussite des recherches | Nombre de recherches fructueuses / nombre de recherches | ||
| Taux de réponse positive | Nombre de réponses correctes / Nombre de réponses | ||
| Agents | Utilisateurs actifs par mois (agents) | Nombre total d'utilisateurs actifs ayant utilisé l'agent par mois. | |
| Sessions de chat mensuelles avec un agent | Nombre total de sessions de chat initiées par les utilisateurs interagissant avec un agent spécifique par mois. | Une session de chat est définie comme une interaction d'un utilisateur avec un agent dans le même fil de discussion au cours d'une même journée. Si l'utilisateur poursuit la conversation dans le même fil de discussion un jour suivant, il s'agira d'une nouvelle session. | |
| Agents utilisés par mois | Nombre total d'agents ayant eu au moins un utilisateur actif par mois. | ||
| Nombre total de sessions de chat mensuelles | Nombre total de sessions de chat initiées par les utilisateurs interagissant avec les agents par mois. | Une session de chat est définie comme une interaction d'un utilisateur avec un agent dans le même fil de discussion au cours d'une même journée. Si l'utilisateur poursuit la conversation dans le même fil de discussion un jour suivant, il s'agira d'une nouvelle session. | |
| Agents créés par mois | Nombre total d'agents créés au cours du dernier mois calendaire. | ||
| Utilisateurs actifs par jour de NotebookLM Enterprise | Nombre d'utilisateurs actifs de NotebookLM Enterprise par jour. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Notebooks NotebookLM Enterprise créés par jour | Nombre de notebooks NotebookLM Enterprise créés par jour. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Notebooks NotebookLM Enterprise quotidiens créés par utilisateur | Nombre de notebooks NotebookLM Enterprise créés par utilisateur et par jour. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Notebooks NotebookLM Enterprise partagés par jour | Nombre de notebooks NotebookLM Enterprise partagés par jour. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Résumés audio quotidiens créés dans NotebookLM Enterprise | Nombre de résumés audio NotebookLM Enterprise créés par jour. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Utilisateurs actifs mensuels de NotebookLM Enterprise | Nombre d'utilisateurs actifs de NotebookLM Enterprise par mois. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Notebooks NotebookLM Enterprise créés par mois | Nombre de notebooks NotebookLM Enterprise créés par mois. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Notebooks mensuels NotebookLM Enterprise créés par utilisateur | Nombre moyen de notebooks NotebookLM Enterprise créés par utilisateur et par mois. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Notebooks NotebookLM Enterprise mensuels partagés | Nombre de notebooks NotebookLM Enterprise partagés par mois. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Résumés audio mensuels créés dans NotebookLM Enterprise | Nombre de résumés audio NotebookLM Enterprise créés par mois. | Les métriques NotebookLM Enterprise sont calculées au niveau du projet et non par moteur. | |
| Valeur (aperçu public) |
|||
| Recherche réussie | Nombre de recherches ayant abouti. |
Le nombre de recherches fructueuses est déterminé par le comportement de l'utilisateur après une recherche. Une recherche est considérée comme réussie si l'un des événements suivants se produit :
|
|
| Réponse réussie | Nombre de réponses positives |
Le succès d'une réponse est déterminé par le comportement de l'utilisateur après sa génération.
Le succès est mesuré par les commentaires fournis ou par la rapidité avec laquelle une question de suivi a été posée.
|
|
| Heures de travail économisées pour les dates sélectionnées | (Nombre de recherches réussies + Nombre de réponses réussies) x Minutes gagnées par réponse réussie | ||
| Valeur enregistrée pour les dates sélectionnées | Heures économisées au cours des dates sélectionnées × Taux horaire moyen des employés | Pour afficher cette métrique, dans l'onglet Valeur, spécifiez un taux horaire dans le champ Taux horaire des employés. | |
| Nombre d'heures annuelles économisées par les employés (estimation) | (Nombre de recherches réussies + Nombre de réponses réussies) x Minutes gagnées par recherche réussie | Le nombre annuel de recherches réussies projeté est dérivé du nombre de recherches réussies au cours de la période sélectionnée. Chaque requête permettrait de gagner trois minutes, selon les estimations basées sur les études internes de Google. | |
| Valeur annuelle prévue des économies | Nombre d'heures annuelles gagnées par les employés × Taux horaire moyen des employés | Pour afficher cette métrique, dans l'onglet Valeur, spécifiez un taux horaire dans le champ Taux horaire des employés. | |
| Par l'utilisateur | |||
| ID d'adresse e-mail de l'utilisateur | L'adresse e-mail de chaque utilisateur de votre organisation. | ||
| Nombre total de messages | Nombre total de messages envoyés par un utilisateur à l'application Web Gemini Enterprise. | Inclut tous les messages envoyés par l'utilisateur et ne se limite pas aux conversations avec les agents Gemini Enterprise. | |
| Messages aux agents conçus par Google | Nombre total de messages qu'un utilisateur a envoyés aux agents Google au cours de la période sélectionnée. | ||
| Messages à nos agents | Nombre total de messages qu'un utilisateur a envoyés à des agents créés par l'organisation et enregistrés avec Gemini Enterprise au cours de la période sélectionnée. | ||
Exporter les métriques
Pour exporter les métriques vers une table BigQuery dans votre projetGoogle Cloud , procédez comme suit :
Vérifiez que vous disposez des autorisations et des rôles requis.
- Vous devez disposer du rôle Lecteur Discovery Engine pour pouvoir appeler l'API.
- Autorisations requises pour créer un ensemble de données BigQuery
- Autorisations requises pour créer une table
Créez un ensemble de données BigQuery :
Ouvrez la page BigQuery dans la console Google Cloud .
Dans le panneau Explorateur, sélectionnez le projet dans lequel se trouve votre application Gemini Enterprise pour créer l'ensemble de données.
Cliquez sur l'option , puis sur Créer un ensemble de données.
Sur la page Créer un ensemble de données, procédez comme suit :
Pour ID de l'ensemble de données, indiquez un nom d'ensemble de données unique. Vous avez besoin du nom de l'ensemble de données pour exporter les métriques via l'API.
Pour Type d'emplacement, le tableau suivant montre comment mapper les emplacements BigQuery aux emplacements de l'application Gemini Enterprise :
Emplacement multirégional de l'application Gemini Enterprise Emplacement multi-régional BigQuery Monde États-Unis (plusieurs régions aux États-Unis) États-Unis (plusieurs régions aux États-Unis) États-Unis (plusieurs régions aux États-Unis) UE (plusieurs régions dans l'Union européenne) UE (plusieurs régions dans l'Union européenne)
Cliquez sur Créer un ensemble de données.
Créez une table BigQuery vide pour l'ensemble de données que vous avez créé.
- Dans le panneau Explorateur, développez votre projet, puis sélectionnez l'ensemble de données que vous avez créé.
- Dans la section Informations sur l'ensemble de données, cliquez sur Créer une table.
- Dans le panneau Créer une table, saisissez le nom de la table dans le champ Table. Vous avez besoin du nom de la table pour exporter les métriques via l'API.
- Cliquez sur Créer une table.
Appelez la méthode
analytics:exportMetricspour récupérer les données de métriques des 30 derniers jours, y compris le jour actuel.REST
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ -d '{ "analytics": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID", "outputConfig": { "bigqueryDestination": { "datasetId": "BIGQUERY_DATASET_ID", "tableId": "BIGQUERY_TABLE_ID" } } }' \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/analytics:exportMetrics"Remplacez les éléments suivants :
ENDPOINT_LOCATION: région multirégionale pour votre requête API. Attribuez l'une des valeurs suivantes :us-pour la multirégion des États-Uniseu-pour la multirégion de l'UEglobal-pour l'emplacement "Global"
LOCATION: région multirégionale de votre data store :global,usoueuPROJECT_ID: ID de votre projet Google Cloud .APP_ID: ID de l'application à partir de laquelle vous souhaitez exporter les métriques.BIGQUERY_DATASET_ID: ID de l'ensemble de données BigQuery que vous avez créé.
L'ID de l'ensemble de données est au format<PROJECT_ID>.<DATASET_ID>. Il vous suffit de fournir le<DATASET_ID>.BIGQUERY_TABLE_ID: ID de la table BigQuery que vous avez créée.
Dans la vue Explorateur classique, l'ID de table suit le format<PROJECT_ID>.<DATASET_ID>.<TABLE_ID>. Il vous suffit de fournir le<TABLE_ID>.
La réponse inclut le nom et l'ID de l'opération. Notez l'ID de l'opération pour l'utiliser à l'étape suivante.
Par exemple :{ "name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata" } }Pour afficher l'état de l'opération d'exportation des métriques, appelez la méthode
engines.operations.get:REST
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/operations/OPERATION_ID"Remplacez les éléments suivants :
ENDPOINT_LOCATION: région multirégionale pour votre requête API. Attribuez l'une des valeurs suivantes :us-pour la multirégion des États-Uniseu-pour la multirégion de l'UEglobal-pour l'emplacement "Global"
LOCATION: région multirégionale de votre data store :global,usoueuAPP_ID: ID de l'application dont vous souhaitez obtenir les opérations de longue durée.OPERATION_ID: ID de l'opération d'exportation des métriques renvoyé dans la réponse lorsque vous avez exécuté la commande d'exportation des métriques.