Ver la analítica

En esta página se describe cómo ver las analíticas de tus recomendaciones y aplicaciones de búsqueda.

Las analíticas te ofrecen información valiosa sobre las tendencias de uso, la calidad de las búsquedas y las recomendaciones, y la interacción de los usuarios finales con tu aplicación. La consola Aplicaciones de IA proporciona una experiencia de panel de control interactivo basada en Looker.

• Aplicaciones de recomendaciones de contenido multimedia: vista previa pública. Puede consultar métricas por recomendación basadas en eventos de usuario. Puede filtrar las métricas por intervalo de fechas y tipo de dispositivo.
• En el caso de las aplicaciones 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 usuario. Puede filtrar las métricas por periodo, consulta y tipo de dispositivo.
• Para aplicaciones de búsqueda de información sanitaria: vista previa pública. Puedes ver métricas por búsqueda basadas en 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 Analíticas después de crear tu aplicación.

Fuentes de datos para analíticas

En esta sección se describen las fuentes de datos de analíticas en función del tipo de aplicación.

Debe completar la integración de eventos de usuario para poder ver las analíticas de eventos de usuario.

Los eventos de usuario que suba afectarán a las analíticas que se generen.

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

• Eventos de visualización de artículos. Obligatorio para el porcentaje de clics.
• Eventos de finalización de contenido multimedia: Obligatorio para calcular 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 recomendado, la tasa de reproducción completa, la tasa de finalización por reproducción y el tiempo de visualización medio por reproducción.

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

• Buscar eventos. Obligatorio para el porcentaje de clics.
• Eventos de visualización de artículos. Obligatorio para el porcentaje de clics.

La siguiente información también se usa para algunas analíticas:

• Impresiones. Puede proporcionar impresiones (vistas o clics de artículos) que se puedan atribuir a la búsqueda de Vertex AI si incluye el artículo asociado en UserEvent.Documents al ingerir 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 generados por Vertex AI Search y devueltos 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 produzca como resultado de una búsqueda. Es necesario para identificar si una búsqueda se sirve mediante la API. Solo se usan los eventos de usuario con un token de atribución generado por Google para calcular las métricas.
• User-agent. Incluya UserInfo.userAgent con los eventos de usuario para poder filtrar las métricas de eventos de usuario por tipo de dispositivo.

Registros de búsqueda

Las aplicaciones de búsqueda usan los registros de búsqueda como fuentes de datos de algunas métricas.

Los registros de búsqueda se basan en las solicitudes de búsqueda. Para permitir que las aplicaciones de IA identifiquen las sesiones de los usuarios y puedan ofrecer analíticas por sesión y resultados de búsqueda de mayor calidad, Google recomienda que defina el campo opcional userPseudoId.

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

Ver las analíticas de las recomendaciones de contenido multimedia

Nota: Las analíticas de recomendaciones de contenido multimedia están en versión preliminar pública.

Sigue estas instrucciones para ver las analíticas de las recomendaciones de contenido multimedia.

1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

   Aplicaciones de IA

2. Haz clic en el nombre de la aplicación de la que quieras ver las analíticas.

3. Haz clic en Estadísticas.

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

   • Periodo Seleccione un periodo predefinido o, si está disponible, introduzca un periodo personalizado.
   • Tipo de dispositivo: Seleccione un tipo de dispositivo en el que se hayan producido las consultas.

Ver las analíticas de búsqueda

Notas:

• La vista previa pública de las analíticas de búsqueda está disponible para los almacenes de datos de las multirregiones de EE. UU. y la Unión Europea.
• Las aplicaciones de IA para la búsqueda en el ámbito sanitario solo proporcionan servicios de búsqueda en la multirregión de EE. UU. (`us`), por lo que las analíticas de la búsqueda en el ámbito sanitario están en Vista Previa Pública.
• Las analíticas 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, ponte en contacto con el equipo de tu cuenta de Google y pide que te añadan a la lista de permitidos.

Sigue estas instrucciones para ver las analíticas de las aplicaciones de búsqueda.

1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

   Aplicaciones de IA

2. Haz clic en el nombre de la aplicación de la que quieras ver las analíticas.

3. Haz clic en Estadísticas.

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

   • Por búsqueda. Las métricas se agrupan por búsquedas. En el caso de las búsquedas de temas relacionados con la salud, 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 la base se muestran junto con las métricas de un periodo de comparación. Selecciona los periodos de las métricas de referencia (un periodo anterior) y de las métricas de comparación (un periodo posterior). Estos intervalos de tiempo no se pueden solapar.

