Cómo ver y exportar datos de estadísticas

Las estadísticas te brindan información sobre las tendencias de uso, la calidad de la búsqueda y la participación de los usuarios finales en tu app. La consola proporciona una experiencia de panel interactivo con la tecnología de Looker. En esta página, se describe cómo consultar las estadísticas de tus apps.

Antes de comenzar

Asegúrate de que tu app esté conectada a un almacén de datos. Las métricas de la app solo están disponibles desde el momento en que se vincula un almacén de datos a una app.

Si no tienes un almacén de datos, debes conectar una fuente de datos de Google o una fuente de datos de terceros a tu app.

Eventos del usuario para estadísticas

En esta sección, se describen los eventos de usuario que usa Gemini Enterprise para generar las métricas relacionadas con la búsqueda, como el recuento de búsquedas y la tasa de clics. No se necesitan parámetros de configuración adicionales si usas la interfaz de usuario para buscar y obtener respuestas a través del asistente de Gemini Enterprise. Sin embargo, si usas las APIs de Gemini Enterprise en tus propias apps, debes configurar la búsqueda en tu app para capturar los eventos de usuario y, luego, importar los eventos de usuario a tu app.

Las apps de Gemini Enterprise requieren los siguientes eventos de usuario para obtener las métricas:

  • Eventos de búsqueda. 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 algunas estadísticas:

  • Impresiones. Puedes proporcionar impresiones (vistas o clics de elementos) que se atribuyan a Google si incluyes el elemento asociado en UserEvent.Documents cuando ingieres 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 Google 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 del usuario que resulte de una búsqueda. Esto es necesario para identificar si la API proporciona una búsqueda. Solo se usan los eventos de usuario con un token de atribución generado por Google para calcular las métricas.
  • Registros de búsqueda Los registros de búsqueda se basan en las solicitudes de búsqueda. Para permitir que Google identifique las sesiones de los usuarios de modo que pueda ofrecer estadísticas por sesión y resultados de la búsqueda de mayor calidad, Google recomienda que configures el campo opcional SearchRequest.UserPseudoId.

Si 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 Gemini Enterprise

Puedes ver las estadísticas de búsqueda de tu app. Verás las métricas relacionadas con las llamadas de búsqueda realizadas a tu app. Si tu app está conectada a varios almacenes de datos, se recomienda realizar llamadas de búsqueda a la app especificando el recurso engine para que puedas obtener resultados de todos sus almacenes de datos conectados.

Sigue estas instrucciones para ver las estadísticas sobre tu app.

  1. En la consola de Google Cloud , ve a la página Gemini Enterprise.

    Gemini Enterprise

  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:

    • Adopción: Métricas sobre el estado de adopción de los usuarios.

    • Uso y calidad: Métricas sobre los comentarios de los usuarios y el uso de la app.

    • Agente: Son las métricas de los agentes en la app web de Gemini Enterprise, incluidos los agentes creados por Google, Gemini Notebook Enterprise y los agentes que tu organización creó y registró en Gemini Enterprise.

    • Valor: Métricas sobre el ahorro de costos que obtienen los usuarios que consultan datos con la app.

    • Nivel de usuario: Las métricas incluyen los IDs de usuario (dirección de correo electrónico o identificador único) de los usuarios de la organización y sus interacciones con los agentes creados por Google y los agentes que la organización creó y registró con Gemini Enterprise.

    Consulta los datos de estadísticas de adopción.
    Consulta los datos de estadísticas sobre la adopción

  5. Para filtrar tus métricas, especifica los filtros disponibles para la pestaña de métricas y, luego, haz clic en el botón Actualizar para aplicarlos.

Definiciones de las métricas

En la siguiente tabla, se describe cómo se definen las métricas.

