Exportar datos a BigQuery

En esta página se describe cómo subir datos de productos y eventos de usuario del comercio a BigQuery. Una vez que tus datos estén en BigQuery, podrás usarlos para hacer previsiones de ventas con Vertex AI y verlos en paneles de Looker prediseñados.

Si tus datos de comercio ya están en las tablas de eventos de producto y de usuario de BigQuery, en el formato de Vertex AI Search para comercio, puedes saltarte esta página e ir directamente a Obtener paneles de control que muestren indicadores clave del rendimiento y Generar previsiones de ventas a partir de datos de comercio. Para obtener más información sobre el formato, consulta los artículos Esquema de producto y Acerca de los eventos de usuario.

Antes de empezar

Antes de exportar sus datos de comercio a BigQuery, debe haber completado los procedimientos que se describen en la sección Configuración inicial.

Entre los datos que recoge se incluyen los siguientes:

Crear un conjunto de datos en BigQuery

Debe crear uno o dos conjuntos de datos en BigQuery para almacenar los datos de eventos de producto y de usuario.

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 hayas implementado Vertex AI Search for commerce.

  1. Si no has usado BigQuery en tu proyecto antes, habilita la API BigQuery y asegúrate de que tienes 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 IAM de la documentación de BigQuery.

  2. Crea un conjunto de datos en BigQuery en la multirregión de EE. UU.. Por ejemplo, llámalo retail_data.

  3. Opcional: Si quieres colocar los datos de eventos de usuario en un conjunto de datos independiente de los datos de producto, crea un segundo conjunto de datos. Por ejemplo, llámalo retail_user_event_data.

Para obtener más información sobre cómo crear 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.

Exportar el catálogo de Vertex AI Search for commerce a una tabla de BigQuery

Usa el método export para exportar tu catálogo de comercio 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.
  • BRANCH_ID: 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 de catálogo.
  • DATASET_ID: el nombre del conjunto de datos que has creado en Crear un conjunto de datos en BigQuery. Por ejemplo, usa retail_data o retail_product_data. El conjunto de datos debe estar en el mismo proyecto. No añadas el ID de proyecto al campo datasetId.
  • TABLE_ID_PREFIX: prefijo del ID de la tabla. Este prefijo no puede ser una cadena vacía. Se añade el sufijo _retail_products_BRANCH_ID para completar el nombre de la tabla. Por ejemplo, si el prefijo es test, la tabla se llama _test_retail_products_BRANCH_ID.

Cuerpo JSON de la solicitud: 

{
  "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/branches/BRANCH_ID/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_BRANCH_ID"
        }
      ]
    }
  }
}

Exportar eventos de usuario a una tabla de BigQuery

Usa el método userEvents.export para exportar tus eventos de usuario del comercio 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_data o retail_product_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_products para completar el nombre de la tabla. Por ejemplo, si el prefijo es test, la tabla se llama test_retail_products.

Cuerpo JSON de la solicitud: 

{
  "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/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 indica lo que debe saber sobre los datos de comercio que exporta a tablas de BigQuery:

  • Los datos que se exportan a las tablas de BigQuery de 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 usuario exportados

A continuación, se indica lo que debe saber sobre la información de producto que se incluye en los datos de eventos de usuario exportados.

Información sobre el precio de los productos

La forma en que el método userEvents.export devuelve la información sobre el precio de los productos depende de lo siguiente:

  • Ha incluido información de precios en los datos de eventos de usuario en el momento de la ingesta. Cuando llamas al método userEvents.export, el precio que se devuelve con un evento de usuario es el precio del producto en el momento del evento.

  • No ha incluido información sobre precios en los datos de eventos de usuario, pero sí en los datos de producto en el momento de la ingesta. Cuando llamas al método userEvents.export, el precio devuelto con un evento de usuario no es necesariamente el precio del producto en el momento del evento. Es el precio que figura en sus datos de producto en el momento de la ingestión.

  • No ha incluido información sobre precios en los datos de eventos de usuario y no hay información sobre precios disponible en los datos de producto. Cuando llamas al método userEvents.export, no se devuelve ningún precio con los eventos de usuario.

Otra información sobre el producto

Toda la información de los productos (excepto el precio) se combina con la información de los eventos de usuario en el momento en que llama al método userEvents.export. Los valores de los productos pueden cambiar desde el momento del evento de usuario hasta el momento en que llames a userEvents.export. Por este motivo, los valores de los productos sin precio devueltos en la tabla de eventos de usuario podrían ser diferentes de los valores de los productos en el momento del evento de usuario.

Opcional: Confirma que las nuevas tablas están en BigQuery

Una vez que haya exportado sus datos de producto y de eventos de usuario a BigQuery, compruebe que las nuevas tablas estén presentes.

  1. En BigQuery, ve al conjunto de datos o a los conjuntos de datos que has creado en Crear un conjunto de datos en BigQuery.

  2. Abre los conjuntos de datos y comprueba que aparecen las dos tablas que has exportado. Por ejemplo, busca tablas cuyos nombres terminen en _retail_products_BRANCH_ID y retail_user_events.

Para obtener más información sobre cómo trabajar con tablas de BigQuery, consulta el artículo Consultar y ver datos.

Consulta la página Gobierno de datos para obtener más información sobre cómo gestiona Vertex AI Search for commerce los datos de clientes.