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 Vertex AI Search para la venta minorista tienen un efecto directo en la calidad del modelo resultante y, por lo tanto, en la calidad de los resultados de la búsqueda y las recomendaciones. 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 (actualizar) 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.
Ramas del catálogo
Si usas la búsqueda, puedes usar las ramas del catálogo para probar los datos nuevos que subiste sin conexión antes de que se publiquen en tu sitio.
Puedes usar hasta tres ramas, identificadas como 0, 1 y 2. Tu sitio en vivo apunta a default_branch para sus datos del catálogo. Especifica qué rama es tu default_branch en vivo (la predeterminada está configurada como 0 de la rama) mediante setDefaultBranch o la pestaña Datos en la consola de Search for Retail. Luego, tu sitio usa los datos del catálogo que proporciona la rama a la que apunta default_branch.
Por ejemplo, supongamos que default_branch está configurado en el ID de rama 0, por lo que tu sitio usa los datos del catálogo que subiste a esa rama. Puedes subir datos de catálogos nuevos a la rama 1 y obtener una vista previa. Después de confirmar que el catálogo se subió de forma correcta, puedes cambiar a 1 de la rama como default_branch en vivo.
La caché del catálogo puede tardar hasta 30 minutos en actualizarse después de cambiar de sucursal.
Si usas recomendaciones, te recomendamos que uses solo la rama predeterminada debido al retraso en la actualización durante el cambio de rama. Si la diferencia de datos entre las ramas es grande, la demora en la actualización puede afectar negativamente los resultados de la predicción.
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.
Toda la información del producto que proporcionas se puede usar para mejorar la calidad de las recomendaciones y los resultados de la búsqueda. 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 automáticamente 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. Los mismos valores se usan cuando registras un evento de usuario, y los métodos predict y search los muestran.
|
title
|
Título del producto de tu base de datos de productos. Una string codificada en UTF-8. Límite de 1250 caracteres. |
categories
|
Categorías de productos. Cada producto debe asignarse a, al menos, una categoría.
Si un producto pertenece a más de una categoría, repite el campo para cada una.
El valor debe ser una cadena codificada en UTF-8 no vacía con un límite de longitud de 5,000 caracteres. Siempre especifica la ruta de acceso completa de la categoría, por ejemplo: ["Sports & Fitness > Athletic Clothing > Shoes"].
|
Atributos de productos
Se recomienda proporcionar valores para los atributos predefinidos del sistema en Product, como la marca, el color y el tamaño. También puedes incluir atributos personalizados que definas con Product.attributes.
Campos recuperables
Si usas la búsqueda, los atributos se incluyen en un producto en la respuesta de búsqueda si los marcas como recuperables en Product.retrievableFields. Luego, se pueden usar para otras funciones de búsqueda, como el filtrado y las facetas.
Opción de búsqueda exacta
Puedes asignar un valor específico para consultas de cadenas específicas a la opción de búsqueda exacta, un campo de atributo del catálogo. Si una búsqueda coincide con cualquier producto de tu catálogo en el que el valor de ese campo sea la cadena proporcionada en la búsqueda, se mostrará exactamente ese producto en la búsqueda. Esta opción funciona bien para los números de serie, en los que los clientes esperan una experiencia de búsqueda segmentada.
Es un campo útil para los atributos de productos con un valor exacto (como ModelId o ManufacturerId). Por lo general, el campo ExactSearchableOption se usa para atributos personalizados. Los atributos como product_id son campos de índice principales, que se pueden buscar de forma exacta de forma predeterminada. El campo item_id siempre está activado para la concordancia exacta y no se puede inhabilitar.
- Para evitar que se muestren elementos no relacionados en las búsquedas, nunca configures la opción de búsqueda en un valor genérico, como
battery. - Para evitar que se publiquen menos consultas de búsqueda, no configures campos especiales, como
tag, que podría tener como uno de sus valores de cadena "iphone", para que se puedan buscar de forma exacta. De lo contrario, esas consultas podrían limitar los resultados de todos los iPhone del catálogo de productos.
Para obtener más información, consulta Acerca de los atributos de productos.
Niveles de productos
Las designaciones de SKU de los productos determinan la jerarquía de tu catálogo.
Tipos de designación de productos
Existen tres tipos de designación de productos:
Los elementos principales se muestran en las recomendaciones o los resultados de la búsqueda. Los elementos principales pueden ser elementos individuales (a nivel del SKU) y grupos de elementos similares (grupos de SKU).
Los elementos de Variante son versiones de un producto principal del grupo de SKU. 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.
Los artículos de Colección son paquetes de productos principales o variantes, como un conjunto de joyas con un collar, aretes y un anillo. Las estructuras jerárquicas similares a los productos y las variantes, las colecciones agrupan productos principales relacionados. Los clientes no pueden comprarlos directamente, no se usan mucho y solo están disponibles en la Búsqueda.
Ejemplos de productos
A modo de ejemplo, según estos tipos de designación de productos, los artículos de supermercado se catalogan mejor como productos principales, cada uno de los cuales consta de un solo producto de SKU, como"bananas, fresh".
Por otro lado, las camisetas se estructurarían mejor de forma jerárquica, como elementos principales con su correspondiente conjunto de variantes. Cada variante representa un SKU individual (para cada tamaño) y cada elemento principal representa un grupo de SKU, en el que cada SKU tiene un tamaño diferente para un estilo de camiseta general. Esta organización por estructura de SKU permite que los resultados de la búsqueda y los paneles de recomendación muestren una variedad de estilos de camisetas. Permite que el comprador desglose un elemento principal (estilo) en particular para seleccionar la variante (tamaño) que desea comprar.
Las colecciones agrupan productos relacionados que un cliente podría comprar. Para representarlos con precisión en el modelo de clasificación, Vertex AI Search para la venta minorista tiene una lógica que los acredita con las compras. Por ejemplo, un comprador hace clic en los productos de un set de sábanas y, luego, los agrega al carrito o compra un producto principal de esa colección. Se le acredita esa compra a la colección, y el modelo representa con precisión la popularidad y el valor de las colecciones.
También hay un tipo de catálogo solo de variantes, que ahora dejó de estar disponible. Este tipo de catálogo solo se puede usar con recomendaciones. Para el catálogo solo de variantes, ingestionProductType se establece en variant durante la importación. Se infiere un producto principal para cada variante, según un ID de producto principal especificado para cada variante.
Configura tu catálogo de productos
Cuando planifiques tu catálogo de productos, debes decidir si contiene productos designados solo como productos principales, productos principales y variantes, o una combinación de los dos arreglos. Piensa en ello en términos de la estructura de SKU de tus productos. Tus productos pueden ser elementos principales, que pueden tener o no variantes.
Según la forma en que se designen los SKU de tus productos, considera las siguientes opciones para configurar tu catálogo de productos:
- Quieres que tu SKU se muestre como un resultado de búsqueda o una recomendación individual: SKU=primary
- Tu SKU debe ser parte de un grupo de SKUs similares: SKU=variante, grupo de SKUs=principal
Una combinación de ambas: SKU=principal, SKU=variante, grupo de SKUs=principal
Si la página de detalles de tu producto muestra un selector de opciones, tamaño o color, estas opciones suelen subirse como variantes a tu catálogo de productos. Considera si deseas que los diferentes tipos del mismo producto con diferentes atributos, como el tamaño y el color, aparezcan como un solo resultado de la búsqueda o como resultados separados. Por ejemplo, para un libro, debes decidir si quieres que un SKU de tapa dura y un SKU de tapa blanda del mismo libro aparezcan como resultados de la búsqueda separados (SKU = principal) o como uno solo (SKU = variante, grupo de SKUs = principal).
Cuando configures tu catálogo de productos, ten en cuenta que las recomendaciones y los resultados de la búsqueda solo muestran los artículos principales.
Productos principales mínimos
Si determinas que tu catálogo debe tener elementos principales y variantes, es decir, grupos de SKU y SKU, pero solo tienes SKU, debes crear elementos principales para los grupos de SKU. A veces, estos primarios se denominan "primarios virtuales" o "primarios falsos".
Estos elementos principales solo deben contener información mínima: id, title y categories.
Si no se especifica type, el tipo de producto predeterminado es principal. Si vas a importar, no necesitas especificar name. Para obtener más información, consulta la sección anterior, Información del producto requerida.
El tipo es inmutable
No puedes cambiar el tipo de un producto, por ejemplo, de variante a principal o de principal a variante.
Si necesitas cambiar el tipo de un producto, bórralo y recrea un producto con un tipo diferente. Para poder borrar un producto primario, debes borrar las variantes asociadas.
Importación de catálogos
Si tienes tu catálogo en Merchant Center, te recomendamos que lo importes vinculando tu cuenta de Merchant Center.
Si tu catálogo no está en Merchant Center, sino en Cloud Storage, BigQuery o algún otro almacenamiento, entonces realiza una importación masiva de datos.
Si planeas importar datos de catálogos de Merchant Center en el futuro, revisa tus datos como se describe para importaciones de Merchant Center para asegurarte de que tomas las decisiones correctas sobre tu catálogo. Esto es importante porque cambiar la configuración de un catálogo existente requiere borrarlo y volver a subirlo (consulta Cambia la configuración a nivel del producto).
Para obtener información detallada sobre cómo subir un catálogo, consulta Importa información del catálogo.
Inventario de productos
El inventario de productos incluye lo siguiente:
Precio, tanto el actual como el original
Disponibilidad, como en stock, agotado, pedido en espera y pedido por adelantado
Cantidad disponible
Información de preparación de pedidos, como retiro en la tienda, envío a la tienda y entrega al día siguiente
Existen dos niveles de inventario: a nivel del producto y local.
Inventario a nivel del producto
En el caso de los minoristas que solo venden en línea, el inventario se especifica a nivel del producto. El precio, la disponibilidad y otros datos del inventario se establecen para cada producto del catálogo.
Para obtener más información sobre el inventario a nivel del producto, incluido cómo mantener los datos del inventario, consulta Actualiza el inventario para Vertex AI Search para la venta minorista.
Inventario local
Los minoristas que tienen tiendas físicas y una tienda en línea deben mantener la información del inventario por tienda. Para ello, utilizan el inventario local.
Hay dos campos de productos que se pueden usar para almacenar el inventario local. Ambos campos son listas de ubicaciones (IDs de lugares) con información de inventario asociada:
Product.fulfillmentInfo. Métodos de retiro y envío en cada ubicación de la tienda
Product.localInventories. Información de precios, atributos de productos y métodos de retiro y envío en cada ubicación de la tienda
Puedes usar uno o ambos campos para la información a nivel de la tienda.
Para obtener más información sobre los inventarios locales, consulta Cómo actualizar el inventario local para la búsqueda de Vertex AI para venta minorista.
Métricas de calidad de los datos del catálogo
En la página Calidad de los datos de la consola de Búsqueda para venta minorista, se evalúa si necesitas actualizar los datos del catálogo para mejorar la calidad de los resultados de la búsqueda y desbloquear los niveles de rendimiento de la búsqueda.
En la siguiente tabla, se describen las métricas de calidad que usa Vertex AI Search para la venta minorista para ayudarte a evaluar los datos de tus productos. Para obtener detalles sobre cómo ver las métricas de calidad de los datos y los niveles de rendimiento de la búsqueda en la consola de Búsqueda para venta minorista, consulta Desbloquea los niveles de rendimiento de la búsqueda.
| Métrica de calidad del catálogo | Regla de calidad | Notas |
|---|---|---|
| El URI está presente y se puede acceder a él | El producto tiene un Product.uri válido. El URI debe ser accesible y coincidir con tu dominio. |
La Búsqueda usa indicadores web rastreados con este URI para mejorar la calidad de la búsqueda. |
| Cumple con la conformidad de tiempo | Product.availableTime es anterior a la hora actual y Product.expireTime es posterior a la hora actual. |
Solo se pueden buscar productos que cumplan con la conformidad de horario. |
| El atributo que se puede buscar está presente | El producto debe tener al menos un attribute configurado para que se pueda buscar. |
Los atributos personalizados que están marcados para la búsquedas se pueden buscar mediante consultas de texto. |
| La descripción está presente | El producto tiene Product.description no vacío. |
Una descripción completa ayuda a mejorar la calidad de la búsqueda. |
| El título consta de al menos dos palabras | Product.title consta de, al menos, dos palabras. |
Un título integral ayuda a mejorar la calidad de la búsqueda. |
| Tiene variante con imagen | El producto variant tiene al menos un Product.image. Puedes ignorar esta métrica si todos tus productos se encuentran en el nivel de primary. |
Esta métrica solo tiene fines informativos y no afecta la calidad de la búsqueda. |
| Tiene variantes con información sobre el precio | El producto variant tiene configurado Product.priceInfo. Puedes ignorar esta métrica si todos tus productos se encuentran en el nivel de primary. |
Esta métrica solo tiene fines informativos y no afecta la calidad de la búsqueda. |
Esquema de productos para Vertex AI Search para la venta minorista
Cuando importes un catálogo desde BigQuery, usa el siguiente esquema de productos de venta minorista de la Búsqueda de Vertex AI para crear una tabla de BigQuery con el formato correcto y cargarla con los datos de tu catálogo. Luego, importa el catálogo.