Cómo ver y exportar datos de estadísticas

Las estadísticas te brindan observaciones sobre las tendencias de uso, la calidad de la búsqueda y la participación de los usuarios finales de tu app. La consola proporciona una experiencia de panel interactivo con la tecnología de Looker. En esta página, se describe cómo ver 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 Gemini Enterprise usa 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, importarlos 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 puedan atribuir a Google incluyendo el elemento asociado en UserEvent.Documents cuando se transfieren 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 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 de 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.
  • Busca registros. 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 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 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 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 de 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 de 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. Como el recuento es único, un usuario que llama a los métodos de la API de asistente, respuesta y búsqueda se cuenta solo una vez en el total.
Usuarios que llaman al asistente Es la cantidad de usuarios que llamaron a los métodos 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 a 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 Es la cantidad de usuarios que llamaron a métodos de la API que no son streamAssist, streamAnswer ni 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 y activa cualquier llamada a la API, como cuando llega 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 Recuento de usuarios que abandonaron el servicio 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 desertó si estuvo activo en el período de 7 días anterior, pero no en el actual.
Tasa de retención 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 dejaron de usar la app en el período actual de 28 días / cantidad de usuarios activos en el período anterior de 28 días
Licencias compradas Es la cantidad de licencias (asientos) que compró la organización. Incluye todas las licencias compradas 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 consultas de búsqueda que los usuarios realizaron 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 Me gusta y No me gusta que enviaron 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 a un usuario no le gusta una respuesta generada, puede seleccionar varios motivos para explicar su desagrado. El porcentaje muestra la frecuencia con la que se seleccionó cada motivo.
Porcentaje de búsquedas exitosas Cantidad de búsquedas exitosas / cantidad de búsquedas
Tasa de respuestas exitosas Recuento de respuestas exitosas/recuento de respuestas
Agentes Usuarios activos de agentes por mes Es la cantidad total de usuarios activos que usaron el agente por mes. Un usuario se considera activo para un agente cada vez que realiza una llamada de Assistant a ese agente en el modo de agente, investigación o idea forge. Esto incluye la actividad del creador del agente durante las vistas previas o las pruebas en Workflow Builder, ya que estas acciones generan llamadas normales de Asistente con el ID del agente, de forma 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 iniciadas por los usuarios que interactúan con un agente específico por mes. Una sesión de chat se define como un usuario que interactúa con un agente dentro de la misma conversación de chat en un solo día. Si el usuario continúa la conversación en la misma conversación en un día posterior, se considerará una sesión nueva. Se registran las sesiones de vista previa y prueba iniciadas desde Workflow Builder, ya que fluyen por 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.
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 un usuario que interactúa con un agente dentro de la misma conversación de chat en un solo día. Si el usuario continúa la conversación en la misma conversación en un día posterior, se considerará una sesión nueva. Se registran las sesiones de vista previa y prueba iniciadas desde Workflow Builder, ya que fluyen por 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 Cantidad total de agentes que se crearon en el último mes calendario.
Nombre del agente El nombre visible del agente, que se muestra en la columna Nombre del agente del ranking junto al ID del agente en la columna ID del agente. Si se cambió el nombre de un agente, en el ranking se muestra su nombre visible más reciente. Si no hay un nombre visible disponible para un agente, la columna Nombre del agente muestra el ID del agente.
Usuarios activos por día de Gemini Notebook Enterprise 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 Es el 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.
Cuadernos diarios de Gemini Notebook Enterprise creados por usuario Es el 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 notebooks 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.
Resúmenes de audio diarios creados en 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 de Gemini Notebook Enterprise por mes. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Cuadernos mensuales creados de Gemini Notebook Enterprise Es el recuento 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 el recuento de cuadernos de Gemini Notebook Enterprise compartidos por mes. Las métricas de Gemini Notebook Enterprise se calculan en todo el proyecto y no por motor.
Resúmenes de audio mensuales creados en Gemini Notebook Enterprise Cantidad 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 que se inicie una nueva búsqueda
  • Si la respuesta de una búsqueda incluye un resultado de la búsqueda de personas y no va seguida de 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 le da Me gusta a la respuesta, la consulta 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 para el campo Tarifa por hora del empleado.
Ahorro anual proyectado 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 seleccionado. Se estima que cada consulta ahorra tres minutos, una estimación basada en la investigación interna de Google.
Valor anual ahorrado proyectado 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 dentro del 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 proyecto deGoogle 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, en la siguiente tabla, se 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 (múltiples regiones en Estados Unidos) us (múltiples regiones en Estados Unidos)
        EU (múltiples regiones en la Unión Europea) EU (múltiples 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 la 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 las 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 multirregión 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 multirregión 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.
    • 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.