Nota: Se cambiará el nombre de Vertex AI Search por Agent Search. Estamos en proceso de actualizar el contenido para reflejar el nuevo desarrollo de la marca.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 información sobre las tendencias de uso, la calidad de la búsqueda y las recomendaciones, y la participación del usuario final de tu app. La consola de Agent Search proporciona una experiencia de panel interactivo con la tecnología de Looker.

Para apps de recomendaciones de contenido multimedia: Versión preliminar pública. Puedes ver las métricas por recomendación basadas en los eventos de los usuarios. Puedes filtrar las métricas por período y tipo de dispositivo.
Para apps de búsqueda personalizada y de contenido multimedia: Puedes ver las métricas por búsqueda y las métricas por sesión de búsqueda basadas en los registros de búsqueda y los eventos de los usuarios. Puedes filtrar las métricas por período, consulta 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 basadas en los registros de búsqueda.

Las métricas se actualizan aproximadamente cada seis horas, por lo que pueden pasar varias horas antes de que puedas usar la página Estadísticas después de crear tu app.

Fuentes de datos para estadísticas

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

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

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

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

Eventos de vista de elemento (obligatorio para la tasa de clics)
Eventos de contenido multimedia completado (obligatorio para la tasa de vistas completas por reproducción y la tasa de vistas completas por recomendación)
Eventos de reproducción de contenido multimedia (obligatorio para el recuento de reproducciones de contenido multimedia de recomendación, la tasa de vistas completas, la tasa de vistas completas por reproducción y el tiempo de reproducción promedio por reproducción)

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

Eventos de búsqueda (obligatorio para la tasa de clics)
Eventos de vista de elemento (obligatorio para la tasa de clics)

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

Impresiones : Puedes proporcionar impresiones (vistas o clics de elementos) que se puedan atribuir a Agent Search 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 Agent Search y que se devuelven 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 publica una búsqueda. Solo se usan los eventos de usuario con un token de atribución generado por Google para calcular las métricas.
Agente de usuario : 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 solicitudes de búsqueda. Para permitir que Agent Search identifique las sesiones de usuario de modo que pueda ofrecer estadísticas por sesión y resultados de búsqueda de mayor calidad, Google recomienda que establezcas el campo opcional field userPseudoId.

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

Cómo ver las estadísticas de recomendaciones de contenido multimedia

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

En la Google Cloud consola de, ve a la página AI Applications.

AI Applications
Haz clic en el nombre de la app de la que quieres ver las estadísticas.
Haz clic en Analytics.
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

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

En la Google Cloud consola de, ve a la página AI Applications.

AI Applications
Haz clic en el nombre de la app de la que quieres ver las estadísticas.
Haz clic en Analytics.
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 de referencia se muestran junto con las métricas de un período de comparación. Selecciona períodos para las métricas de referencia (un período anterior) y las métricas de comparación (un período posterior). Estos períodos no pueden superponerse.
Para filtrar tus métricas, especifica los filtros y, luego, haz clic en el botón Actualizar para aplicarlos.

