En esta página, se describe cómo exportar las métricas de estadísticas de Vertex AI Search for Retail en BigQuery. La exportación de métricas de estadísticas te permite retener las métricas y escribir SQL para tu propio análisis.
Las métricas de estadísticas de Vertex AI Search para la venta minorista se generan automáticamente por ti. Para obtener más información sobre cómo medir el impacto comercial de Vertex AI Search for Retail con métricas de estadísticas, consulta Ver 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 para venta minorista son vistas autorizadas, no vistas materializadas.
No puedes cambiar ni actualizar los datos de estas tablas. Si necesitas cambiar o actualizar tus datos, y exportar o copiar la vista a otro destino.
No puedes exportar métricas de eventos de usuario que tienen más de 180 días o que se generaron hace más de 180 días. Cualquier métrica generada antes del período de 180 días no son recuperables.
Antes de comenzar
Antes de poder exportar tus métricas a BigQuery, debes haber completado los procedimientos que se indican en Antes de comenzar. Esto incluye importar tus eventos de usuario y, de manera opcional, la información de tu catálogo.
Para obtener más información sobre la importación, consulta:
- Importa información del catálogo
- Cómo registrar eventos de usuario 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 guardar tus estadísticas los datos de métricas.
Debes crear los conjuntos de datos en el mismo proyecto en el que implementaste Vertex AI Search para venta minorista.
Si no usaste BigQuery en tu proyecto antes, habilita la API de BigQuery y asegúrate de que tienes el rol 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 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 y exportas tus datos a BigQuery falla. CMEK para el conjunto de datos no es compatible; Habilitarlo hace que la exportación falle.Para obtener información sobre cómo crear un conjunto de datos, consulta Crea conjuntos de datos en la documentación de BigQuery.
Este conjunto de datos se usará para contener las tablas de datos que exportes. En los siguientes procedimientos, se describe cómo exportar.
Cómo exportar tus métricas de Analytics 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 la 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. Un sufijo de
retail_analytics_metricsse agrega para 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 algunos
Métricas de recuento porque el filtrado de bots podría excluir algunos eventos de las métricas
el procesamiento. El filtrado de bots puede ayudar a brindar un rendimiento más preciso
de las mediciones. 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 los eventos de usuarios relevantes
con las mismas dimensiones. Para interpretar las métricas, debes saber en qué
dimensiones se basan. A los efectos de las métricas de Analytics, 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 métrica | Descripción |
|---|---|
| fecha |
Es la fecha de los eventos relevantes que generaron las métricas. En el caso de las métricas de impresiones, es la fecha de los eventos de impresión. En el caso de las métricas de sesión y visitante, esta es la fecha del primer evento de 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 En el caso de 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 o un 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', entonces external_experiment_ids de la sesión o el visitante es 'test_arm_1,test_arm_2,test_arm_3'. |
| device_type |
Es 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. En el caso de las métricas de impresiones, este 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. 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 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, esta opción es "Google" si Google publica la impresión o "No Google" si tu propia solución publica la impresión. Para las métricas de sesiones y visitantes, es "Mixto" si la sesión o el visitante tienen ambos eventos de impresión publicados por Google y por tu propia solución. Selecciona "Google" si Google publica los eventos de impresión por completo o "No Google" si tu solución publica los eventos de impresión por completo 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. En el caso de las métricas de impresiones, esta es la entidad del evento de impresión. En el caso de las métricas de sesión y visitante, estas son las cinco entidades más contadas 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 atribuir a un evento de impresión solo si cumplen 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 el resultados.
El evento de conversión se encuentra dentro del período requerido después de que ocurre el evento de impresión. Se aplican diferentes ventanas de tiempo de conversión para los diferentes tipos de eventos de conversión.
Ruta de conversión Ventana de tiempo de conversión Impresiones -> 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 | Cantidad de eventos de vista de página de detalles de la búsqueda |
| add_to_cart_unit_from_search | Cantidad de unidades de la acción "Agregar al 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 | Cantidad de eventos de búsqueda que no arrojan resultados |
| search_request_personalization_enabled | Cantidad de solicitudes de búsqueda con personalización habilitada |
| search_request_personalization_result_served | Recuento de solicitudes de búsqueda que se muestran con resultados personalizados |
Explora 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 por navegación |
| browse_event_without_result | Recuento de eventos de exploración que no genera resultados |
| browse_request_personalization_enabled | Cantidad de solicitudes de navegación con personalización habilitada |
| browse_request_personalization_result_served | Cantidad de solicitudes de navegación que se publican 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 se produce 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 del usuario dentro de una sesión iniciada. Cuando finaliza una sesión, se inicia otra nueva cuando el usuario vuelve a interactuar con el sistema.
Todos los eventos del usuario dentro de la sesión definen conjuntamente las dimensiones que caracterizan las métricas de sesión. Consulta las métricas dimensiones, como la forma en que se establecen los valores de las dimensiones para el 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 un La sesión de búsqueda también puede ser una sesión de navegación, como lo define la sesión de navegación. métricas.
| 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 | Recuento de eventos de navegación en sesiones de búsqueda |
| detail_page_view_in_search_session | Cantidad de vistas de páginas de detalles en las sesiones de búsqueda |
| add_to_cart_in_search_session | Cantidad de eventos de agregar al carrito en las 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 un La sesión de navegación también puede ser una sesión de búsqueda, como lo define la sesión de búsqueda. métricas.
| Nombre de la métrica | Descripción |
|---|---|
| browse_session | Recuento de sesiones que involucran la exploración |
| search_event_in_browse_session | Cantidad de eventos de búsqueda en 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 | Cantidad 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 | Es el recuento de sesiones del visitante que abandona el 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. Agregado de métricas de visitantes toda la información de eventos de usuario para el visitante.
Todas las dimensiones que caracterizan las métricas de visitante son definidas en conjunto por todos los eventos del usuario para el visitante. Consulta las dimensiones de las métricas para ver cómo se establecen los valores de las dimensiones para el visitante.
| Nombre de la métrica | Descripción |
|---|---|
| visitante | Cantidad de visitantes |
Métricas de visitantes de 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 búsqueda también puede ser un visitante de navegación, según se define en las métricas de visitantes de 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 | Cantidad de eventos de búsqueda de visitantes de 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 | Cantidad de eventos de agregar al carrito de los visitantes que realizaron una 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 visitantes de búsqueda |
| purchase_unit_from_search_visitor | Unidad de recuento de compras de visitantes de búsqueda |
| revenue_from_search_visitor | Ingresos provenientes de visitantes de la Búsqueda |
Explorar las métricas de los visitantes
Un visitante de navegación es aquel que realiza, al menos, un evento de navegación. Ten en cuenta que un El visitante de navegación también puede ser un visitante de búsqueda, según lo define el visitante de búsqueda. métricas.
| Nombre de la métrica | Descripción |
|---|---|
| browse_visitor | Recuento de visitantes que realiza, al menos, una exploración |
| search_event_from_browse_visitor | Cantidad de eventos de búsqueda de visitantes que exploraron el sitio |
| browse_event_from_browse_visitor | Recuento de eventos de navegación de los visitantes 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 | Cantidad de eventos de agregar al carrito de los visitantes que exploraron el sitio |
| add_to_cart_unit_from_browse_visitor | Cantidad de unidades agregadas al carrito de los visitantes que exploraron el sitio |
| purchase_order_from_browse_visitor | Cantidad de órdenes de compra de visitantes que exploran el sitio |
| purchase_unit_from_browse_visitor | Cantidad de unidades de compra de visitantes que exploraron el contenido |
| revenue_from_browse_visitor | Ingresos provenientes de visitantes que navegan |
Ejemplo de uso
Si copias o exportas los datos de tus métricas a otro destino, puedes usar SQL para obtener información específica o de alto nivel sobre las métricas exportadas. Algunos Las formas comunes de explorar las métricas exportadas usando SQL se proporcionan en el secciones a continuación.
Calcula la tasa de clics (CTR)
Calcula la CTR para la búsqueda por fecha, por tipo de dispositivo y por destino del 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 todas las dimensiones
informació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 las configuraciones de publicación más utilizadas entre el 1 de octubre de 2023 y el 1 de noviembre de 2023 para el tráfico de Google. Cada evento de búsqueda debe tener una configuración de publicación 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