Grupo de métricas Nombre de la métrica Definición de la métrica Notas
Adopción Total de usuarios Es la cantidad de usuarios activos únicos de Gemini Enterprise durante el período seleccionado. Se considera que un usuario está activo si accede y activa cualquier llamada a la API, como cuando llega a la página principal. Dado que el recuento es único, un usuario que llama a los métodos de la API de Assistant, Answer y Search se cuenta solo una vez en el total.
Usuarios que llaman al asistente Cantidad de usuarios que llamaron a los métodos de AssistantService o usaron el Asistente para generar respuestas.
Respuesta de los usuarios que llaman Cantidad de usuarios que llamaron a los métodos ConversationalSearchService y GenerativeSearchAnswerService para generar respuestas.
Usuarios que llaman desde la Búsqueda Es la cantidad de usuarios que llamaron a los métodos SearchService para obtener resultados de la búsqueda.
Usuarios que llaman a otros métodos de la API Cantidad de usuarios que llamaron a métodos de la API que no sean streamAssist, streamAnswer y engines.servingConfigs.search. Por ejemplo, los usuarios que llaman a los métodos de la API de autenticación.
Usuarios activos por día Recuento de usuarios activos por día Se considera que un usuario está activo si accede a su cuenta y activa cualquier llamada a la API, como cuando ingresa a la página principal.
Usuarios activos por semana Es el recuento de usuarios activos por semana. La semana comienza el lunes y termina el domingo.
Usuarios activos por mes Recuento de usuarios activos por mes
Tasa de retención de 7 días Recuento de usuarios recurrentes en el período actual de 7 días / recuento de usuarios activos en el período anterior de 7 días Se considera que un usuario es recurrente si está activo durante el período actual de 7 días y el período anterior de 7 días.
Tasa de crecimiento en 7 días Es la diferencia porcentual entre la cantidad de usuarios activos en el período actual de siete días y el período anterior de siete días.
Tasa de deserción en 7 días Cantidad de usuarios que abandonaron la plataforma en el período actual de 7 días / cantidad de usuarios activos en el período anterior de 7 días Se considera que un usuario desertó si estuvo activo en el período de 7 días anterior, pero no lo está en el período de 7 días actual.
Tasa de retención después de 28 días Cantidad de usuarios recurrentes en el período actual de 28 días / cantidad de usuarios activos en el período anterior de 28 días
Tasa de crecimiento de 28 días Es la diferencia porcentual entre la cantidad de usuarios activos en el período actual de 28 días y el período anterior de 28 días.
Tasa de deserción de 28 días Cantidad de usuarios que abandonaron el servicio en el período actual de 28 días / cantidad de usuarios activos en el período anterior de 28 días
Licencias compradas La cantidad de licencias (asientos) que compró la organización Incluye todos los puestos comprados desde el registro en Gemini Enterprise.
Licencias reclamadas Es la cantidad de licencias de usuario que se asignaron a las personas de tu organización y que estas aceptaron. Incluye todas las licencias reclamadas desde el registro en Gemini Enterprise.
Uso y calidad Cantidad de búsquedas Es la cantidad total de búsquedas que los usuarios realizan en Gemini Enterprise.
Recuento de respuestas Es la cantidad total de veces que Gemini Enterprise generó una respuesta a la consulta de un usuario. Las respuestas generadas por un agente no se incluyen en este recuento.
Recuento de acciones La cantidad total de interacciones, como subir archivos, crear carpetas o usar acciones de conector en Gemini Enterprise. Incluye acciones como crear una plantilla de correo electrónico.
Tasa de clics (CTR) por búsqueda Cantidad total de clics de búsqueda / cantidad de búsquedas Los clics de búsqueda incluyen los clics en los resultados de la búsqueda y las referencias internas.
Vista de página por categoría Cantidad total de vistas de cada página de categoría
Recuento de Me gusta y No me gusta de los comentarios Recuento de los Me gusta y No me gusta que envían los usuarios Es un registro de las respuestas de comentarios de Me gusta o 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.
Tasa de búsquedas exitosas Cantidad de búsquedas exitosas / cantidad de búsquedas
Tasa de respuestas correctas Recuento de respuestas exitosas / recuento de respuestas
Agentes Usuarios activos por mes de agentes Es la cantidad total de usuarios activos que usaron el agente por mes. Un usuario se cuenta como activo para un agente cada vez que realiza una llamada de Gemini a ese agente en el modo de agente, investigación o generador de ideas. Esto incluye la actividad del creador del agente durante las vistas previas o las pruebas en Workflow Builder, ya que estas acciones generan llamadas regulares de Asistente con el ID del agente, de manera similar a cualquier interacción del usuario final. Solo se excluyen de este recuento las interacciones con borradores no guardados a los que no se les asignó un ID de agente.
Sesiones de chat mensuales con agentes Es la cantidad total de sesiones de chat que iniciaron los usuarios que interactúan con un agente específico por mes. Una sesión de chat se define como la interacción de un usuario con un agente en el mismo hilo de chat en un solo día. Si el usuario continúa la conversación en el mismo hilo de chat en un día posterior, se considerará una sesión nueva. Se contabilizan las sesiones de prueba y vista previa iniciadas desde Workflow Builder, ya que fluyen a través de la misma ruta de la API de Assistant que las sesiones de los usuarios finales y reciben un ID de sesión.
Agentes mensuales usados Es la cantidad total de agentes que tuvieron al menos un usuario activo por mes. Usa la misma definición de usuario activo que Usuarios agentes activos por mes. En ocasiones, este recuento puede superar el total de sesiones de chat mensuales en un mes determinado cuando muchos agentes reciben llamadas de corta duración de Asistente que no producen un ID de sesión persistente (por ejemplo, turnos anulados o cancelados, o llamadas de un solo intento que no abren una sesión de chat).
Total de sesiones de chat mensuales Es la cantidad total de sesiones de chat que inician los usuarios que interactúan con los agentes por mes. Una sesión de chat se define como la interacción de un usuario con un agente en el mismo hilo de chat en un solo día. Si el usuario continúa la conversación en el mismo hilo de chat en un día posterior, se considerará una sesión nueva. Se registran las sesiones de prueba y vista previa iniciadas desde Workflow Builder, ya que fluyen a través de la misma ruta de la API de Assistant que las sesiones de los usuarios finales y reciben un ID de sesión.
Agentes creados mensualmente Es la cantidad total de agentes que se crearon en el último mes calendario.
Usuarios activos por día de Gemini Notebook Enterprise Es el recuento de usuarios activos de Gemini Notebook Enterprise por día. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Cuadernos diarios creados de Gemini Notebook Enterprise Recuento de cuadernos de Gemini Notebook Enterprise creados por día. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Notebooks diarios de Gemini Notebook Enterprise creados por usuario Recuento de cuadernos de Gemini Notebook Enterprise creados por usuario por día. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Notebooks diarios compartidos de Gemini Notebook Enterprise Es el recuento de cuadernos de Gemini Notebook Enterprise que se comparten por día. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Se crearon resúmenes en audio diarios de Gemini Notebook Enterprise Es el recuento de resúmenes de audio de Gemini Notebook Enterprise creados por día. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Usuarios activos por mes de Gemini Notebook Enterprise Es el recuento de usuarios activos por mes de Gemini Notebook Enterprise. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Notebooks mensuales creados con Gemini Notebook Enterprise Es la cantidad de cuadernos de Gemini Notebook Enterprise creados por mes. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Cuadernos mensuales de Gemini Notebook Enterprise creados por usuario Es la cantidad promedio de cuadernos de Gemini Notebook Enterprise creados por usuario al mes. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Notebooks mensuales compartidos de Gemini Notebook Enterprise Es la cantidad de cuadernos de Gemini Notebook Enterprise que se compartieron por mes. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Resúmenes en audio mensuales creados con Gemini Notebook Enterprise Es el recuento de resúmenes de audio de Gemini Notebook Enterprise creados por mes. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Value
(versión preliminar pública)
Búsqueda exitosa Es la cantidad de búsquedas exitosas. La cantidad de búsquedas exitosas se determina según el comportamiento del usuario después de una búsqueda. Una búsqueda se considera exitosa si ocurre una de las siguientes situaciones:
  • Si se hace clic en un resultado de la búsqueda antes de iniciar una nueva búsqueda
  • Si la respuesta de una búsqueda incluye un resultado de la búsqueda de personas y no le sigue otra búsqueda en un plazo de dos minutos. Esto se debe a que los resultados de la búsqueda de personas se muestran en la página de resultados de búsqueda y, por lo general, no requieren un clic.
