Requisitos previos de configuración

Antes de configurar Vertex AI Search for Commerce para un proyecto nuevo, debes hacer lo siguiente:

  1. Crea un proyecto nuevo o configura tu proyecto existente
  2. Habilita Vertex AI Search for Commerce
  3. Importa tu catálogo de productos y tus eventos de usuario

Crea un Google Cloud proyecto

  1. En la página Administrar recursos de la Google Cloud consola, selecciona o crea un Google Cloud proyecto.

    Ir a la página Administración de recursos

  2. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

Configura Vertex AI Search for Commerce

Para usar Vertex AI Search for Commerce, sigue estos pasos. Además, si habilitas Vertex AI Search for Commerce y usas recomendaciones, ten en cuenta que los costos se basan en la cantidad de búsquedas. Para obtener más información sobre los precios de Vertex AI Search para el comercio, consulta los cargos de Vertex AI Search para el comercio.

Para tu proyecto nuevo

Para configurar Vertex AI Search for Commerce, haz lo siguiente:

  1. Ve a la página Vertex AI Search for commerce en la consola de Google Cloud .

    Ir a la página Búsqueda para comercio

  2. En la página Configura Vertex AI Search for Commerce, haz clic en Activar la API.

  3. Cuando Vertex AI Search para comercio y Recommendations AI aparezcan como Activados, haz clic en Continuar.

  4. Lee las condiciones de uso de datos de Vertex AI Search for Industry y haz clic en Aceptar si aceptas las condiciones de uso de datos. Recibirás una confirmación de la Google Cloud consola una vez que se hayan aceptado las condiciones para la búsqueda.

  5. Si solo quieres usar el proyecto con recomendaciones, haz clic en Comenzar.

  6. Para activar la búsqueda además de las recomendaciones, haz lo siguiente:

    1. Haz clic en Continuar y, luego, en Activar en la página Activar la búsqueda (opcional).
    2. Haz clic en Comenzar.

    La consola Google Cloud muestra los componentes de Vertex AI Search for Commerce que activaste. Ahora puedes configurar los parámetros iniciales de tu proyecto.

Para un proyecto existente

Para continuar con un proyecto existente, completa estos pasos:

  1. Ve a la página Search for commerce en la consola de Google Cloud para tu proyecto.

    Ir a la página Búsqueda para comercio

  2. En la página Condiciones de uso de datos, lee las condiciones de uso de datos de Discovery Solutions y haz clic en Aceptar si estás de acuerdo con ellas.

  3. Si solo quieres usar el proyecto con recomendaciones, haz clic en Comenzar.

  4. Si quieres activar la búsqueda además de las recomendaciones, haz lo siguiente:

    1. Haz clic en Continuar y, luego, en Activar en la página Activar la búsqueda (opcional).
    2. Haz clic en Comenzar.

Desactivar las funciones de búsqueda

Si ya no quieres usar la búsqueda, puedes desactivarla enviando un ticket de asistencia.

Para establecer el ticket en el componente correcto, selecciona los siguientes campos:

  • Categoría: Aprendizaje automático
  • Componente: Vertex AI Search for Commerce: búsqueda y exploración
  • Subcomponente: Administración de cuentas y facturación

Para obtener más información sobre cómo crear un ticket de asistencia, consulta Obtén asistencia.

Desactiva Vertex AI Search for Commerce

Puedes desactivar Vertex AI Search for Commerce en cualquier momento. Esta acción desactiva tanto las recomendaciones como la búsqueda.

Para desactivar Vertex AI Search for Commerce, completa los siguientes pasos:

  1. Ve a la página Vertex AI Search for Retail API/Service Details en la consola deGoogle Cloud .

    Ir a la página Detalles del servicio de la API de Vertex AI Search for Commerce

  2. Haz clic en Inhabilitar API.

  3. En el cuadro ¿Inhabilitar la API de Vertex AI Search for Commerce?, haz clic en Inhabilitar.

Comienza a usar Vertex AI Search for Commerce

