Afficher et exporter des données analytiques

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 rechercher des informations 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 éléments) attribuables à Google en incluant l'élément 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 Google et renvoyés avec chaque requête de recherche. Veillez à inclure ce jeton d'attribution sous la forme UserEvent.attributionToken dans 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.

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  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 :

    • 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 liées aux agents intégrés, comme Deep Research, Idea Forge et les agents personnalisés.
    • Valeur : métriques sur les économies réalisées par les utilisateurs qui interrogent des données avec l'application.
    Consultez les données analytiques sur l'adoption.
    Afficher les données analytiques sur l'adoption

  5. 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 revenus 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 pas au cours de la période de sept jours actuelle.
Taux de fidélisation à 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 répondu 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 le Réseau de 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 au cours du dernier mois calendaire.
Sessions de chat mensuelles avec un agent Nombre total de sessions de chat initiées par les utilisateurs interagissant avec un agent spécifique au cours du mois civil précédent. 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 ultérieur, il s'agira d'une nouvelle session.
Agents mensuels utilisés Nombre total d'agents ayant eu au moins un utilisateur actif au cours du dernier mois calendaire.
Nombre total de sessions de chat mensuelles Nombre total de sessions de chat initiées par les utilisateurs interagissant avec les agents au cours du mois civil précédent. 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 ultérieur, il s'agira d'une nouvelle session.
Agents créés par mois Nombre total d'agents créés au cours du dernier mois calendaire.
Valeur
(aperçu public)
Recherche réussie Nombre de recherches réussies. 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 :
  • Si un utilisateur clique sur un résultat de recherche avant de lancer une nouvelle recherche.
  • Si la réponse à une recherche inclut un résultat de recherche de personnes et n'est pas suivie d'une autre recherche dans les deux minutes. En effet, les résultats de recherche de personnes s'affichent sur la page de résultats de recherche et ne nécessitent généralement pas de clic.
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.
  • Si l'utilisateur aime la réponse, la requête est considérée comme réussie.
  • Si l'utilisateur ne fournit aucun commentaire et ne pose pas d'autre question dans les 30 secondes, la requête est considérée comme réussie.
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 gagnées au cours des dates sélectionnées × Tarif horaire moyen des employés Pour afficher cette métrique, dans l'onglet Valeur, spécifiez un taux horaire dans le champ Taux horaire de l'employé.
Projection des heures annuelles gagnées par les employés (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 plage de dates choisie. Chaque requête permet d'économiser environ trois minutes, selon les études internes de Google.
Valeur annuelle projetée économisée 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 de l'employé.

Exporter les métriques

Pour exporter les métriques vers une table BigQuery dans votre projetGoogle Cloud , procédez comme suit :

  1. Vérifiez que vous disposez des autorisations et des rôles requis.

  2. Créez un ensemble de données BigQuery :

    1. Ouvrez la page BigQuery dans la console Google Cloud .

      Accéder à la page "BigQuery"

    2. Dans le panneau Explorateur, sélectionnez le même projet que celui dans lequel se trouve votre application Gemini Enterprise pour créer l'ensemble de données.

    3. Cliquez sur l'option , puis sur Créer un ensemble de données.

    4. 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 :

        Zone multirégionale 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)

    5. Cliquez sur Créer un ensemble de données.

  3. Créez une table BigQuery vide pour l'ensemble de données que vous avez créé.

    1. Dans le panneau Explorateur, développez votre projet, puis sélectionnez l'ensemble de données que vous avez créé.
    2. Dans la section Informations sur l'ensemble de données, cliquez sur Créer une table.
    3. 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.
    4. Cliquez sur Créer une table.

  4. Appelez la méthode analytics:exportMetrics pour 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-Unis
      • eu- pour la multirégion de l'UE
      • global- pour l'emplacement "Global"
      Pour en savoir plus, consultez Spécifier une multirégion pour votre datastore.
    • LOCATION : région multirégionale de votre data store : global, us ou eu
    • PROJECT_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"
   }
}

  5. 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-Unis
      • eu- pour la multirégion de l'UE
      • global- pour l'emplacement "Global"
      Pour en savoir plus, consultez Spécifier une multirégion pour votre datastore.
    • LOCATION : région multirégionale de votre data store : global, us ou eu
    • APP_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.