En esta página, se describe cómo exportar las métricas de estadísticas de Vertex AI Search for Retail a BigQuery. Exportar métricas de estadísticas te permite retenerlas y escribir SQL para tu propio análisis.
Las métricas de estadísticas de Vertex AI Search para venta minorista se generan automáticamente para ti. Si quieres obtener más información para medir el impacto empresarial de Vertex AI Search for Retail con métricas de estadísticas, consulta Visualiza las estadísticas.
Exportar datos de métricas a BigQuery tiene las siguientes limitaciones:
Los datos que se exportan a las tablas de BigQuery en tu proyecto de Vertex AI Search for Retail son vistas autorizadas, no vistas materializadas.
No puedes cambiar ni actualizar los datos de estas tablas. Si necesitas cambiar o actualizar tus datos, exporta o copia la vista a otro destino.
No puedes exportar métricas de eventos de usuario que tienen más de 180 días ni métricas que se generaron hace más de 180 días. Las métricas generadas antes del período de 180 días no se pueden recuperar.
Antes de comenzar
Para poder exportar tus métricas a BigQuery, debes haber completado los procedimientos que se indican en la sección Antes de comenzar. Esto incluye la importación de tus eventos de usuario y, opcionalmente, la información de tu catálogo.
Para obtener más información sobre la importación, consulta:
- Importa información del catálogo
- Graba eventos de usuarios en tiempo real
- Cómo importar eventos históricos de los usuarios
Crea un conjunto de datos en BigQuery
Debes crear un conjunto de datos en BigQuery para conservar los datos de tus métricas de estadísticas.
Debes crear los conjuntos de datos en el mismo proyecto en el que implementaste Vertex AI Search for Retail.
Si nunca usaste BigQuery en tu proyecto, habilita la API de BigQuery y asegúrate de tener la función de IAM que te permite crear conjuntos de datos y tablas.
Consulta Antes de comenzar y Control de acceso con la IAM.
en la documentación de BigQuery.
Crea un conjunto de datos en BigQuery en la multirregión EE.UU. (varias regiones en Estados Unidos). Por ejemplo, asígnale el nombre
retail_data. Si creas tu conjunto de datos en una región diferente, la exportación de tus datos a BigQuery fallará. CMEK para el conjunto de datos no es compatible. Si lo habilitas, la exportación fallará.Para obtener información sobre cómo crear un conjunto de datos, consulta Cómo crear conjuntos de datos en la documentación de BigQuery.
Este conjunto de datos se usará para almacenar las tablas de datos que exportes. En los siguientes procedimientos, se describe cómo exportar.
Exporta tus métricas de análisis a una tabla de BigQuery
Usa el método exportAnalyticsMetrics para exportar tu catálogo de venta minorista a una tabla de BigQuery.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto de API de Vertex AI Search for Retail en el que creaste el conjunto de datos de BigQuery.
-
DATASET_ID: Es el nombre del conjunto de datos que creaste en
Crea un conjunto de datos en BigQuery. Por ejemplo, usa
retail_dataoretail_metrics_data. -
TABLE_ID_PREFIX: Es un prefijo para el ID de la tabla. Este prefijo no puede ser una cadena vacía. Se agrega un sufijo
retail_analytics_metricspara completar el nombre de la tabla. Por ejemplo, si el prefijo estest, la tabla se llamarátest_retail_analytics_metrics.
Cuerpo JSON de la solicitud:
{
"catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
"outputConfig":
{
"bigqueryDestination":
{
"datasetId": "DATASET_ID",
"tableIdPrefix": "TABLE_ID_PREFIX",
"tableType": "view"
}
}
}
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/12310973052792775280",
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.retail.v2.ExportAnalyticsMetricsResponse",
"outputResult": {
"bigqueryResult": [
{
"datasetId": "DATASET_ID",
"tableId": "TABLE_ID_PREFIX_retail_analytics_metrics"
}
]
}
}
}
Definiciones de las métricas
Las métricas exportadas son las métricas de recuento. Puede haber un ligero desvío para algunas métricas de recuento porque el filtrado de bots puede excluir algunos eventos del procesamiento de métricas. El filtrado de bots puede ayudar a proporcionar mediciones de rendimiento más precisas. Esto no afecta las pruebas A/B, que dependen de la dimensión external_experiment_ids, mientras que el filtrado de bots se aplica a todo el tráfico.
Dimensiones de métricas
Las métricas de recuento son los recuentos sin procesar agregados directamente a partir de eventos de usuario relevantes
con las mismas dimensiones. Para interpretar las métricas, debes saber en qué dimensiones se basan. Para las métricas de estadísticas, los eventos de búsqueda y exploración se denominan eventos de impresión, y los eventos detail_page_view, add_to_cart y purchase se denominan eventos de conversión. En la siguiente tabla, se definen las dimensiones de las métricas.
| Dimensión de la métrica | Descripción |
|---|---|
| date |
Es la fecha de los eventos relevantes que generaron las métricas. Para las métricas de impresiones, es la fecha de los eventos de impresión. En el caso de las métricas de sesiones y visitantes, es la fecha del evento de la primera impresión de la sesión o el visitante. |
| external_experiment_ids |
Los IDs de los experimentos de los eventos relevantes que generaron las métricas. Para las métricas de impresiones, este es el ID del experimento del evento de impresión. Para las métricas de sesiones y visitantes, es la concatenación de los IDs de experimentos externos únicos de todos los eventos de impresión que aparecen en la sesión o el visitante. Por ejemplo, si hay dos eventos de búsqueda en una sesión/visitante, el primer evento de búsqueda tiene external_experiment_ids "test_arm_1,test_arm_2" y el segundo evento de búsqueda tiene external_experiment_ids "test_arm_1,test_arm_3", por lo tanto, external_experiment_ids de la sesión/visitante es "test_arm_1,test_arm_2,test_arm3" |
| device_type |
El tipo de dispositivo de los eventos relevantes que generaron las métricas, por ejemplo, si el evento se genera desde un dispositivo móvil o de escritorio. Para las métricas de impresiones, es el tipo de dispositivo del evento de impresión. En el caso de las métricas de sesiones y visitantes, este valor estará vacío si la sesión o el visitante tiene más de un tipo de dispositivo diferente, o bien si solo hay uno para toda la sesión o el visitante. |
| serving_config |
La configuración de entrega de los eventos relevantes que generaron las métricas. En el caso de las métricas de impresiones, esta es la configuración de publicación del evento de impresión. Para las métricas de sesión y visitante, este valor estará vacío si la sesión o el visitante tiene más de una configuración de entrega distinta, o bien si solo hay una configuración de entrega para toda la sesión o el visitante. |
| traffic_destination |
Es la fuente de los eventos relevantes que generaron las métricas. En el caso de las métricas de impresiones, puede seleccionar "Google" si la impresión la publica Google o "No pertenece a Google" si la publica su propia solución. En el caso de las métricas de sesiones y visitantes, el valor es "Mixto" si la sesión o el visitante tienen ambos eventos de impresión publicados por Google y su propia solución. Es "Google" si los eventos de impresión los publica exclusivamente Google, o bien "No es Google" si su solución publica únicamente los eventos de impresión para toda la sesión o el visitante. |
| socio principal |
Lo usan los minoristas que publican anuncios en varios sitios de marcas o regiones con un catálogo de productos. Por lo general, la entidad representa las marcas o las ubicaciones. Para las métricas de impresiones, es la entidad del evento de impresión. En el caso de las métricas de sesiones y visitantes, estas son las cinco entidades registradas principales de los eventos de impresión de la sesión o el visitante. |
Métricas de impresiones
Las métricas de impresiones se calculan según los requisitos previos. Los eventos de conversión
(eventos detail_page_view, add_to_cart y purchase) se pueden volver a atribuir
a un evento de impresión solo si coinciden con los siguientes criterios.
El evento de impresión y el de conversión tienen el mismo visitante.
El ID del producto del evento de conversión debe aparecer en los resultados del evento de impresión.
El evento de conversión se encuentra dentro del período requerido después del evento de impresión. Se aplican diferentes ventanas de horario de conversión para distintos tipos de eventos de conversión.
Ruta de conversión Período de conversión Impresión -> Vista de página de detalles 60 segundos Impresión -> Agregar al carrito 24 horas Impresión -> Compra 48 horas
Métricas de impresiones de búsqueda
| Nombre de la métrica | Descripción |
|---|---|
| search_event | Recuento de eventos de búsqueda |
| detail_page_view_from_search | Recuento de eventos de vista de la página de detalles de la búsqueda |
| add_to_cart_unit_from_search | Agregar al recuento de unidades del carrito desde la búsqueda |
| purchase_unit_from_search | Recuento de unidades de compra desde la búsqueda |
| revenue_from_search | Ingresos provenientes de la búsqueda |
| search_event_without_result | Recuento de eventos de búsqueda que no genera resultados |
| search_request_personalization_enabled | Recuento de solicitudes de búsqueda con la personalización habilitada |
| search_request_personalization_result_served | Recuento de solicitudes de búsqueda que se muestran con resultados personalizados |
Explorar las métricas de impresiones
| Nombre de la métrica | Descripción |
|---|---|
| browse_event | Explorar recuento de eventos |
| detail_page_view_from_browse | Recuento de eventos de vista de página de detalles desde la navegación |
| add_to_cart_unit_from_browse | Agregar al recuento de unidades del carrito desde la exploración |
| purchase_unit_from_browse | Recuento de unidades de compra desde la exploración |
| revenue_from_browse | Ingresos provenientes de la exploración |
| browse_event_without_result | Recuento de eventos de exploración que no genera resultados |
| browse_request_personalization_enabled | Recuento de solicitudes de exploración con la personalización habilitada |
| browse_request_personalization_result_served | Recuento de solicitudes de navegación que se muestran con resultados personalizados |
Métricas de sesión
Una sesión se define como un período continuo de interacción entre un usuario y el sistema. Cualquier evento del usuario marca el inicio de una sesión, y el final de una sesión se marca cuando no ocurre ningún otro evento durante los próximos 30 minutos. La sesión se extiende otros 30 minutos cada vez que se produce un evento de usuario dentro de una sesión iniciada. Una vez finalizada una sesión, se inicia una nueva cuando el usuario vuelve a interactuar con el sistema.
Las dimensiones que caracterizan las métricas de sesión se definen de forma conjunta con todos los eventos del usuario dentro de la sesión. Consulta las dimensiones de métricas y consulta cómo se configuran los valores de las dimensiones para la sesión.
| Nombre de la métrica | Descripción |
|---|---|
| sesión | Cantidad de sesiones |
Buscar métricas de sesión
Una sesión de búsqueda es una sesión que contiene, al menos, un evento de búsqueda. Ten en cuenta que una sesión de búsqueda también puede ser una sesión de navegación, como se define en las métricas de la sesión de navegación.
| Nombre de la métrica | Descripción |
|---|---|
| search_session | Cantidad de sesiones que incluyen una búsqueda |
| search_event_in_search_session | Recuento de eventos de búsqueda en las sesiones de búsqueda |
| browse_event_in_search_session | Cómo explorar el recuento de eventos en las sesiones de búsqueda |
| detail_page_view_in_search_session | Recuento de vistas de la página de detalles en las sesiones de búsqueda |
| add_to_cart_in_search_session | Recuento de eventos de agregar al carrito en sesiones de búsqueda |
| add_to_cart_unit_in_search_session | Cantidad de unidades de carrito adicionales en sesiones de búsqueda |
| purchase_order_in_search_session | Recuento de órdenes de compra en las sesiones de búsqueda |
| purchase_unit_in_search_session | Cantidad de unidades de compra en las sesiones de búsqueda |
| revenue_in_search_session | Ingresos en las sesiones de búsqueda |
| bounce_count_in_search_session | Recuento de sesiones del visitante que sale del sitio después de ver solo una página en las sesiones de búsqueda |
Explora las métricas de sesión
Una sesión de navegación es una sesión que contiene, al menos, un evento de navegación. Ten en cuenta que una sesión de navegación también puede ser una sesión de búsqueda, según lo definen las métricas de la sesión de búsqueda.
| Nombre de la métrica | Descripción |
|---|---|
| browse_session | Recuento de sesiones que involucran la exploración |
| search_event_in_browse_session | Recuento de eventos de búsqueda en las sesiones de navegación |
| browse_event_in_browse_session | Recuento de eventos de exploración en las sesiones de navegación |
| detail_page_view_in_browse_session | Recuento de vistas de página de detalles en las sesiones de navegación |
| add_to_cart_in_browse_session | Recuento de eventos de agregar al carrito en las sesiones de navegación |
| add_to_cart_unit_in_browse_session | Agregar al recuento de unidades del carrito en las sesiones de navegación |
| purchase_order_in_browse_session | Recuento de órdenes de compra en las sesiones de navegación |
| purchase_unit_in_browse_session | Recuento de unidades de compra en las sesiones de navegación |
| revenue_in_browse_session | Ingresos en las sesiones de navegación |
| bounce_count_in_browse_session | Recuento de sesiones del visitante que sale del sitio después de ver solo una página en las sesiones de navegación |
Métricas de visitantes
Un visitante se identifica de forma única con el ID de visitante. Las métricas de visitantes agregan toda la información de eventos del usuario para el visitante.
Las dimensiones que caracterizan las métricas del visitante se definen de forma conjunta con todos los eventos del usuario para el visitante. Consulta las dimensiones de métricas para saber cómo se configuran los valores de las dimensiones para el visitante.
| Nombre de la métrica | Descripción |
|---|---|
| visitante | Cantidad de visitantes |
Métricas de los visitantes de la búsqueda
Un visitante de búsqueda es un visitante que realiza, al menos, un evento de búsqueda. Ten en cuenta que un visitante de la búsqueda también puede ser un visitante de navegación, según se define en las métricas de visitantes de la navegación.
| Nombre de la métrica | Descripción |
|---|---|
| search_visitor | Recuento de visitantes que realizan, al menos, una búsqueda |
| search_event_from_search_visitor | Recuento de eventos de búsqueda de visitantes de la Búsqueda |
| browse_event_from_search_visitor | Cómo explorar el recuento de eventos de los visitantes de la Búsqueda |
| detail_page_view_from_search_visitor | Recuento de vistas de página de detalles de los visitantes de la búsqueda |
| add_to_cart_from_search_visitor | Recuento de eventos de agregar al carrito de visitantes de la Búsqueda |
| add_to_cart_unit_from_search_visitor | Agregar al recuento de unidades del carrito de visitantes de la búsqueda |
| purchase_order_from_search_visitor | Recuento de órdenes de compra de los visitantes de la Búsqueda |
| purchase_unit_from_search_visitor | Unidad de recuento de compras de visitantes de la Búsqueda |
| revenue_from_search_visitor | Ingresos provenientes de los visitantes de la búsqueda |
Explorar métricas de visitantes
Un visitante de navegación es aquel que realiza, al menos, un evento de navegación. Ten en cuenta que un visitante de navegación también puede ser un visitante de búsqueda, según se define en las métricas de visitantes de la búsqueda.
| Nombre de la métrica | Descripción |
|---|---|
| browse_visitor | Recuento de visitantes que realiza, al menos, una exploración |
| search_event_from_browse_visitor | Recuento de eventos de búsqueda de los visitantes de la exploración |
| browse_event_from_browse_visitor | Recuento de eventos de exploración de los visitantes de la página de navegación |
| detail_page_view_from_browse_visitor | Recuento de vistas de página de detalles de los visitantes de la página de navegación |
| add_to_cart_from_browse_visitor | Recuento de eventos de agregar al carrito de los visitantes de la exploración |
| add_to_cart_unit_from_browse_visitor | Agregar al recuento de unidades del carrito de los visitantes de la exploración |
| purchase_order_from_browse_visitor | Recuento de órdenes de compra de los visitantes de la exploración |
| purchase_unit_from_browse_visitor | Recuento de unidades de compra a los visitantes de la exploración |
| revenue_from_browse_visitor | Ingresos provenientes de los visitantes de la exploración |
Ejemplo de uso
Si copias o exportas tus datos de métricas a otro destino, puedes usar SQL para obtener información específica o de alto nivel sobre las métricas exportadas. En las siguientes secciones, se proporcionan algunas formas comunes de explorar las métricas exportadas mediante SQL.
Calcula la tasa de clics (CTR)
Calcula la CTR para la búsqueda por fecha, por tipo de dispositivo y por destino de tráfico.
SELECT `date`, device_type, traffic_destination, SUM(detail_page_view_from_search) / SUM(search_event) as search_CTR FROM copied_table GROUP BY `date`, device_type, traffic_destination
Obtén el recuento de vistas de la página de detalles basada en la exploración
Obtén eventos de vista de página de detalles que provienen de eventos de navegación para el tráfico de Google con external_experiment_ids que contiene test_arm, y muestra toda la información de la dimensión. external_experiment_ids se repite string.
SELECT `date`, external_experiment_ids, device_type, serving_config, traffic_destination, entity, detail_page_view_from_browse FROM copied_table WHERE traffic_destination = 'Google' AND 'test_arm' in UNNEST(external_experiment_ids)
Obtén los parámetros de configuración de entrega más usados
Obtén los parámetros de configuración de entrega más usados entre el “10-10-2023” y el “11-2023” para el tráfico de Google. Cada evento de búsqueda debe tener una configuración de entrega asociada.
SELECT serving_config, SUM(search_event) as total_search_count FROM copied_table WHERE `date` between '2023-10-01' and '2023-11-01' AND traffic_destination = 'Google' GROUP BY serving_config ORDER BY total_search_count