En esta página, se describe cómo exportar las métricas de análisis de Vertex AI Search para el comercio a BigQuery. Si exportas las métricas de Analytics, puedes conservarlas y escribir código SQL para tu propio análisis.
Las métricas de análisis de Vertex AI Search para el comercio se generan automáticamente para ti. Para obtener más información sobre cómo medir el impacto comercial de Vertex AI Search for Commerce con métricas de Analytics, 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 comercio electrónico 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 para eventos del 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
Antes de exportar tus métricas a BigQuery, debes completar los procedimientos que se indican en Antes de comenzar. Esto incluye la importación de 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 recursos:
- Importar información de los catálogos
- Registra 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 los datos de las métricas de Analytics.
Debes crear los conjuntos de datos en el mismo proyecto en el que implementaste Vertex AI Search for Commerce.
Si nunca 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 multirregión US (múltiples regiones en Estados Unidos). 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 la CMEK para el conjunto de datos. Si la habilitas, se producirá un error en la exportación.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 almacenar las tablas de datos que exportes. En los siguientes procedimientos, se describe cómo exportar.
Exporta 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 Commerce 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 el 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 una ligera variación en algunas métricas de recuento, ya que el filtrado de bots podría excluir algunos eventos del cálculo de las 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 los eventos de usuarios pertinentes 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 de 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 impresión, esta es la fecha de los eventos de impresión. En el caso de las métricas de sesión y de visitante, esta es la fecha del primer evento de impresión de la sesión o del visitante. |
| external_experiment_ids |
Son los IDs de los experimentos de los eventos relevantes que generaron las métricas. En el caso de las métricas de impresión, este es el ID del experimento del evento de impresión. En el caso de las métricas de sesión y de visitantes, se trata de la concatenación de los IDs externos únicos del experimento 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 dentro de 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 generó desde un dispositivo móvil o una computadora. En el caso de las métricas de impresiones, se trata del tipo de dispositivo del evento de impresión. En el caso de las métricas de sesión y de visitantes, este campo está vacío si la sesión o el visitante tienen más de un tipo de dispositivo distinto, o bien contiene el valor "one" si solo hay un tipo de dispositivo para toda la sesión o el visitante. |
| serving_config |
Es la configuración de entrega de los eventos relevantes que generaron las métricas. En el caso de las métricas de impresión, esta es la configuración de publicación del evento de impresión. En el caso de las métricas de sesión y de visitantes, este campo está vacío si la sesión o el visitante tienen más de una configuración de entrega distinta, o bien contiene la única configuración de entrega si solo hay una 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 la impresión se publica a través de Google o "Non-Google" si la impresión se publica a través de tu propia solución. En el caso de las métricas de sesión y de visitantes, el valor es "Mixto" si la sesión o el visitante tienen eventos de impresión publicados tanto por Google como por tu propia solución. Será "Google" si los eventos de impresión se publican exclusivamente a través de Google o "Non-Google" si los eventos de impresión se publican exclusivamente a través de tu solución 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 usan este atributo. Por lo general, la entidad representa las marcas o las ubicaciones. Para las métricas de impresiones, esta es la entidad del evento de impresión. En el caso de las métricas de sesiones y visitantes, se trata de las cinco principales entidades contabilizadas de los eventos de impresión para 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) solo se pueden atribuir a un evento de impresión 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 produjo el evento de impresión. Se aplican diferentes ventanas de tiempo de conversión para los 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 | Cantidad de eventos de vista de página de detalles desde la búsqueda |
| add_to_cart_unit_from_search | Cantidad de unidades agregadas al carrito desde la búsqueda |
| purchase_unit_from_search | Cantidad de unidades de compra desde la búsqueda |
| revenue_from_search | Ingresos por búsquedas |
| search_event_without_result | Recuento de eventos de búsqueda que no arrojan resultados |
| search_request_personalization_enabled | Es la cantidad de solicitudes de búsqueda con la personalización habilitada. |
| search_request_personalization_result_served | Es el recuento de las 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 agregadas al carrito desde la navegación |
| purchase_unit_from_browse | Cantidad de unidades de compra desde la exploración |
| revenue_from_browse | Ingresos por exploración |
| browse_event_without_result | Recuento de eventos de navegación que no arrojan resultados |
| browse_request_personalization_enabled | Cantidad de solicitudes de exploración con la personalización habilitada |
| browse_request_personalization_result_served | Es el recuento de las solicitudes de exploració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 siguientes 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.
Las dimensiones que caracterizan las métricas de sesión se definen de forma conjunta para todos los eventos del usuario dentro de la sesión. Consulta las dimensiones de métricas para saber cómo se establecen los valores de las dimensiones para la sesión.
| Nombre de la métrica | Descripción |
|---|---|
| sesión | Recuento de sesiones |
Métricas de sesiones 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 exploración, según se define en las métricas de sesión de exploració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 dentro de 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 la página de detalles en las sesiones de búsqueda |
| add_to_cart_in_search_session | Cantidad de eventos de agregar al carrito en 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 sesiones de búsqueda |
| purchase_unit_in_search_session | Cantidad de unidades de compra en 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 exploración es una sesión que contiene al menos un evento de exploración. Ten en cuenta que una sesión de navegación también puede ser una sesión de búsqueda, según se define en las métricas de sesión de búsqueda.
| Nombre de la métrica | Descripción |
|---|---|
| browse_session | Recuento de sesiones que incluyen la navegación |
| search_event_in_browse_session | Recuento de eventos de búsqueda dentro de las 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 la página de detalles en las sesiones de exploración |
| add_to_cart_in_browse_session | Cantidad de eventos de agregar al carrito en sesiones de exploración |
| add_to_cart_unit_in_browse_session | Cantidad de unidades agregadas al carrito en las sesiones de exploración |
| purchase_order_in_browse_session | Cantidad de órdenes de compra en sesiones de exploración |
| purchase_unit_in_browse_session | Cantidad de unidades de compra en sesiones de exploración |
| revenue_in_browse_session | Ingresos en las sesiones de exploració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 cada visitante de forma única. Las métricas de visitantes agregan toda la información de los eventos del usuario para el visitante.
Las dimensiones que caracterizan las métricas de visitantes se definen de forma conjunta para todos los eventos del usuario del visitante. Consulta las dimensiones de métricas para saber cómo se establecen los valores de las dimensiones para el visitante.
| Nombre de la métrica | Descripción |
|---|---|
| visitante | Recuento de visitantes |
Métricas de visitantes de la Búsqueda
Un visitante de la 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 | Recuento de eventos de búsqueda de visitantes de la búsqueda |
| browse_event_from_search_visitor | Recuento de eventos de navegación de los visitantes que realizaron búsquedas |
| detail_page_view_from_search_visitor | Cantidad de vistas de la página de detalles de los visitantes que provienen de la Búsqueda |
| add_to_cart_from_search_visitor | Recuento de eventos de agregar al carrito de los visitantes que realizaron búsquedas |
| add_to_cart_unit_from_search_visitor | Cantidad de unidades agregadas al carrito por los visitantes que realizaron búsquedas |
| purchase_order_from_search_visitor | Recuento de órdenes de compra de los visitantes que realizaron búsquedas |
| purchase_unit_from_search_visitor | Unidad de recuento de compras de los visitantes que realizaron búsquedas |
| revenue_from_search_visitor | Ingresos provenientes de los visitantes que realizaron búsquedas |
Explora las métricas de visitantes de navegación
Un visitante de exploración es aquel que realiza al menos un evento de exploración. Ten en cuenta que un visitante de exploración también puede ser un visitante de búsqueda, según 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 búsqueda |
| search_event_from_browse_visitor | Recuento de eventos de búsqueda de visitantes que exploraron |
| 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 la página de detalles de los visitantes que navegaron |
| add_to_cart_from_browse_visitor | Recuento de eventos de agregar al carrito de los visitantes que exploran |
| add_to_cart_unit_from_browse_visitor | Cantidad de unidades agregadas al carrito por los visitantes que exploran |
| purchase_order_from_browse_visitor | Cantidad de órdenes de compra de los visitantes que exploran |
| purchase_unit_from_browse_visitor | Cantidad de unidades compradas por los visitantes que exploran |
| revenue_from_browse_visitor | Ingresos provenientes de los visitantes que exploran |
Ejemplo de uso
Si copias o exportas tus datos de métricas a otro destino, puedes usar SQL para obtener información general o específica sobre las métricas exportadas. En las siguientes secciones, se proporcionan algunas formas comunes de explorar las métricas exportadas con SQL.
Calcula la tasa de clics (CTR)
Calcula el CTR de la búsqueda por fecha, tipo de dispositivo y 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 generadas 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 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)
Obtén las configuraciones de entrega más usadas
Obtén las configuraciones de entrega más usadas 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