En esta página se describe cómo exportar métricas de analíticas de Vertex AI Search para el comercio a BigQuery. Al exportar métricas de analíticas, puede conservar las métricas y escribir código SQL para realizar sus propios análisis.
Las métricas de analíticas de Vertex AI Search para el sector del comercio se generan automáticamente. Para obtener más información sobre cómo medir el impacto empresarial de Vertex AI Search para el comercio con métricas de analíticas, consulte Ver analíticas.
La exportación de datos de métricas a BigQuery tiene las siguientes limitaciones:
Los datos que se exportan a las tablas de BigQuery de tu proyecto de Vertex AI Search for commerce 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 puede 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 de ese periodo.
Antes de empezar
Antes de exportar sus métricas a BigQuery, debe haber completado los procedimientos descritos en la sección Antes de empezar. Esto incluye la importación de sus eventos de usuario y, opcionalmente, de la información de su catálogo.
Para obtener más información sobre la importación, consulta los siguientes artículos:
- Importar información de catálogos
- Registrar eventos de usuario en tiempo real
- Importar historial de eventos de usuario
Crear un conjunto de datos en BigQuery
Debe crear un conjunto de datos en BigQuery para almacenar los datos de métricas de Analytics.
Debes crear los conjuntos de datos en el mismo proyecto en el que hayas implementado Vertex AI Search para el comercio.
Si no has usado BigQuery en tu proyecto antes, habilita la API BigQuery y asegúrate de tener el rol de gestión de identidades y accesos que te permite crear conjuntos de datos y tablas.
Consulta las secciones Antes de empezar y Control de acceso con la gestión de identidades y accesos.
en la documentación de BigQuery.
Crea un conjunto de datos en BigQuery en la multirregión US (varias regiones de Estados Unidos). Por ejemplo, llámalo
retail_data. Si creas el conjunto de datos en otra región, no podrás exportar los datos a BigQuery. No se admite CMEK para el conjunto de datos. Si se habilita, la exportación fallará.Para obtener información sobre cómo crear un conjunto de datos, consulta el artículo Crear conjuntos de datos de 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.
Exportar métricas de analíticas a una tabla de BigQuery
Usa el método exportAnalyticsMetrics para exportar tu catálogo de productos a una tabla de BigQuery.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: ID del proyecto de la API Vertex AI Search for commerce en el que ha creado el conjunto de datos de BigQuery.
-
DATASET_ID: el nombre del conjunto de datos que has creado en
Crear un conjunto de datos en BigQuery. Por ejemplo, usa
retail_dataoretail_metrics_data. -
TABLE_ID_PREFIX: prefijo del ID de la tabla. Este prefijo no puede ser una cadena vacía. Se añade el sufijo
retail_analytics_metricspara completar el nombre de la tabla. Por ejemplo, si el prefijo estest, la tabla se llamatest_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, despliega una de estas opciones:
Deberías recibir una respuesta JSON similar a la siguiente:
{
"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 porque el filtro de bots puede excluir algunos eventos del cálculo de las métricas. El filtrado de bots puede ayudar a ofrecer mediciones del rendimiento más precisas. Esto no afecta a 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 brutos agregados directamente de los eventos de usuario relevantes
con las mismas dimensiones. Para interpretar las métricas, debe saber en qué dimensiones se basan. A efectos de las métricas de analíticas, los eventos de búsqueda y navegació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 tabla siguiente se definen las dimensiones de las métricas.
| Dimensión de métrica | Descripción |
|---|---|
| fecha |
Fecha de los eventos relevantes que han generado 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, se trata de la fecha del primer evento de impresión de la sesión o del visitante. |
| external_experiment_ids |
Los IDs de los experimentos de los eventos relevantes que han generado las métricas. En el caso de las métricas de impresiones, es el ID del experimento del evento de impresión. En el caso de las métricas de sesión y visitante, se trata de la concatenación de los IDs de experimento 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 los IDs de experimento externo "test_arm_1,test_arm_2" y el segundo evento de búsqueda tiene los IDs de experimento externo "test_arm_1,test_arm_3", entonces los IDs de experimento externo de la sesión o el visitante son "test_arm_1,test_arm_2,test_arm_3". |
| device_type |
El tipo de dispositivo de los eventos relevantes que han generado las métricas. Por ejemplo, si el evento se ha generado desde un dispositivo móvil o un ordenador. En el caso de las métricas de impresiones, se indica de qué tipo es el 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 contiene el tipo de dispositivo si solo hay uno en toda la sesión o el visitante. |
| serving_config |
La configuración de publicación de los eventos pertinentes que han generado las métricas. En el caso de las métricas de impresiones, se trata de 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 tienen más de una configuración de publicación distinta. Si solo hay una configuración de publicación para toda la sesión o el visitante, se muestra esa configuración. |
| traffic_destination |
La fuente de los eventos relevantes que han generado las métricas. En el caso de las métricas de impresiones, el valor es "Google" si la impresión la sirve Google o "Non-Google" si la sirve 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 tiene eventos de impresión servidos tanto por Google como por su propia solución. Si los eventos de impresión se sirven únicamente a través de Google, el valor será "Google". Si se sirven únicamente a través de su solución durante toda la sesión o para todo el visitante, el valor será "Non-Google". |
| entidad |
Lo usan los comercios que ofrecen varios sitios de marca o regiones con un solo catálogo de productos. La entidad suele representar las marcas o las ubicaciones. En el caso de las métricas de impresiones, es la entidad del evento de impresión. En el caso de las métricas de sesiones y visitantes, se trata de las cinco entidades más contabilizadas de los eventos de impresión de la sesión o del 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 los siguientes criterios.
El evento de impresión y el evento de conversión tienen el mismo visitante.
El ID de producto del evento de conversión debe aparecer en los resultados del evento de impresión.
El evento de conversión se produce dentro del periodo requerido después del evento de impresión. Se aplican ventanas de tiempo de conversión diferentes a los distintos tipos de eventos de conversión.
Ruta de conversión Ventana temporal de conversión Impresión -> Vista de página de detalles 60 segundos Impresión -> Añadir 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 página de detalles procedentes de la búsqueda |
| add_to_cart_unit_from_search | Número de unidades añadidas al carrito desde la búsqueda |
| purchase_unit_from_search | Recuento de unidades compradas a partir de búsquedas |
| revenue_from_search | Ingresos procedentes de la búsqueda |
| search_event_without_result | Buscar el recuento de eventos que no da ningún resultado |
| search_request_personalization_enabled | Número de solicitudes de búsqueda con la personalización habilitada. |
| search_request_personalization_result_served | Número de solicitudes de búsqueda que se sirven con resultados personalizados. |
Consultar métricas de impresiones
| Nombre de la métrica | Descripción |
|---|---|
| browse_event | Consultar el número de eventos |
| detail_page_view_from_browse | Recuento de eventos de vista de página de detalles procedentes de la navegación |
| add_to_cart_unit_from_browse | Número de unidades añadidas al carrito desde la navegación |
| purchase_unit_from_browse | Número de unidades compradas desde la navegación |
| revenue_from_browse | Ingresos procedentes de la navegación |
| browse_event_without_result | Consultar el recuento de eventos que no da ningún resultado |
| browse_request_personalization_enabled | Número de solicitudes de navegación con la personalización habilitada. |
| browse_request_personalization_result_served | Número de solicitudes de navegación que se sirven con resultados personalizados. |
Métricas de sesión
Una sesión se define como un periodo continuo de interacción entre un usuario y el sistema. Cualquier evento de 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 30 minutos siguientes. La sesión se amplía otros 30 minutos cada vez que se produce un evento de usuario en una sesión iniciada. Cuando 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 conjuntamente mediante todos los eventos de usuario de la sesión. Consulte las dimensiones de métricas para saber cómo se definen los valores de las dimensiones de la sesión.
| Nombre de la métrica | Descripción |
|---|---|
| sesión | Número de sesiones |
Métricas de sesión de búsqueda
Una sesión de búsqueda es una sesión que contiene al menos un evento de búsqueda. Tenga en cuenta que una sesión de búsqueda también puede ser una sesión de navegación, tal como se define en las métricas de sesión de navegación.
| Nombre de la métrica | Descripción |
|---|---|
| search_session | Número de sesiones que incluyen una búsqueda |
| search_event_in_search_session | Número de eventos de búsqueda en sesiones de búsqueda |
| browse_event_in_search_session | Consultar el número de eventos en sesiones de búsqueda |
| detail_page_view_in_search_session | Número de vistas de la página de detalles en sesiones de búsqueda |
| add_to_cart_in_search_session | Número de eventos de añadir al carrito en sesiones de búsqueda |
| add_to_cart_unit_in_search_session | Número de acciones de añadir al carrito en sesiones de búsqueda |
| purchase_order_in_search_session | Número de órdenes de compra en sesiones de búsqueda |
| purchase_unit_in_search_session | Recuento de unidades compradas en sesiones de búsqueda |
| revenue_in_search_session | Ingresos de sesiones de búsqueda |
| bounce_count_in_search_session | Número de sesiones del visitante que abandona el sitio después de ver solo una página en las sesiones de búsqueda. |
Consultar métricas de sesión
Una sesión de navegación es una sesión que contiene al menos un evento de navegación. Tenga en cuenta que una sesión de navegación también puede ser una sesión de búsqueda, tal como 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 | Buscar el recuento de eventos en sesiones de navegación |
| browse_event_in_browse_session | Consultar el recuento de eventos en sesiones de navegación |
| detail_page_view_in_browse_session | Número de vistas de la página de detalles en sesiones de navegación |
| add_to_cart_in_browse_session | Número de eventos de añadir al carrito en sesiones de navegación |
| add_to_cart_unit_in_browse_session | Número de unidades añadidas al carrito en sesiones de navegación |
| purchase_order_in_browse_session | Número de órdenes de compra en sesiones de navegación |
| purchase_unit_in_browse_session | Recuento de unidades compradas en sesiones de navegación |
| revenue_in_browse_session | Ingresos de las sesiones de navegación |
| bounce_count_in_browse_session | Número de sesiones del visitante que abandona el sitio después de ver solo una página en sesiones de navegación |
Métricas de visitantes
Un visitante se identifica de forma única mediante el ID de visitante. Las métricas de visitante agregan toda la información de eventos de usuario del visitante.
Las dimensiones que caracterizan las métricas de visitantes se definen conjuntamente mediante todos los eventos de usuario del visitante. Consulte las dimensiones de métricas para saber cómo se definen los valores de las dimensiones del visitante.
| Nombre de la métrica | Descripción |
|---|---|
| Visitante | Recuento de visitantes |
Buscar métricas de visitantes
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, tal como se define en las métricas de visitante de navegación.
| Nombre de la métrica | Descripción |
|---|---|
| search_visitor | Número de visitantes que realizan al menos una búsqueda |
| search_event_from_search_visitor | Número de eventos de búsqueda de visitantes de la búsqueda |
| browse_event_from_search_visitor | Número de eventos de navegación de los visitantes de la búsqueda |
| detail_page_view_from_search_visitor | Recuento de vistas de página de detalles de visitantes procedentes de la Búsqueda |
| add_to_cart_from_search_visitor | Número de eventos de añadir al carrito de visitantes de la búsqueda |
| add_to_cart_unit_from_search_visitor | Número de unidades añadidas al carrito por visitantes de la búsqueda |
| purchase_order_from_search_visitor | Número de pedidos de 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 de visitantes de la búsqueda |
Consultar métricas de visitantes
Un visitante de navegación es un visitante que realiza al menos un evento de navegación. Ten en cuenta que un visitante que navega también puede ser un visitante que busca, tal como se define en las métricas de visitantes que buscan.
| Nombre de la métrica | Descripción |
|---|---|
| browse_visitor | Número de visitantes que realizan al menos una búsqueda |
| search_event_from_browse_visitor | Buscar el recuento de eventos de visitantes que han llegado a través de la navegación |
| browse_event_from_browse_visitor | Consultar el recuento de eventos de los visitantes que navegan |
| detail_page_view_from_browse_visitor | Número de vistas de la página de detalles de los visitantes que han llegado a través de la navegación |
| add_to_cart_from_browse_visitor | Número de eventos de añadir al carrito de visitantes que han navegado |
| add_to_cart_unit_from_browse_visitor | Número de unidades añadidas al carrito de visitantes que han navegado |
| purchase_order_from_browse_visitor | Número de pedidos de visitantes que han navegado |
| purchase_unit_from_browse_visitor | Número de unidades compradas por visitantes que han navegado |
| revenue_from_browse_visitor | Ingresos de visitantes que navegan |
Ejemplo de uso
Si copia o exporta sus datos de métricas a otro destino, puede usar SQL para obtener información general o específica sobre las métricas exportadas. En las siguientes secciones se describen algunas formas habituales de explorar las métricas exportadas mediante SQL.
Calcular el porcentaje de clics (CTR)
Calcula el CTR de 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
Obtener el recuento de vistas de la página de detalles procedentes de la navegación
Obtén eventos de vista de página de detalles que procedan de eventos de navegación del tráfico de Google con external_experiment_ids que contenga 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)
Obtener las configuraciones de publicación más usadas
Obtén las configuraciones de servicio más usadas entre el 1 de octubre del 2023 y el 1 de noviembre del 2023 para el tráfico de Google. Cada evento de búsqueda debe tener una configuración de servicio 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