Esta es la documentación solo de Recomendaciones IA. Para probar Retail Search y la consola unificada de venta minorista en la fase restringida de Google Analytics, comuníquese con el equipo de Ventas de Cloud. Si no planea usar Retail Search, permanezca en la consola de Recomendaciones hasta nuevo aviso.

Si usas la versión v1beta de Recomendaciones IA, migra a la versión minorista de la API.

Catálogos e información de los catálogos

En esta página, se proporcionan prácticas recomendadas para crear la información y propagar los datos de tu catálogo.

Descripción general

Los datos del catálogo que importas a Recomendaciones IA tienen un efecto directo en la calidad del modelo resultante y, por lo tanto, en la calidad de las predicciones que proporciona Recomendaciones IA. En general, cuanto más precisa y específica sea la información del catálogo que puedas proporcionar, mejor será la calidad de tu modelo.

Tu catálogo debe mantenerse actualizado. Puedes subir los cambios del catálogo con la frecuencia que sea necesaria. Idealmente, todos los días para catálogos con una alta tasa de cambio. Puedes subir (parche) elementos de productos existentes; solo se actualizarán los campos modificados. No se aplican cargos por subir información del catálogo. Para obtener más información, consulta Cómo mantener tu catálogo actualizado.

Productos

El catálogo es una colección de objetos de productos.

Información requerida del producto

Los siguientes campos son obligatorios: Debes proporcionar valores para ellos cuando creas elementos de productos en tu catálogo. También deben corresponder a los valores usados en tu base de datos interna de productos y deben reflejar con precisión el producto representado, ya que se incluyen en el entrenamiento de tus modelos.

En algunos casos, también se requieren otros campos. Consulta la lista completa de todos los campos de productos en la [página de referencia de Product][product-ref].

Toda la información de los productos que proporcionas se puede usar para mejorar la calidad de las recomendaciones. Asegúrate de proporcionar tantos campos como sea posible.

Campo Notas
name Es el nombre completo y único del recurso del producto. Obligatorio para todos los métodos `Product`, excepto import. Durante la importación, el nombre se genera de forma automática y no es necesario proporcionarlo de forma manual.
id El ID del producto que usa tu base de datos de productos. El campo de ID debe ser único en todo tu catálogo. El mismo valor se usa cuando registras un evento del usuario, y el método predict también lo muestra.
title Título del producto de tu base de datos de productos. Una string codificada en UTF-8. Límite de 1250 caracteres.

Usa niveles de productos

Cuando importas tu catálogo por primera vez, debes especificar si solo proporcionas elementos principales o elementos principales y sus variantes.

  • Los elementos principales son lo que muestra la API de venta minorista en los resultados de la predicción. Pueden ser elementos individuales (nivel de SKU) o grupos de elementos similares (grupos de SKU). De forma predeterminada, la API de venta minorista está configurada para importar solo elementos principales.
  • Los elementos de Variante son versiones de un producto principal. Las variantes solo pueden ser elementos individuales (a nivel de SKU). Por ejemplo, si el producto principal es “camisa con cuello en V”, las variantes podrían ser “camisa de cuello en V marrón, talle XL” y “camisa blanca de cuello en V, talle S”. A veces, los primarios y las variantes se describen como elementos "principales" y "secundarios". La importación de variantes es opcional.

Durante la importación de catálogos, configura tus niveles de producto mediante el método Catalog.patch. Por ejemplo:

curl -X PATCH 
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)"
-H "Content-Type: application/json; charset=utf-8"
--data '{ "productLevelConfig": { "ingestionProductType": "PRODUCT-TYPE", "merchantCenterProductIdField": "PRODUCT-ID-FIELD" } }'
"https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog"

Para determinar las mejores opciones de nivel de producto para la implementación, debes revisar los datos de tu catálogo y la lógica de tu sitio web. ¿Qué ID de elemento están disponibles cuando capturas datos de eventos del usuario? ¿Qué ID de elementos serían más efectivos para mostrar con predicciones? ¿Cómo se comparan y se relacionan esos ID?

Sigue los pasos correspondientes según si importas desde Merchant Center o no:

Determina tus niveles de productos para importarlos desde Merchant Center

Cuando importas datos de catálogos de Merchant Center, la API de venta minorista usa ingestionProductType para ayudar a identificar si los debes subir como primarios o variantes, y merchantCenterProductIdField para especificar si se usará offer_id o item_group_idde Merchant Center como ID del producto.

Revisa las lógicas del catálogo y el sitio web para responder las siguientes preguntas:

  • ¿Tengo principales y variantes en mi catálogo?
  • De ser así, ¿qué nivel de elemento tendrás disponible cuando capture los datos del evento del usuario?
  • ¿Qué tipo de elementos necesito que se muestren con mis predicciones?

Determina si:

  1. Tu catálogo tiene solo un nivel de artículos. Esto puede significar lo siguiente:

    • Todos tus productos y eventos están a nivel de SKU, y deseas predicciones de nivel de SKU.
    • Todos los productos y eventos están a nivel del grupo y deseas obtener predicciones a nivel del grupo.

    Si es así, importa solo elementos principales. Esta es la configuración de importación predeterminada.

  2. Deseas predicciones a nivel de grupo (principal), pero tus productos de Merchant Center están a nivel de SKU. En este caso, tu decisión de importación depende de cómo se capturan los eventos.

    1. Tus eventos se capturan a nivel del grupo. Si es así, usa la siguiente configuración durante la importación:

      Varios productos de Merchant Center tienen el mismo Merchant Centeritem_group_id, Recomendaciones IA importa solo uno de ellos como producto principal y usa elitem_group_id como ID del producto. En este caso, no se pueden importar los productos que no tienen un item_group_id. Los eventos registrados deben hacer referencia al ID del producto principal (a nivel del grupo).

    2. Tus eventos se capturan a nivel de SKU. Si es así, usa la siguiente configuración durante la importación:

      Recomendaciones IA importa tus productos como variantes y usa Merchant Center offer_id como su ID de producto. Los eventos grabados deben hacer referencia al ID del producto de la variante (nivel de SKU).

Determina los niveles de tus productos para importar sin Merchant Center

Todos tus productos deben tener un valor para primaryProductId o ninguno de ellos puede. No puedes importar datos de catálogos con primaryProductId establecido en algunos elementos, pero no en otros.

  1. Si tu catálogo tiene un solo nivel de elementos, esto puede significar lo siguiente:

    • Todos tus productos y eventos están a nivel de SKU, y deseas predicciones de nivel de SKU.
    • Todos los productos y eventos están a nivel del grupo y deseas obtener predicciones a nivel del grupo.

    Si es así, importa solo elementos principales. Esta es la configuración de importación predeterminada y recomendada.

  2. Si tus eventos y productos están a nivel del SKU, puedes obtener predicciones a nivel de grupo. Configura ingestionProductType como variant durante la importación.

La predicción a nivel de SKU no es compatible si solo tienes eventos y productos a nivel de grupo.

Si planeas importar datos de catálogos de Merchant Center en el futuro, revisa tus datos como se describe para importaciones de Merchant Center a fin de asegurarte de que tomas la decisión correcta. Solo se puede cambiar esta configuración si borras el catálogo y lo vuelves a subir (consulta Cambia la configuración a nivel del producto).

Esquema de Recomendaciones IA

Cuando importes un catálogo desde BigQuery, usa el esquema de Recomendaciones IA que se encuentra a continuación para crear una tabla de BigQuery con el formato correcto y cargarla con los datos de tu catálogo. Luego, importa el catálogo.