Respuesta correcta Recuento de respuestas correctas El éxito de una respuesta se determina por el comportamiento del usuario después de que se genera. El éxito se mide por los comentarios proporcionados o por la rapidez con la que se hizo una pregunta de seguimiento.
  • Si el usuario indica que le gusta la respuesta, la búsqueda se considera exitosa.
  • Si no hay comentarios y el usuario no hace otra consulta en un plazo de 30 segundos, se supone que la consulta se realizó correctamente.
Horas de trabajo de los empleados ahorradas en las fechas seleccionadas (Recuento de búsquedas exitosas + Recuento de respuestas exitosas) x Minutos ahorrados por respuesta exitosa
Se guardó el valor para las fechas seleccionadas Horas ahorradas dentro de las fechas seleccionadas ✕ Tarifa por hora promedio de los empleados Para ver esta métrica, en la pestaña Valor, especifica una tarifa por hora en el campo Tarifa por hora del empleado.
Proyección del ahorro anual de horas de los empleados (Cantidad de búsquedas exitosas + Cantidad de respuestas exitosas) × Minutos ahorrados por búsqueda exitosa El recuento anual proyectado de búsquedas exitosas se deriva del recuento de búsquedas exitosas dentro del período elegido. Se estima que cada consulta ahorra tres minutos, una estimación basada en la investigación interna de Google.
Valor anual proyectado ahorrado Horas anuales proyectadas que ahorran los empleados ✕ Tarifa por hora promedio de los empleados Para ver esta métrica, en la pestaña Valor, especifica una tarifa por hora para el campo Tarifa por hora del empleado.
A nivel del usuario
ID de usuario La dirección de correo electrónico de cada usuario de tu organización Si la dirección de correo electrónico no está disponible, se muestra el identificador único original del usuario.
Total de mensajes Es la cantidad total de mensajes que un usuario envió a la app web de Gemini Enterprise. Incluye todos los mensajes que envió el usuario y no se limita a las conversaciones con agentes de Gemini Enterprise.
Mensajes para agentes creados por Google Es la cantidad total de mensajes que un usuario envió a los agentes creados por Google en el período seleccionado.
Mensajes para nuestros agentes Es la cantidad total de mensajes que un usuario envió a los agentes que creó la organización y que se registraron en Gemini Enterprise dentro del período seleccionado.