Cuando configuras Vertex AI Search for Commerce para un proyecto nuevo, la consola deGoogle Cloud muestra los siguientes tres paneles para ayudarte a configurar tu proyecto de Vertex AI Search for Commerce:

  • Datos > Catálogo: Muestra tu catálogo de productos y un vínculo para importarlo.

  • Datos > Eventos: Muestra tus eventos de usuarios y un vínculo para importar eventos de usuarios históricos.

  • Parámetros de configuración de entrega: Contiene detalles sobre tu configuración de entrega y un vínculo para crear una nueva.

Puedes usar estos paneles para importar tus datos y crear una configuración inicial para tu proyecto de Vertex AI Search para el comercio.

Importa tu catálogo de productos

Para importar tu catálogo de productos, completa el conjunto de pasos para tu fuente de datos. Para obtener más información sobre los catálogos de productos, consulta Cómo importar información del catálogo.

Sincronización de Merchant Center

  1. Haz clic en Importar catálogo de productos para abrir el panel Importar datos.
  2. Elige Catálogo de productos.
  3. Selecciona Sincronización de Merchant Center como tu fuente de datos.
  4. Selecciona tu cuenta de Merchant Center. Si no ves tu cuenta, marca Acceso del usuario.
  5. Opcional: Selecciona Filtro de feeds de Merchant Center para importar solo las ofertas de los feeds seleccionados.

    Si no se especifica, se importarán las ofertas de todos los feeds (incluidos los futuros).
  6. Opcional: Para importar solo las ofertas segmentadas para ciertos países o idiomas, expande Mostrar opciones avanzadas y selecciona los países de venta y los idiomas de Merchant Center por los que deseas filtrar.
  7. Selecciona la rama a la que subirás tu catálogo.
  8. Haz clic en Importar.

Cloud Storage

  1. Haz clic en Importar catálogo de productos para abrir el panel Importar datos.
  2. Elige Catálogo de productos como tu fuente de datos.
  3. Selecciona la rama a la que subirás tu catálogo.
  4. Elige Esquema de catálogos de productos de venta minorista como el esquema.
  5. Ingresa la ubicación de Cloud Storage de tus datos.
  6. Si no tienes habilitada la búsqueda, selecciona los niveles de producto.

    Debes seleccionar los niveles de producto si es la primera vez que importas tu catálogo o si vuelves a importar el catálogo después de borrarlo definitivamente. Obtén más información sobre los niveles de producto. Cambiar los niveles de producto después de importar cualquier dato requiere un esfuerzo significativo.

    Importante: No puedes activar la búsqueda para proyectos con un catálogo de productos que se haya transferido como variantes.
  7. Haz clic en Importar.

BigQuery

  1. Haz clic en Importar catálogo de productos para abrir el panel Importar datos.
  2. Elige Catálogo de productos.
  3. Selecciona BigQuery como tu fuente de datos.
  4. Selecciona la rama a la que subirás tu catálogo.
  5. Elige uno de los siguientes esquemas:
  6. Ingresa la tabla de BigQuery donde se encuentran tus datos.
  7. Opcional: En Mostrar opciones avanzadas, ingresa la ubicación de un bucket de Cloud Storage en tu proyecto como una ubicación temporal para tus datos.

    Si no se especifica, se usa una ubicación predeterminada. Si se especifica, el bucket de Cloud Storage y BigQuery deben estar en la misma región.
  8. Si no tienes habilitada la búsqueda y usas el esquema de Merchant Center, selecciona el nivel del producto.

    Debes seleccionar el nivel del producto si es la primera vez que importas tu catálogo o si vuelves a importar el catálogo después de borrarlo definitivamente. Obtén más información sobre los niveles de producto. Cambiar los niveles de producto después de importar cualquier dato requiere un esfuerzo significativo.

    Importante: No puedes activar la búsqueda para proyectos con un catálogo de productos que se haya transferido como variantes.
  9. Haz clic en Importar.

Importa tus eventos históricos de usuarios

Para importar tus eventos de usuario históricos, completa el conjunto de pasos para tu fuente de datos. Para obtener más información sobre los eventos históricos de usuarios, consulta Importa eventos históricos de usuarios.

