Requisitos previos de configuración

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

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

Crea un proyecto de Google Cloud

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

    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 para la venta minorista

Para usar Vertex AI Search for Retail, sigue estos pasos. Además, si habilitas Vertex AI Search for Retail y usas recomendaciones, ten en cuenta que los costos se basan en la cantidad de consultas. Para obtener más información sobre los precios de Vertex AI Search para la venta minorista, consulta Cargos de Vertex AI Search para la venta minorista.

Para tu proyecto nuevo

Para configurar Vertex AI Search for Retail, sigue estos pasos:

  1. Ve a la página Vertex AI Search para venta minorista en la consola de Google Cloud.

    Ir a la página Buscar venta minorista

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

  3. Cuando Vertex AI Search para la venta minorista y Recommendations AI aparezcan como Activado, haz clic en Continuar.

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

  5. Si quieres usar el proyecto solo 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 de Google Cloud muestra la Búsqueda de Vertex AI para los componentes de venta minorista que activaste. Ahora puedes configurar la configuración inicial de tu proyecto.

Para un proyecto existente

Para continuar con un proyecto existente, completa estos pasos:

  1. Ve a la página Buscar venta minorista en la consola de Google Cloud de tu proyecto.

    Ir a la página Buscar venta minorista

  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 las aceptas.

  3. Si quieres usar el proyecto solo 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.

Cómo desactivar las funciones de búsqueda

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

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

  • Categoría: Aprendizaje automático
  • Componente: Vertex AI Search para la venta minorista: Búsqueda y navegació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.

Cómo desactivar Vertex AI Search for Retail

Puedes desactivar Vertex AI Search for Retail en cualquier momento. Esto desactiva las recomendaciones y la búsqueda.

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

  1. Ve a la página Vertex AI Search for Retail API/Service Details en la console de Google Cloud.

    Ve a la página Detalles del servicio de la API de Vertex AI Search para la venta minorista

  2. Haz clic en Inhabilitar API.

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

Comienza a usar Vertex AI Search para la venta minorista

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

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

  • Datos > Eventos: Muestra tus eventos de usuario 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 la venta minorista.

Importa tu catálogo de productos

Para importar tu catálogo de productos, completa el conjunto de pasos de 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. Revisa Acceso de usuarios si no ves tu cuenta.
  5. Opcional: Selecciona el 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 feeds futuros).
  6. Opcional: Para importar solo 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 para filtrar.
  7. Selecciona la rama a la que subirás tu catálogo.
  8. Haga clic en Import.

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 importarlo 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 de proyectos con un catálogo de productos que se haya transferido como variantes.
  7. Haga clic en Import.

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 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 BigQuery y Cloud Storage 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 de producto.

    Debes seleccionar el nivel de producto si es la primera vez que importas tu catálogo o si lo vuelves a importar 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 de proyectos con un catálogo de productos que se haya transferido como variantes.
  9. Haga clic en Import.

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 los 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. Haga clic en Import.

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 usa una ubicación predeterminada. Si se especifica, el bucket de BigQuery y Cloud Storage 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 BigQuery y Cloud Storage deben estar en la misma región.
  8. Haga clic en Import.

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 los resultados de la búsqueda o de recomendaciones.

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

  1. En el panel Configuraciones de publicación, haz clic en Crear configuración de publicación.
  2. En la página Create Serving Config, elige Búsqueda 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. Haga 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.

Administrar recursos y supervisar la actividad

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

Ve a la consola de Search for Retail

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 página de la consola de Google Cloud, 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 algunas configuraciones de privacidad del usuario no pasan la URL del referente.

    • 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 Retail en https://retail.googleapis.com/*.

¿Qué sigue?