Exporta métricas

Sigue estos pasos para exportar las métricas a una tabla de BigQuery en tu proyectoGoogle Cloud :

  1. Verifica que tengas los permisos y los roles necesarios.

  2. Crea un conjunto de datos de BigQuery:

    1. Abre la página de BigQuery en la consola de Google Cloud .

      Ir a la página de BigQuery

    2. En el panel Explorador, selecciona el mismo proyecto en el que se encuentra tu app de Gemini Enterprise para crear el conjunto de datos.

    3. Haz clic en la opción y, luego, en Crear conjunto de datos.

    4. En la página Crear conjunto de datos:

      • En ID de conjunto de datos, ingresa un nombre único para el conjunto de datos. Necesitas el nombre del conjunto de datos para exportar las métricas a través de la API.

      • En Tipo de ubicación, la siguiente tabla muestra cómo asignar las ubicaciones de BigQuery a las ubicaciones de la app de Gemini Enterprise:

        Ubicación multirregional de la app de Gemini Enterprise Ubicación multirregional de BigQuery
        Global us (múltiples regiones en Estados Unidos)
        US (multiple regions in United States) us (múltiples regiones en Estados Unidos)
        EU (varias regiones en la Unión Europea) EU (varias regiones en la Unión Europea)

    5. Haz clic en Crear conjunto de datos.

  3. Crea una tabla de BigQuery vacía para el conjunto de datos que creaste.

    1. En el panel Explorador, expande tu proyecto y, luego, selecciona el conjunto de datos que creaste.
    2. En la sección Información del conjunto de datos, haz clic en Crear tabla.
    3. En el panel Crear tabla, especifica un nombre para tu tabla en el campo Tabla. Necesitas el nombre de la tabla para exportar las métricas a través de la API.
    4. Haz clic en Crear tabla.

  4. Llama al método analytics:exportMetrics para recuperar los datos de métricas de los últimos 30 días, incluido el día actual.

    REST

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
-d '{
   "analytics": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
   "outputConfig":
      {
         "bigqueryDestination":
         {
            "datasetId": "BIGQUERY_DATASET_ID",
            "tableId": "BIGQUERY_TABLE_ID"
         }
      }
   }' \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/analytics:exportMetrics"

    Reemplaza lo siguiente:

    • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
      • us para la multirregión de EE.UU.
      • eu para la multirregión de la UE
      • global para la ubicación global
      Para obtener más información, consulta Cómo especificar una multirregión para tu almacén de datos.
    • LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • APP_ID: Es el ID de la app de la que deseas exportar las métricas.
    • BIGQUERY_DATASET_ID: el ID del conjunto de datos de BigQuery que creaste.
      El ID del conjunto de datos sigue el formato <PROJECT_ID>.<DATASET_ID>. Solo debes proporcionar el <DATASET_ID>.
    • BIGQUERY_TABLE_ID: el ID de la tabla de BigQuery que creaste.
      En la vista Explorador clásico, el ID de la tabla sigue el formato <PROJECT_ID>.<DATASET_ID>.<TABLE_ID>. Solo debes proporcionar el <TABLE_ID>.

    La respuesta incluye el nombre y el ID de la operación. Toma nota del ID de la operación para usarlo en el siguiente paso.
    Por ejemplo:

    {
   "name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/operations/OPERATION_ID",
   "metadata": {
      "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata"
   }
}

  5. Para ver el estado de la operación de exportación de métricas, llama al método engines.operations.get:

    REST

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/operations/OPERATION_ID"

    Reemplaza lo siguiente:

    • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
      • us para la multirregión de EE.UU.
      • eu para la multirregión de la UE
      • global para la ubicación global
      Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
    • LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
    • APP_ID: Es el ID de la app de la que deseas obtener las operaciones de larga duración.
    • OPERATION_ID: Es el ID de la operación de exportación de métricas que se devolvió en la respuesta cuando ejecutaste el comando para exportar las métricas.