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 voir par recommandation basées sur les événements utilisateur. Vous pouvez filtrer les métriques par période et type d'appareil.
- Pour les applications de recherche génériques et de recherche de médias: vous pouvez consulter les métriques par recherche. et par session de recherche basées sur les journaux de recherche et les é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. Plusieurs heures peuvent donc s'écouler avant vous pouvez 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 d'analyse 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 ont une incidence sur 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 type "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.
- Afficher les événements d'élément : 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.Documentslors de l'ingestion des événements utilisateur. Ces informations sont nécessaires à l'attribution et au calcul des métriques par recherche. - Jetons d'attribution : Les jetons d'attribution sont des identifiants uniques générés par
Vertex AI Search et renvoyés avec chaque requête de recherche. Assurez-vous que
d'inclure ce jeton d'attribution en tant que
UserEvent.attributionTokenavec n'importe quelle 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.userAgentavec 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 des recommandations de médias
Suivez les instructions ci-dessous pour consulter les données analytiques des recommandations de médias.
Dans la console Google Cloud, accédez à la page Agent Builder.
Cliquez sur le nom de l'application dont vous souhaitez consulter les données analytiques.
Cliquez sur Analytics.
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, si elle est disponible, saisissez une plage de dates personnalisée.
- Type d'appareil Sélectionnez le type d'appareil sur lequel ont eu lieu les requêtes.
Afficher les données analytiques sur les recherches
Suivez les instructions ci-dessous pour afficher les données analytiques d'une recherche générique ou d'un média rechercher des applications.
Dans la console Google Cloud, accédez à la page Agent Builder.
Cliquez sur le nom de l'application pour laquelle vous souhaitez afficher les données analytiques.
Cliquez sur Analytics.
Cliquez sur un onglet pour afficher ce groupe de métriques:
- Par recherche Les métriques sont regroupées par recherches.
- Par session : Les métriques sont regroupées par sessions de recherche.
- Comparer Les métriques de référence s'affichent à côté des métriques période de comparaison. Sélectionnez des plages de dates pour les métriques de référence (une période antérieure) et des métriques de comparaison (période ultérieure). Ces les périodes ne peuvent pas se chevaucher.
Pour filtrer vos métriques, spécifiez l'un des filtres suivants, puis cliquez sur à l'aide du bouton Actualiser:
- 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 la valeur de la requête de recherche. Vous pouvez ajouter plusieurs filtres de requête de recherche. Disponible pour les valeurs Par recherche et Comparez les métriques.
- Type d'appareil Sélectionnez le type d'appareil sur lequel ont eu lieu les requêtes.
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 recommandées | Nombre de fois où les éléments multimédias recommandés ont été lus | |
| Nombre de clics sur la recommandation | Nombre de clics 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 d'affichage pouvant être attribués à une recommandation |
| Nombre de recommandations multimédias terminées | Nombre de fois où des é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 jusqu'à la fin / nombre de fois où les éléments multimédias ont été lus | |
| Durée moyenne de visionnage par lecture | Durée de lecture des éléments multimédias recommandés / Nombre de fois où les éléments multimédias recommandés ont été lus, en secondes | |
| Taux de lecture complète par recommandation | Nombre de lectures complètes des éléments multimédias / 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 | Notes |
|---|---|---|
| Nombre de recherches | Nombre d'événements de recherche | Basé sur les journaux de recherche |
| Taux de résultats sans résultat | Nombre d'événements de recherche sans résultats / Nombre de recherches | Basé sur les 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 visionnage d'éléments 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 session utilisateur contenant au moins un événement de recherche. A session utilisateur, appelée "visite", est une ensemble continu d'utilisateurs événements. Lorsqu’il y a 30 minutes de l'inactivité, à la fin de la session. Basé sur les journaux de recherche |
| Page vue par recherche consultez | Nombre d'éléments "view" événements dans la recherche sessions / recherche nombre de sessions | Cette métrique inclut toutes les pages vues en visites avec recherche que ce soit on peut les attribuer à Vertex AI Search. 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 |