Ver análisis

En esta página, se describe cómo ver las estadísticas de tus apps de búsqueda y de recomendaciones de contenido multimedia.

Las estadísticas te brindan estadísticas sobre las tendencias de uso, la calidad de la búsqueda y las recomendaciones, y la participación de los usuarios finales de tu app. La consola de Vertex AI Agent Builder proporciona una experiencia de panel interactivo potenciada por Looker.

• Para apps de recomendaciones de contenido multimedia: Versión preliminar pública. Puedes ver las métricas por recomendación según los eventos del usuario. Puedes filtrar las métricas por período y tipo de dispositivo.
• En el caso de las apps de búsqueda genérica y de búsqueda de contenido multimedia, puedes ver las métricas por búsqueda y por sesión de búsqueda según los registros de búsqueda y los eventos del usuario. Puedes filtrar las métricas por período, búsqueda y tipo de dispositivo.

Las métricas se actualizan aproximadamente cada 6 horas, por lo que puede tardar varias horas en poder usar la página Analytics después de crear tu app.

Fuentes de datos para las estadísticas

En esta sección, se describen las fuentes de datos de las estadísticas según el tipo de app.

Debes completar la integración de eventos del usuario para poder ver las estadísticas de eventos del usuario.

Los eventos de usuario que subas afectarán a las estadísticas que se generen.

Las apps de recomendaciones de contenido multimedia requieren los siguientes eventos del usuario para ver algunas métricas:

• Eventos de vista de elementos. Obligatorio para la tasa de clics.
• Eventos de reproducción completa de contenido multimedia. Obligatorio para el porcentaje de finalización por reproducción y el porcentaje de finalización por recomendación.
• Eventos de reproducción de contenido multimedia. Obligatorio para el recuento de reproducciones de contenido multimedia de las recomendaciones, la tasa de reproducción, la tasa de finalización por reproducción y el tiempo de reproducción promedio por reproducción.

Las aplicaciones de búsqueda requieren los siguientes eventos del usuario para ver algunas métricas:

• Buscar eventos. Obligatorio para la tasa de clics.
• Eventos de vista de elementos. Obligatorio para la tasa de clics.

La siguiente información también se usa para algunas estadísticas:

• Impresiones: Puedes proporcionar impresiones (vistas de elementos o clics) que se puedan atribuir a la Búsqueda de Vertex AI si incluyes el elemento asociado en UserEvent.Documents cuando transfieres eventos de usuario. Esta información es necesaria para la atribución y para calcular las métricas por búsqueda.
• Tokens de atribución: Los tokens de atribución son IDs únicos que genera la búsqueda de Vertex AI y se muestran con cada solicitud de búsqueda. Asegúrate de incluir ese token de atribución como UserEvent.attributionToken con cualquier evento de usuario que resulte de una búsqueda. Esto es necesario para identificar si la API entrega una búsqueda. Solo se usan los eventos del usuario con un token de atribución generado por Google para calcular las métricas.
• Usuario-agente. Incluye UserInfo.userAgent con los eventos de usuario para que puedas filtrar las métricas de eventos de usuario por tipo de dispositivo.

Registros de búsqueda

Las apps de búsqueda usan registros de búsqueda como fuentes de datos para algunas métricas.

Los registros de búsqueda se basan en las solicitudes de búsqueda. Para permitir que Vertex AI Agent Builder identifique las sesiones del usuario, de modo que pueda proporcionar estadísticas por sesión y resultados de la búsqueda de mayor calidad, Google recomienda que configures el campo opcional SearchRequest.UserPseudoId.

Si aún no hay registros de búsqueda ni eventos del usuario, se muestran los valores predeterminados para todas las métricas.

Consulta las estadísticas de las recomendaciones multimedia

Nota: Las estadísticas de recomendaciones de contenido multimedia se encuentran en versión preliminar pública.

Usa las siguientes instrucciones para ver las estadísticas de las recomendaciones de contenido multimedia.

1. En la consola de Google Cloud, ve a la página Agent Builder.

   Agent Builder

2. Haz clic en el nombre de la app de la que quieres ver las estadísticas.

3. Haz clic en Analytics.

4. Para filtrar tus métricas, especifica cualquiera de los siguientes filtros y, luego, haz clic en el botón Actualizar para aplicarlos:

   • Período: Selecciona un período predeterminado o, si está disponible, ingresa un período personalizado.
   • Tipo de dispositivo. Selecciona el tipo de dispositivo en el que se realizaron las consultas.

Consulta las estadísticas de búsqueda

Notas:

• En el caso de los almacenes de datos en las multirregiones de EE.UU. y la UE, la visualización de las estadísticas de búsqueda está en versión preliminar pública.
• Las estadísticas de búsqueda son GA para los almacenes de datos globales.
• Las métricas del widget no aparecen en la página Analytics.

Usa las siguientes instrucciones para ver las estadísticas de las apps de búsqueda genérica o de búsqueda de contenido multimedia.

