Ver análisis

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

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.
• Para apps de búsqueda de atención médica: Versión preliminar pública. Puedes ver las métricas por búsqueda según los registros de búsqueda.

Las métricas se actualizan aproximadamente cada seis horas, por lo que pueden transcurrir varias horas antes de que puedas usar la página de 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 utiliza para algunas estadísticas:

• Impresiones: Puedes proporcionar impresiones (vistas o clics de artículos) que se puedan atribuir a Vertex AI Search si incluyes el artículo 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 están 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 un tipo de dispositivo en el que se realizaron las consultas.

Cómo ver 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 se encuentra en la versión preliminar pública.
• Debido a que Vertex AI Agent Builder para la búsqueda de atención médica solo proporciona servicios de búsqueda en la multirregión de EE.UU. ("us"), las estadísticas de la búsqueda de atención médica se encuentran en versión preliminar pública.
• Las estadísticas de búsqueda son GA para los almacenes de datos globales.
• De forma predeterminada, las métricas del widget no aparecen en la página Analytics. Para ver las métricas de los widgets, comunícate con tu equipo de Cuentas de Google y pídeles que te agreguen a la lista de entidades permitidas.

Usa las siguientes instrucciones para ver las estadísticas de las apps de búsqueda.

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. Para la búsqueda de atención médica, este es el único grupo de métricas disponible.
   • 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 los filtros y, luego, haz clic en el botón Actualizar para aplicarlos.

   En el caso de las apps de contenido multimedia y de búsqueda genérica, están disponibles los siguientes filtros:

   • 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 un tipo de dispositivo en el que se realizaron las consultas.

   En el caso de las apps de búsqueda de atención médica, están disponibles los siguientes filtros:

   • Período: Selecciona un período predeterminado o, si está disponible, ingresa un período personalizado. Cuando seleccionas una fecha específica para el período personalizado, esa fecha es la fecha en la que se realizó la búsqueda en la zona horaria UTC -08:00.
   • Búsqueda: Selecciona una condición y un valor de búsqueda. Puedes agregar varios filtros de búsqueda.
   • Ubicación del usuario: Selecciona la ubicación del hospital, la clínica o el proveedor de servicios de atención médica que se configuró en la solicitud de búsqueda. Este filtro solo está disponible si se configuró en la solicitud de búsqueda.
   • Rol del usuario: Selecciona la categoría de trabajo del usuario que envió la solicitud de búsqueda. Este filtro solo está disponible si se configuró en la solicitud de búsqueda.
   • Configuración del usuario: Selecciona el entorno de atención médica establecido en la solicitud de búsqueda, como tratamiento ambulatorio, hospitalario o híbrido. Este filtro solo está disponible si se configuró en la solicitud de búsqueda.

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 genérica y multimedia

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. Se basan en los eventos del usuario.

Métricas de búsqueda de servicios de salud

Las siguientes métricas de búsqueda están disponibles para las apps de búsqueda de atención médica.

Nombre de la métrica	Definición de las métricas	Notas
Cantidad de búsquedas	Cantidad de eventos de búsqueda
No hay recuento de resultados	Cantidad de eventos de búsqueda sin resultados
Porcentaje de búsquedas sin resultados	Cantidad de eventos de búsqueda sin resultados por búsqueda
Recuento de pacientes	Cantidad de IDs de pacientes para los que se realizaron búsquedas	Se eliminan las duplicaciones por usuario de búsqueda, pero no por paciente. Por ejemplo, si el usuario 1 busca a los pacientes A y B, y el usuario 2 solo busca al paciente B, el recuento es de tres.
Recuento de sesiones de búsqueda de clientes	Cantidad de sesiones de búsqueda definidas por el usuario	Puedes enviar un ID de sesión en tu búsqueda. Para obtener más información, consulte session.
Cantidad de visitantes de la búsqueda	Cantidad de usuarios que enviaron una solicitud de búsqueda	Los usuarios se registran según el campo userInfo.
Recuento de sesiones de búsqueda sintética	Cantidad de sesiones de búsqueda definidas por Google	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.

Cómo desactivar las estadísticas

No puedes desactivar las estadísticas de una app existente, pero cuando creas una app, puedes elegir 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.