Ver análisis

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

Las estadísticas te brindan información sobre las tendencias de uso, la calidad de las búsquedas y las recomendaciones, y la participación de los usuarios finales en tu app. La consola de AI Applications 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 las apps de búsqueda personalizada y de búsqueda de contenido multimedia: Puedes ver métricas por búsqueda y por sesión de búsqueda basadas en registros de búsqueda y eventos de los usuarios. 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 cada seis horas aproximadamente, por lo que pueden pasar varias horas antes de que puedas usar la página Analytics después de crear tu app.

Fuentes de datos para el análisis

En esta sección, se describen las fuentes de datos para 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 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 elemento. Es obligatorio para la tasa de clics.
• Eventos de finalización de medios. Se requiere 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. Se requiere para el recuento de reproducciones de contenido multimedia de recomendaciones, la tasa de reproducciones, la tasa de finalización por reproducción y el tiempo de reproducción promedio por reproducción.

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

• Buscar eventos. Es obligatorio para la tasa de clics.
• Eventos de vista de elemento. Es obligatorio para la tasa de clics.

La siguiente información también se usa para algunos análisis:

• Impresiones Puedes proporcionar impresiones (vistas o clics en elementos) que se puedan atribuir a Vertex AI Search si incluyes el elemento asociado en UserEvent.Documents cuando transfieras eventos del 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 Vertex AI Search 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 se genere a partir de una búsqueda. Esto es necesario para identificar si la API publica 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 los 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 las aplicaciones basadas en IA identifiquen las sesiones de los usuarios y, de esta manera, puedan proporcionar estadísticas por sesión y resultados de búsqueda de mayor calidad, Google recomienda que establezcas 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 de contenido multimedia

Sigue estas instrucciones para ver las estadísticas de las recomendaciones de contenido multimedia.

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

   Aplicaciones basadas en IA

2. Haz clic en el nombre de la app para 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 búsquedas.

Cómo ver las estadísticas de búsqueda

Sigue estas instrucciones para ver las estadísticas de las apps de búsqueda.

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

   Aplicaciones basadas en IA

2. Haz clic en el nombre de la app para 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 de referencia se muestran junto con las métricas de un período de comparación. Selecciona los períodos para las métricas de referencia (un período anterior) y las métricas de comparación (un período posterior). Estos intervalos de tiempo no pueden superponerse.

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 las apps de búsqueda personalizadas, 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 búsquedas.

   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 -8.
   • 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 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 hospitalario, ambulatorio 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 la recomendación	Cantidad de veces que se reprodujeron los elementos multimedia recomendados
Recuento de clics en recomendaciones	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 en recomendaciones 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 los elementos multimedia recomendados hasta el final
Porcentaje de reproducciones 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 los elementos multimedia recomendados hasta el final / 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 / 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 medios y de búsqueda personalizadas

Nombre de la métrica	Definición de 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 en la búsqueda son eventos de vista de elemento que se pueden atribuir a un evento de búsqueda anterior. Se basa en los eventos del usuario.
Cantidad de Me gusta y No me gusta en los comentarios	Recuento de Me gusta y No me gusta	Es un registro de las respuestas de comentarios de Me gusta y No me gusta que envían los usuarios de la app.
Desglose de los motivos de los comentarios negativos	Porcentaje de los motivos de los "No me gusta"	Cuando un usuario indica que no le gusta una respuesta generada, puede seleccionar varios motivos para explicar su opinión. 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 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. La sesión finaliza cuando hay 30 minutos de inactividad. Se basa en 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 páginas vistas en las visitas de búsqueda, independientemente de si se pueden atribuir a Vertex AI Search. Se basa en los eventos del usuario.
Porcentaje de rebote	Cantidad de rebotes en sesiones de búsqueda/cantidad de sesiones de búsqueda	Se define un rebote de sesión de búsqueda como una sesión con una sola búsqueda, en la que el usuario se fue después de realizar solo una búsqueda. Se basa en 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 métricas	Notas
Cantidad de búsquedas	Cantidad de eventos de búsqueda
Sin recuento de resultados	Cantidad de eventos de búsqueda sin resultados
Tasa 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 anula la duplicación por usuario de la búsqueda, pero no por paciente. Por ejemplo, si el usuario 1 busca los pacientes A y B, y el usuario 2 busca solo al paciente B, el recuento es tres.
Recuento de sesiones de búsqueda de clientes	Cantidad de sesiones definidas por el usuario de la búsqueda	Puedes enviar un ID de sesión en tu búsqueda. Para obtener más información, consulte session.
Cantidad de visitantes que realizaron búsquedas	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 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. La sesión finaliza cuando hay 30 minutos de inactividad.

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 análisis, sigue estos pasos:

1. 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 análisis de búsqueda.