5. Para filtrar las métricas, especifique los filtros y, a continuación, haga clic en el botón Actualizar para aplicarlos.

   En el caso de las aplicaciones multimedia y de búsqueda personalizada, están disponibles los siguientes filtros:

   • Periodo Seleccione un periodo predefinido o, si está disponible, introduzca un periodo personalizado.
   • Consulta de búsqueda. Selecciona una condición y un valor de consulta de búsqueda. Puedes añadir varios filtros de consulta de búsqueda. Disponible para las métricas Por búsqueda y Comparar.
   • Tipo de dispositivo: Seleccione un tipo de dispositivo en el que se hayan producido las consultas.

   En las aplicaciones de búsqueda de asistencia sanitaria, están disponibles los siguientes filtros:

   • Periodo Seleccione un periodo predefinido o, si está disponible, introduzca un periodo personalizado. Cuando selecciona una fecha específica para un periodo personalizado, esa fecha es la fecha en la que se realizó la búsqueda en la zona horaria UTC-08:00.
   • Consulta de búsqueda. Selecciona una condición y un valor de consulta de búsqueda. Puedes añadir varios filtros de consulta de búsqueda.
   • Ubicación del usuario. Selecciona la ubicación del hospital, la clínica o el proveedor de servicios sanitarios que se haya indicado en la solicitud de búsqueda. Este filtro solo está disponible si se ha definido en la solicitud de búsqueda.
   • Rol de usuario Selecciona la categoría profesional del usuario que ha enviado la solicitud de búsqueda. Este filtro solo está disponible si se ha definido en la solicitud de búsqueda.
   • Configuración del usuario Selecciona el centro sanitario definido en la solicitud de búsqueda, como tratamiento hospitalario, ambulatorio o híbrido. Este filtro solo está disponible si se ha definido 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
Número de recomendaciones	Número total de recomendaciones
Número de reproducciones de la recomendación	Número de veces que se han reproducido los elementos multimedia recomendados.
Recuento de clics en recomendaciones	Número de veces que se ha hecho clic en los elementos multimedia recomendados.
Porcentaje de clics	Número de clics en recomendaciones/número de recomendaciones	Los clics en recomendaciones son eventos de vista de artículo que se pueden atribuir a una recomendación.
Número de medios de recomendación completados	Número de veces que se han reproducido hasta el final los elementos multimedia recomendados.
Tasa de finalización por recomendación	Número de veces que se han reproducido los elementos multimedia recomendados o número de recomendaciones
Porcentaje de visualizaciones completas por reproducción	Número de veces que se han reproducido hasta el final los elementos multimedia recomendados/número de veces que se han reproducido los elementos multimedia
Tiempo de visualización medio por reproducción	Tiempo en segundos que se han reproducido los elementos multimedia recomendados/número de veces que se han reproducido los elementos multimedia recomendados
Tasa de finalización por recomendación	Número de veces que se han reproducido los elementos multimedia hasta el final o número de recomendaciones
Tiempo de visualización medio por recomendación	Tiempo en segundos que se han visto los elementos multimedia recomendados/número de recomendaciones

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

Nombre de la métrica	Definición de las métricas	Notas
Recuento de búsquedas	Número de eventos de búsqueda	Según los registros de búsqueda.
Sin resultados	Número de eventos de búsqueda sin resultados/Número de búsquedas	Según los registros de búsqueda.
Porcentaje de clics (CTR) por búsqueda	Número de clics de búsqueda /Número de búsquedas	Los clics de búsqueda son eventos de vista de artículo que se pueden atribuir a un evento de búsqueda anterior. Basado en eventos de usuario.
Número de Me gusta y No me gusta	Número de Me gusta y No me gusta	Un registro de las respuestas de Me gusta/No me gusta enviadas por los usuarios de la aplicación.
Desglose de los motivos por los que no te gusta el contenido	Porcentaje de los motivos de no me gusta	Cuando a un usuario no le gusta una respuesta generada, puede seleccionar varios motivos para explicar por qué no le gusta. El porcentaje muestra la frecuencia con la que se ha seleccionado cada motivo.
Recuento de sesiones de búsqueda	Número 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. Si hay 30 minutos de inactividad, la sesión finaliza. Según los registros de búsqueda.
Vista de página por visita de búsqueda	Número de eventos view_item en sesiones de búsqueda/Número de sesiones de búsqueda	Esta métrica incluye todas las vistas de página de las visitas de búsqueda, independientemente de si se pueden atribuir a Vertex AI Search. Basado en eventos de usuario.
Porcentaje de rebote	Número de rebotes en sesiones de búsqueda/Número 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 se ha ido después de hacer una sola búsqueda. Basado en eventos de usuario.

Métricas de búsqueda de Healthcare

Las siguientes métricas de búsqueda están disponibles para las aplicaciones de búsqueda de asistencia sanitaria.

Nombre de la métrica	Definición de las métricas	Notas
Recuento de búsquedas	Número de eventos de búsqueda
No se ha devuelto ningún recuento de resultados	Número de eventos de búsqueda sin resultados
Tasa de búsquedas sin resultados	Número de eventos de búsqueda sin resultados por búsqueda
Número de pacientes	Número de IDs de paciente para los que se han realizado búsquedas	Se deduplica 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 tres.
Número de sesiones de búsqueda de clientes	Número 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.
Número de visitantes de la búsqueda	Número de usuarios que han enviado una solicitud de búsqueda	Los usuarios se contabilizan en función del campo userInfo.
Número de sesiones de búsqueda sintéticas	Número 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. Si hay 30 minutos de inactividad, la sesión finaliza.

Desactivar las analíticas

No puedes desactivar las analíticas de una aplicación que ya tengas, pero, cuando crees una aplicación, puedes elegir si quieres que las analíticas estén desactivadas.

Para crear una aplicación de búsqueda que no recoja datos analíticos, sigue estos pasos:

1. Sigue las instrucciones de REST que se indican en Crear una aplicación de búsqueda y añade 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 aplicación que no recogerá datos analíticos de búsqueda.