1. En la consola de Google Cloud, ve a la página Agent Builder.

   Agent Builder

2. Haz clic en el nombre de la app de la que quieres ver las estadísticas.

3. Haz clic en Analytics.

4. Haz clic en una pestaña para ver ese grupo de métricas:

   • Por búsqueda. Las métricas se agrupan por búsquedas.
   • Por sesión: Las métricas se agrupan por sesiones de búsqueda.
   • Comparar. Las métricas del modelo de referencia se muestran junto con las métricas de un período de comparación. Selecciona los períodos para las métricas del modelo de referencia (un período anterior) y las métricas de comparación (un período posterior). Estos intervalos de tiempo no se pueden superponer.

5. Para filtrar tus métricas, especifica cualquiera de los siguientes filtros y, luego, haz clic en el botón Actualizar para aplicarlos:

   • Período: Selecciona un período predeterminado o, si está disponible, ingresa un período personalizado.
   • Búsqueda: Selecciona una condición y un valor de búsqueda. Puedes agregar varios filtros de búsqueda. Disponible para las métricas Por búsqueda y Comparar.
   • Tipo de dispositivo. Selecciona el tipo de dispositivo en el que se realizaron las consultas.

Definiciones de las métricas

En las siguientes tablas, se describe cómo se definen las métricas.

Métricas de recomendaciones de contenido multimedia

Nombre de la métrica	Definición de la métrica	Notas
Recuento de recomendaciones	Cantidad total de recomendaciones
Recuento de reproducciones de recomendaciones	Cantidad de veces que se reprodujeron los elementos multimedia recomendados
Cantidad de clics en la recomendación	Cantidad de veces que se hizo clic en los elementos multimedia recomendados
Tasa de clics	Cantidad de clics en recomendaciones / cantidad de recomendaciones	Los clics de recomendación son eventos de vista de elemento que se pueden atribuir a una recomendación.
Cantidad de recomendaciones de contenido multimedia completadas	Cantidad de veces que se reprodujeron por completo los elementos multimedia recomendados
Porcentaje de reproducción por recomendación	Cantidad de veces que se reprodujeron los elementos multimedia recomendados / cantidad de recomendaciones
Tasa de vistas completas por reproducción	Cantidad de veces que se reprodujeron por completo los elementos multimedia recomendados / cantidad de veces que se reprodujeron los elementos multimedia
Tiempo de reproducción promedio por reproducción	Tiempo en segundos que se reprodujeron los elementos multimedia recomendados / cantidad de veces que se reprodujeron los elementos multimedia recomendados
Tasa de vistas completas por recomendación	Cantidad de veces que se reprodujeron los elementos multimedia hasta el final / cantidad de recomendaciones
Tiempo de reproducción promedio por recomendación	Tiempo en segundos que se miraron los elementos multimedia recomendados / cantidad de recomendaciones

Métricas de búsqueda

Nombre de la métrica	Definición de las métricas	Notas
Cantidad de búsquedas	Cantidad de eventos de búsqueda	Según los registros de búsqueda
Tasa sin resultado	Cantidad de eventos de búsqueda sin resultados/cantidad de búsquedas	Según los registros de búsqueda
Tasa de clics (CTR) por búsqueda	Cantidad de clics de búsqueda/cantidad de búsquedas	Los clics de búsqueda son eventos de vista de elemento que se pueden atribuir a un evento de búsqueda anterior. Según los eventos del usuario
Recuento de sesiones de búsqueda	Cantidad de sesiones de búsqueda	Una sesión de búsqueda es una sesión del usuario que contiene al menos un evento de búsqueda. Una sesión del usuario, también llamada visita, es un conjunto continuo de eventos del usuario. Cuando hay 30 minutos de inactividad, finaliza la sesión. Según los registros de búsqueda
Vistas de página por visita de búsqueda	Cantidad de eventos de vista de elemento en sesiones de búsqueda / cantidad de sesiones de búsqueda	Esta métrica incluye todas las vistas de página en las visitas de búsqueda, independientemente de si se pueden atribuir a la Búsqueda de Vertex AI. Según los eventos del usuario
Porcentaje de rebote	Cantidad de rebotes en sesiones de búsqueda/cantidad de sesiones de búsqueda	Una sesión de búsqueda con rebote se define como una sesión con una sola búsqueda, en la que el usuario salió después de realizar solo una búsqueda. Basado en eventos del usuario

Cómo desactivar las estadísticas

No puedes desactivar las estadísticas de una app existente, pero cuando creas una app, puedes optar por crearla con las estadísticas desactivadas.

Para crear una app de búsqueda que no recopile datos de estadísticas, sigue estos pasos:

1. Sigue las instrucciones de REST en Cómo crear una app de búsqueda y agrega lo siguiente al comando curl:

      "disableAnalytics": true
   

   Comando de ejemplo

   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
   }'
   
       

   Este comando crea una app que no recopilará datos de estadísticas de búsqueda.