Cloud Storage

  1. Haz clic en Importar eventos de usuario para abrir el panel Importar datos.
  2. Elige Eventos de usuario.
  3. Selecciona Google Cloud Storage como la fuente de datos.
  4. Elige Esquema de eventos de usuarios de venta minorista como el esquema.
  5. Ingresa la ubicación de Cloud Storage de tus datos.
  6. Haz clic en Importar.

BigQuery

  1. Haz clic en Importar eventos de usuario para abrir el panel Importar datos.
  2. Elige Eventos de usuario.
  3. Selecciona BigQuery como la fuente de datos.

  4. Selecciona el esquema de datos.

  5. Ingresa la tabla de BigQuery donde se encuentran tus datos.
  6. Opcional: Ingresa la ubicación de un bucket de Cloud Storage en tu proyecto como una ubicación temporal para tus datos.
    Si no se especifica, se usará una ubicación predeterminada. Si se especifica, el bucket de Cloud Storage y BigQuery deben estar en la misma región.
  7. Opcional: En Mostrar opciones avanzadas, ingresa la ubicación de un bucket de Cloud Storage en tu proyecto como una ubicación temporal para tus datos.

    Si no se especifica, se usa una ubicación predeterminada. Si se especifica, el bucket de Cloud Storage y BigQuery deben estar en la misma región.
  8. Haz clic en Importar.

Crea una configuración de entrega

Una configuración de entrega es una entidad de entrega que asocia un modelo o un conjunto de controles que se usan para generar tus resultados de búsqueda o recomendación.

Para crear una configuración de publicación, completa los siguientes pasos:

  1. En el panel Opciones de configuración de entrega, haz clic en Crear una opción de configuración de entrega.
  2. En la página Create Serving Config, elige Search como el producto para el que se usará la configuración de entrega.
  3. Proporciona un nombre para tu configuración de publicación.

    El nombre debe tener 1, 024 caracteres o menos, y solo puede contener caracteres alfanuméricos, guiones bajos, guiones y espacios.
  4. Opcional: Si es necesario, actualiza el ID.

    El ID se genera a partir del nombre que proporcionas y debe ser único en todo el proyecto. Debe tener 50 caracteres o menos, y no puede contener espacios.
  5. Haz clic en Continuar.
  6. Elige si deseas habilitar la faceta dinámica para esta configuración de entrega.
  7. Elige o crea controles de publicación para optimizar tus búsquedas.

    Para obtener más información sobre los controles, consulta Cómo crear y administrar controles.

Administra recursos y supervisa la actividad

Cuando completes la configuración inicial de tu proyecto, el panel de la consola deGoogle Cloud mostrará el estado del sistema de tu proyecto de Vertex AI Search para comercio. El panel de la consola te permite administrar recursos y supervisar la actividad.

Ir a la consola de Search for Commerce

Crea una clave de API

Se requiere una clave de API si usas un píxel de JavaScript o una etiqueta de Tag Manager para capturar eventos del usuario desde los navegadores de los usuarios. Para obtener más información sobre las formas de capturar eventos de usuario, consulta Registra eventos de usuario en tiempo real.

Para crear una clave de API para las llamadas al método userEvents.Collect, completa los siguientes pasos:

  1. Ve a la página Credenciales de la consola de Google Cloud .

  2. En el menú desplegable del proyecto en la parte superior de la Google Cloud página de la consola, selecciona tu proyecto (es posible que el proyecto ya esté seleccionado).

  3. Haz clic en Crear credenciales y selecciona Clave de API. No agregues ninguna restricción de aplicación de sitios web. Se sabe que algunos parámetros de configuración de privacidad del usuario no pasan la URL del sitio de referencia.

    • Toma nota de la clave de API generada, que usarás cuando llames al registro de eventos del usuario.

  4. Para obtener mayor seguridad, agrega una restricción de API a tu clave de API para restringir el acceso al servicio de Vertex AI Search for Commerce en https://retail.googleapis.com/*.

¿Qué sigue?