En esta página, se describe cómo subir datos de productos minoristas y eventos de usuario a BigQuery. Una vez que tus datos estén en BigQuery, podrás usarlos para realizar previsiones de ventas con Vertex AI y ver los datos en los paneles prediseñados de Looker.
Si tus datos de comercio electrónico ya se encuentran en tablas de eventos de productos y usuarios en BigQuery, en el formato de Vertex AI Search para comercio electrónico, puedes omitir esta página y dirigirte directamente a Obtén paneles que muestren indicadores clave de rendimiento y Genera previsiones de ventas a partir de datos de comercio minorista. Para obtener más información sobre el formato, consulta Esquema de producto y Acerca de los eventos de usuario.
Antes de comenzar
Antes de exportar tus datos de comercio a BigQuery, debes completar los procedimientos que se indican en Configuración inicial.
Esto incluye lo siguiente:
- Importar información de los catálogos
- Cómo registrar eventos de usuario en tiempo real
- Importar eventos históricos de usuarios
Crea un conjunto de datos en BigQuery
Debes crear uno o dos conjuntos de datos en BigQuery para almacenar los datos de eventos de productos y usuarios.
Puedes usar un conjunto de datos para almacenar ambos tipos de datos o crear dos conjuntos de datos, uno para cada tipo de datos.
Debes crear los conjuntos de datos en el mismo proyecto en el que implementaste Vertex AI Search for Commerce.
Si no usaste BigQuery en tu proyecto antes, 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 de EE.UU.. Por ejemplo, asígnale el nombre
retail_data
.Opcional: Para colocar los datos de eventos del usuario en un conjunto de datos independiente de los datos del producto, crea un segundo conjunto de datos. Por ejemplo, asígnale el nombre
retail_user_event_data
.
Para obtener más información sobre la creación de conjuntos de datos de BigQuery, consulta 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 tu catálogo de Vertex AI Search para comercio a una tabla de BigQuery
Usa el método export
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.
-
BRANCH_ID: Es el ID de la rama del catálogo. Usa
default_branch
para obtener datos de la rama predeterminada. Para obtener más información, consulta Ramas del catálogo. -
DATASET_ID: Es el nombre del conjunto de datos que creaste en
Crea un conjunto de datos en BigQuery. Por ejemplo, usa
retail_data
oretail_product_data
. El conjunto de datos debe estar en el mismo proyecto. No agregues el ID del proyecto al campodatasetId
aquí. -
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_products
para completar el nombre de la tabla. Por ejemplo, si el prefijo estest
, la tabla se llamarátest_retail_products
.
Cuerpo JSON de la solicitud:
{ "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/branches/0/operations/17986570020347019923", "done": true, "response": { "@type": "type.googleapis.com/google.cloud.retail.v2alpha.ExportProductsResponse", "outputResult": { "bigqueryResult": [ { "datasetId": "DATASET_ID", "tableId": "TABLE_ID_PREFIX_retail_products" } ] } } }
Exporta tus eventos de usuario a una tabla de BigQuery
Usa el método userEvents.export
para exportar tus eventos de usuario 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_data
oretail_product_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_products
para completar el nombre de la tabla. Por ejemplo, si el prefijo estest
, la tabla se llamatest_retail_products
.
Cuerpo JSON de la solicitud:
{ "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/17203443067109586170", "done": true, "response": { "@type": "type.googleapis.com/google.cloud.retail.v2alpha.ExportUserEventsResponse", "outputResult": { "bigqueryResult": [ { "datasetId": "DATASET_ID", "tableId": "TABLE_ID_PREFIX_retail_user_events" } ] } } }
Acerca de los datos exportados
A continuación, se indican algunos aspectos que debes tener en cuenta sobre los datos de comercio que exportas a las tablas de BigQuery:
Los datos que se exportan a las tablas de BigQuery en tu proyecto son vistas autorizadas, no vistas materializadas.
No puedes cambiar ni actualizar los datos de estas tablas.
Los productos se actualizan cada hora.
Los eventos de usuario se actualizan casi en tiempo real.
Acerca de los datos de eventos de usuarios exportados
A continuación, se incluye información sobre los datos del producto que se incluyen con los datos de eventos del usuario exportados.
Información sobre el precio del producto
La forma en que el método userEvents.export
devuelve la información del precio del producto depende de lo siguiente:
Incluiste información de precios en los datos de eventos del usuario en el momento de la transferencia. Cuando llamas al método
userEvents.export
, el precio que se devuelve con un evento del usuario es el precio del producto en el momento del evento.No incluiste información sobre el precio en los datos de tu evento de usuario, pero sí lo hiciste en los datos de tu producto en el momento de la transferencia. Cuando llamas al método
userEvents.export
, el precio que se muestra con un evento del usuario no es necesariamente el precio del producto en el momento del evento. Es el precio que se encuentra en tus datos de productos en el momento de la transferencia.No incluiste información de precios en los datos de tus eventos de usuario y no hay información de precios disponible en tus datos de productos. Cuando llamas al método
userEvents.export
, no se muestra ningún precio con los eventos de usuario.
Otra información del producto
Toda la información del producto (excepto el precio) se une a la información del evento del usuario en el momento en que llamas al método userEvents.export
. Los valores de los productos pueden cambiar desde el momento del evento del usuario hasta el momento en que llamas a userEvents.export
. Por este motivo, los valores de los productos que no son de precio y que se muestran en la tabla de eventos del usuario pueden ser diferentes de los valores de los productos en el momento del evento del usuario.
Opcional: Confirma que las tablas nuevas estén en BigQuery
Después de exportar tus datos de productos y de eventos del usuario a BigQuery, asegúrate de que haya tablas nuevas.
En BigQuery, navega al conjunto de datos o a los conjuntos de datos que creaste en Crea un conjunto de datos en BigQuery.
Abre los conjuntos de datos y asegúrate de ver las dos tablas que exportaste. Por ejemplo, busca tablas con nombres que terminen en
retail_products
yretail_user_events
.
Si deseas obtener más información para trabajar con tablas de BigQuery, consulta Consulta y visualiza datos.
Revisa la página Administración de datos para obtener más información sobre cómo Vertex AI Search para el comercio maneja los datos de los clientes.