En esta página, se describe cómo exportar métricas de análisis de Vertex AI Search para la venta minorista a 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 para venta minorista con métricas de estadísticas, consulta Cómo ver las estadísticas.
La exportación de 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, exporta o copia la vista a otro destino.
No puedes exportar métricas de eventos de usuario que tengan más de 180 días ni métricas que se hayan generado hace más de 180 días. No se pueden recuperar las métricas generadas antes del período de 180 días.
Antes de comenzar
Para 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 los siguientes artículos:
- Importa información de los catálogos
- Cómo registrar eventos de usuario en tiempo real
- Importa eventos históricos de usuarios
Crea un conjunto de datos en BigQuery
Debes crear un conjunto de datos en BigQuery para almacenar tus datos de métricas de análisis.
Debes crear los conjuntos de datos en el mismo proyecto en el que implementaste Vertex AI Search para venta minorista.
Si nunca antes usaste BigQuery en tu proyecto, habilita la API de BigQuery y asegúrate de tener el rol de IAM que te permite crear conjuntos de datos y tablas.
Consulta Antes de comenzar y Control de acceso con IAM.
en la documentación de BigQuery.
Crea un conjunto de datos en BigQuery en la ubicación multirregión US (multiple regions in the United States). Por ejemplo, asígnale el nombre
retail_data. Si creas tu conjunto de datos en una región diferente, fallará la exportación de tus datos a BigQuery. No se admite CMEK para el conjunto de datos. Si lo habilitas, la exportación fallará.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
Cómo crear 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 de
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 una deriva leve en algunas métricas de recuento porque el filtrado de bots podría excluir algunos eventos del procesamiento de métricas. El filtrado de bots puede ayudar a generar 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 las métricas
Las métricas de recuento son los recuentos sin procesar que se agregan directamente a partir de 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, esta 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. En el caso de las métricas de sesión y visitante, esta 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 sesión y visitante, este campo está vacío si la sesión o el visitante tiene más de un tipo de dispositivo distinto, o bien el único tipo de dispositivo para toda la sesión o el visitante. |
| serving_config |
La configuración de publicación 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 sesión y visitante, este campo está vacío si la sesión o el visitante tiene más de una configuración de publicación distinta, o bien el valor único si solo hay una configuración de publicación 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, este valor es "Google" si Google publica la impresión o "No Google" si tu propia solución publica la impresión. En el caso de las métricas de sesión y visitante, este valor es "Mixto" si la sesión o el visitante tienen 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 |
Los minoristas que publican varios sitios o regiones de marcas con un catálogo de productos lo usan. Por lo general, la entidad representa las marcas o 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 evento 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 de que se produce 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 Impresiones -> Agregar al carrito 24 horas Impresiones -> Compras 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 | Cantidad 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 generan resultados |
| search_request_personalization_enabled | Cantidad de solicitudes de búsqueda con personalización habilitada |
| search_request_personalization_result_served | Cantidad de solicitudes de búsqueda que se publican con resultados personalizados |
Explora las métricas de impresiones
| Nombre de la métrica | Descripción |
|---|---|
| browse_event | Recuento de eventos de navegación |
| 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 | Cantidad de unidades de agregar al carrito desde la navegación |
| purchase_unit_from_browse | Cantidad de unidades compradas desde la exploración |
| revenue_from_browse | Ingresos por navegación |
| browse_event_without_result | Recuento de eventos de navegación que no muestra 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. Después de que finaliza una sesión, se inicia una 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 dimensiones de las métricas para ver cómo se establecen los valores de las dimensiones para la sesión.
| Nombre de la métrica | Descripción |
|---|---|
| sesión | Cantidad de sesiones |
Métricas de la sesión de búsqueda
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 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 | Cantidad 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 agregadas al carrito en las sesiones de búsqueda |
| purchase_order_in_search_session | Cantidad 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 | Es el recuento de sesiones del visitante que abandona el 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, como se define en las métricas de sesión de búsqueda.
| Nombre de la métrica | Descripción |
|---|---|
| browse_session | Cantidad de sesiones que incluyen navegació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 navegación en sesiones de navegación |
| detail_page_view_in_browse_session | Cantidad de vistas de páginas de detalles en las sesiones de navegación |
| add_to_cart_in_browse_session | Cantidad de eventos de agregar al carrito en las sesiones de navegación |
| add_to_cart_unit_in_browse_session | Cantidad de unidades agregadas al 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 | Cantidad de unidades de compra en 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
El ID de visitante identifica a un visitante de forma exclusiva. Las métricas de visitantes agregan toda la información del evento del 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, como se define en las métricas de visitantes de navegación.
| Nombre de la métrica | Descripción |
|---|---|
| search_visitor | Cantidad 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 | Recuento de eventos de navegación de visitantes que realizaron una búsqueda |
| detail_page_view_from_search_visitor | Cantidad de vistas de páginas de detalles de visitantes que realizaron búsquedas |
| 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 | Cantidad de unidades agregadas al carrito de visitantes de búsquedas |
| 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 |
Explora las métricas de los visitantes
Un visitante de navegación es un visitante 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, como se define en las métricas de visitantes de búsqueda.
| Nombre de la métrica | Descripción |
|---|---|
| browse_visitor | Cantidad de visitantes que realizan al menos una navegació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 | Cantidad de vistas de página de detalles de los visitantes 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. En las siguientes secciones, se proporcionan algunas formas comunes de explorar tus métricas exportadas con SQL.
Cómo calcular la tasa de clics (CTR)
Calcula la CTR de las búsquedas 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 páginas de detalles impulsadas por la navegación
Obtén eventos de vista de la 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 las dimensiones. 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)
Cómo obtener las configuraciones de entrega más utilizadas
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