Para las apps de contenido multimedia y las apps de búsqueda personalizada, 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.
Para 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 estableció en la solicitud de búsqueda. Este filtro solo está disponible si se estableció 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 estableció en la solicitud de búsqueda.
- Configuración del usuario : Selecciona la configuración de atención médica establecida en la solicitud de búsqueda, como tratamiento para pacientes hospitalizados, ambulatorios o híbridos. Este filtro solo está disponible si se estableció 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 de contenido multimedia recomendados
Recuento de clics de recomendaciones	Cantidad de veces que se hizo clic en los elementos de contenido multimedia recomendados
Tasa de clics	Cantidad de clics de recomendaciones / recuento de recomendaciones	Los clics de recomendaciones son eventos de vista de elemento que se pueden atribuir a una recomendación.
Recuento de contenido multimedia completado de recomendaciones	Cantidad de veces que se reprodujeron los elementos de contenido multimedia recomendados hasta completarse
Tasa de vistas completas por recomendación	Cantidad de veces que se reprodujeron los elementos multimedia recomendados / recuento de recomendaciones
Tasa de vistas completas por reproducción	Cantidad de veces que se reprodujeron los elementos de contenido multimedia recomendados hasta completarse / cantidad de veces que se reprodujeron los elementos de contenido multimedia
Tiempo de reproducción promedio por reproducción	Tiempo en segundos que se reprodujeron los elementos de contenido multimedia recomendados / cantidad de veces que se reprodujeron los elementos de contenido multimedia recomendados
Tasa de vistas completas por recomendación	Cantidad de veces que se reprodujeron los elementos multimedia hasta completarse / recuento de recomendaciones
Tiempo de reproducción promedio por recomendación	Tiempo en segundos que se miraron los elementos multimedia recomendados / recuento de recomendaciones

Métricas de búsqueda personalizada y de contenido multimedia

Nombre de la métrica	Definición de la métrica	Notas
Recuento de búsquedas	Cantidad de eventos de búsqueda	Basado en registros de búsqueda
Tasa sin resultado	Cantidad de eventos de búsqueda sin resultados/recuento de búsquedas	Basado en registros de búsqueda
Tasa de clics (CTR) por búsqueda	Cantidad de clics de búsqueda/recuento 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. Basado en eventos de usuario
Recuento de Me gusta y No me gusta de comentarios	Cantidad de Me gusta y No me gusta	Un registro de las respuestas de comentarios de Me gusta/No me gusta que enviaron los usuarios de la app
Desglose de los motivos de No me gusta de comentarios	Porcentaje de los motivos de No me gusta	Cuando a un usuario no le gusta una respuesta generada, puede seleccionar varios motivos para explicar su disgusto. El porcentaje muestra la frecuencia con la que se seleccionó cada motivo.
Recuento de sesiones de búsqueda	Cantidad de sesiones de búsqueda	Una sesión de búsqueda es una sesión de usuario que contiene al menos un evento de búsqueda. Una sesión de usuario, también llamada visita, es un conjunto continuo de eventos de usuario. Cuando hay 30 minutos de inactividad, la sesión finaliza. Basado en 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 / recuento de sesiones de búsqueda	Esta métrica incluye todas las vistas de página en visitas de búsqueda, independientemente de si se pueden atribuir a Agent Search. Basado en eventos de usuario
Porcentaje de rebote	Cantidad de rebotes en sesiones de búsqueda/recuento de sesiones de búsqueda	Un rebote de sesión de búsqueda se define como una sesión con una sola búsqueda, en la que el usuario se fue después de realizar solo una búsqueda. Basado en eventos de usuario

Métricas de búsqueda de atención médica

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 la métrica	Notas
Recuento de búsquedas	Cantidad de eventos de búsqueda
Recuento de búsquedas sin resultados	Cantidad de eventos de búsqueda sin resultados
Tasa sin resultado por búsqueda	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	Esto se anula por usuario de búsqueda, pero no por paciente. Por ejemplo, si el usuario 1 busca los pacientes A y B, y el usuario 2 busca solo el paciente B, el recuento es de tres.
Recuento de sesiones de búsqueda de clientes	Cantidad de sesiones definidas por el usuario de búsqueda	Puedes enviar un ID de sesión en tu búsqueda. Para obtener más información, consulta `session`.
Recuento de visitantes de 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éticas	Cantidad de sesiones de búsqueda definidas por Google	Una sesión de búsqueda es una sesión de usuario que contiene al menos un evento de búsqueda. Una sesión de usuario, también llamada visita, es un conjunto continuo de eventos de usuario. Cuando hay 30 minutos de inactividad, la sesión finaliza.

Cómo desactivar las estadísticas

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

Sigue las instrucciones de REST en Crea 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.