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
El catálogo es una colección de objetos de productos.
Los datos del catálogo que importas a Vertex AI Search for commerce 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
Ramas del catálogo con búsqueda
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 rama 0) con setDefaultBranch o la pestaña Datos en la consola de búsqueda para comercio. 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. Una vez que confirmes que el catálogo se subió de forma correcta, puedes cambiar a la rama 1 como default_branch en vivo.
La caché del catálogo puede tardar hasta 30 minutos en actualizarse después de cambiar de rama.
Si usas recomendaciones, usa solo la rama predeterminada debido a la demora 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.
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
|
Son las 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 categoría.
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"].
|
Categorías del catálogo
En esta sección, se describe la estructura del catálogo y cómo designarlo para su uso en la taxonomía y el filtrado.
Estructura del catálogo
El campo categories del catálogo debe contener la ruta de categoría más detallada para cada producto. Las categorías principales no son obligatorias y no deben incluirse.
A continuación, se muestra un ejemplo de cómo estructurar tu catálogo:
- Correcto:
categories: ["Flowers, Cards, Occasion > Seasonal Items > Christmas"] - Incorrecto:
categories: ["Flowers, Cards, Occasion", "Flowers, Cards, Occasion > Seasonal Items", "Flowers, Cards, Occasion > Seasonal Items > Christmas"]
Categorías principales
Las categorías principales de un producto determinado no deben incluirse en el campo categories. El filtrado para la navegación se debe controlar con otros atributos personalizados.
Nombres de categorías
Los nombres de las categorías deben elegirse con cuidado para evitar introducir palabras clave incorrectas y mejorar el rendimiento. El uso de términos más específicos y precisos mejora la relevancia y reduce los problemas.
- Recomendado: Comida congelada > Frutas congeladas
- No se recomienda: Frutas y verduras congeladas > Frutas congeladas
Estructura específica del proyecto y a nivel del catálogo
Crea un solo catálogo para cada idioma. Si operas en varios países, puedes usar el mismo catálogo para proporcionar resultados de la búsqueda en diferentes países.
Proporciona precios, que se determinan a través de los inventarios locales, en la misma moneda en todos los países. Si los precios varían entre países, crea un inventario local para cada uno. Especifica los precios allí.
Para optimizar tus resultados de la búsqueda, proporciona el nombre de cada país como SearchRequest.entity y UserEvent.entity. Las entidades de país se usan solo para fines de clasificación.
Estructura del producto
Cuando administras tu catálogo de productos en Vertex AI Search for commerce, es fundamental comprender cómo se manejan los atributos de los productos primarios y las variantes para que las búsquedas y las recomendaciones sean eficaces. Las designaciones de SKU del producto determinan la jerarquía del catálogo.
Tipos de designaciones de productos
Existen tres tipos de designaciones de productos:
Los elementos principales o superiores se muestran en los resultados de la búsqueda o la recomendación, y sirven como contenedores lógicos o grupos de elementos similares. Los artículos principales pueden ser elementos individuales (a nivel del SKU) y grupos de elementos similares (grupos de SKU).
Los elementos Variante o secundarios son versiones específicas e individuales de un producto principal del grupo de SKU. Por ejemplo, si el producto principal es camisa con cuello en V,las variantes podrían ser camisa marrón con cuello en V, talle XL y camisa blanca con cuello en V, talle S.
Los artículos de Colección son paquetes de productos principales o productos 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 los productos principales relacionados. Los clientes no pueden comprarlos directamente, no se usan de forma generalizada y solo están disponibles en la búsqueda.
Jerarquías de clasificación de productos
Con los tres tipos a nivel del producto, existen tres jerarquías principales de clasificación de productos:
- Variante principal: La variante principal casi siempre es solo un marcador de posición de información (común), y las variantes son los SKU reales que se pueden comprar. Por ejemplo, las camisetas se estructurarían mejor de forma jerárquica, como elementos principales con su conjunto correspondiente de variantes. Cada variante representa un SKU individual (para cada tamaño) y cada artículo principal representa un grupo de SKU, en el que cada SKU es un tamaño diferente para un estilo general de camiseta. Esta organización por estructura de SKU permite que los resultados de la búsqueda y los paneles de recomendaciones muestren una variedad de estilos de camisetas. Permite que el comprador profundice en un estilo principal en particular para seleccionar la variante (talla) que desea comprar.
- Solo principal: 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 SKU, como
"bananas, fresh". - Colecciones: Las colecciones agrupan productos relacionados que un cliente podría comprar. Para representarlos con precisión en el modelo de nuevo ranking, Vertex AI Search for commerce tiene una lógica que les otorga crédito por las compras. Por ejemplo, un comprador hace clic en los productos de un juego de sábanas y, luego, agrega al carrito o compra un producto principal de esa colección. Se le otorga crédito a la colección por esa compra, y el modelo representa con precisión la popularidad y el valor de las colecciones.
Productos con una variante
En el caso de los productos que tienen una variante, estructúralos como principal-variante, ya que esto ofrece varias ventajas, como las siguientes:
- La página de búsqueda tiene diversos resultados que se pueden mostrar a los usuarios finales. De lo contrario, si las variantes se trataran como productos principales, la página de resultados de la búsqueda se completaría con los mismos productos.
- Los productos tienen un esquema de clasificación más enriquecido, ya que los productos principales con variantes se clasifican mejor si una variante en particular genera más participación. Esto ayuda a volver a clasificar y optimizar los ingresos.
- Facilidad para mantener el catálogo Si un atributo tiene un cambio para un grupo de productos que solo difieren en el tamaño, se puede realizar con una estructura de variante principal, por ejemplo, cambiando el atributo a nivel principal en lugar de cambiar varias variantes principales.
- Las funciones de la API y los campos de respuesta de búsqueda de las claves de resumen de variantes y los campos recuperables solo se admiten para las variantes.
- La respuesta de búsqueda contiene los detalles mínimos de la variante principal y más detalles de las variantes. Por lo tanto, siempre debes aumentar o enriquecer la respuesta de búsqueda con detalles adicionales, que Vertex AI Search for Commerce puede devolver si se marcan como recuperables.
Configura tu catálogo de productos
Cuando planifiques tu catálogo de productos, debes decidir si contendrá productos designados solo como principales, principales y variantes, o una combinación de ambos. Piensa en la estructura de los SKU de tus productos. Tus productos pueden ser artículos principales, que podrían tener variantes.
Según cómo se designen los SKU de tus productos, considera las opciones para configurar tu catálogo de productos:
- Quieres que tu SKU se muestre como un resultado de la búsqueda o una recomendación individual: SKU=principal
- Tu SKU debe formar parte de un grupo de SKU similares: SKU=variante, grupo de SKU=principal
- Una combinación de ambas combinaciones: SKU=principal, SKU=variante, grupo de SKU=principal
Si en la página de detalles del producto se muestra un selector de opción, tamaño o color, estas opciones suelen subirse como variantes en 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, puedes 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 SKU = principal).
Cuando configures tu catálogo de productos, ten en cuenta que los resultados de búsqueda y las recomendaciones solo muestran artículos principales.
Productos principales mínimos
Si determinas que tu catálogo debe tener tanto productos principales como variantes, es decir, grupos de SKU y SKU, pero solo tienes SKU ahora, debes crear productos principales para los grupos de SKU. A veces, estos colores primarios se denominan colores primarios virtuales o falsos.
Estos elementos principales solo deben contener información mínima: id, title y categories.
Si no se especifica type, el tipo de producto se establece de forma predeterminada como principal. Si realizas una importación, no es necesario que especifiques name. Para obtener más información, consulta la sección anterior, Información del producto requerida.
Importación de catálogos
Si tu catálogo está en Cloud Storage, BigQuery o algún otro almacenamiento, realiza una importación masiva de datos.
Para obtener información detallada sobre cómo subir un catálogo, consulta Importa información del catálogo.
Corrección de la URL del producto
El campo product.uri es la URL canónica que vincula directamente a la página de detalles del producto. Debe ser un URI rastreable públicamente y no debe estar protegido por ningún muro de inicio de sesión o autorización. Esto se debe a que el backend rastrea la página web de la URI y deriva la mayor cantidad de información posible, que se usa para la puntuación de relevancia y popularidad. El backend también determina cómo se interactuó con el URI en la Web, incluidas las vínculos de retroceso. El nombre de dominio de nivel superior debe ser el mismo en todos los URIs de productos.
Si tienes el mismo producto publicado en varios sitios de banners, considera usar la función de varias entidades. Comunícate con el equipo de cuentas para obtener más información.
Vertex AI Search for Commerce usa URLs de productos para enriquecer las descripciones de los productos. Si usas una URL diferente en el catálogo de productos que en el sitio real, asegúrate de que ambas URLs hagan referencia al mismo producto y tengan información casi idéntica.
Las URLs de productos mejoran los catálogos de la siguiente manera:
- Enriquecimiento de los datos de productos: Vertex AI Search for Commerce extrae información complementaria rastreando el URI del producto, el identificador único de recursos detrás de la ubicación exacta de cada producto en la Web (URL). Este proceso ayuda a obtener detalles y señales adicionales de las páginas web vinculadas. La comprensión más profunda de los productos que se obtiene a través del rastreo de URI contribuye directamente a la calidad de los datos del catálogo.
- Mejora de la calidad y la relevancia de la búsqueda: Las señales web recopiladas de los URIs rastreados se utilizan para mejorar la calidad de la búsqueda. El backend utiliza la información rastreada, incluida la forma en que se interactuó con el URI en la Web, por ejemplo, cuando el usuario hace clic en vínculos externos, para la puntuación de relevancia y popularidad en los resultados de la búsqueda.
- Proporcionar una base para el entrenamiento del modelo: Además del ID, el título, la jerarquía de categorías y el precio del producto, las URLs se consideran uno de los campos principales que se usan como entradas para el entrenamiento de modelos.
Para maximizar los beneficios de las URLs de productos, sigue estas prácticas recomendadas:
- La página web vinculada debe ser de acceso público y cargarse correctamente, y no debe estar protegida por un requisito de acceso a una cuenta o un muro de autenticación.
- Cada URI debe ser único y apuntar de forma coherente a la página web del producto correcto. Su contenido debe reflejar con precisión la información del producto en el catálogo. Mantener el mismo nombre de dominio de nivel superior en todos los URIs de productos
Inventario de productos
El inventario de productos abarca lo siguiente:
Precio, tanto el precio actual como el original
Disponibilidad, como en stock, agotado, pendiente y pedido por adelantado
Cantidad disponible
Información de cumplimiento, 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. Se establecen el precio, la disponibilidad y otros datos del inventario 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 de Vertex AI Search for commerce.
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 lugar) 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 del producto 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 Actualiza el inventario local para Vertex AI Search for Commerce.
Estructura del inventario de variantes principales
La estructura de datos de inventario de variantes principales se compone de productos principales, variantes y de inventario local:
Productos principales: Los datos de los productos principales se almacenan sin precios.
Productos variantes (con el precio más bajo en todo el país): Por ejemplo, la variante del producto principal (color, tamaño) debe tener el precio más bajo en todo el país. Los datos de precios de las variantes se resumen en los datos de productos principales, y el precio principal se usa a su vez para fines de clasificación. Se ignoran los precios específicos de la ubicación.
Inventario local (precios específicos de la región o la tienda): Utiliza la información de precios del inventario local en la clasificación de nuevo en el momento de la publicación.
Atributos del producto principal: Los productos principales solo deben incluir atributos comunes a todas sus variantes asociadas.
Corrección de la disponibilidad del producto
El sistema de actualización del inventario establece el campo de disponibilidad a medida que cambia el estado del stock del producto. Hacer un seguimiento de todos los productos que se encuentran en estado IN_STOCK y OUT_OF_STOCK
Si la mayoría de tus productos tienen el estado OUT_OF_STOCK, la respuesta de la búsqueda tendrá muchos productos agotados y, cuando agregues un filtro, se reducirán las cifras de recuperación. Si el producto se agotó, pero el estado del catálogo es IN_STOCK, los usuarios verán el producto como disponible, pero es probable que tengan problemas al momento de comprarlo o agregarlo al carrito. Esto tiene un mayor efecto en la experiencia del cliente que el entrenamiento de modelos. Mantén el campo Product.availability lo más actualizado posible con las APIs de patchProduct o importa APIs con un readMask.
Esquema de productos
Cuando importes un catálogo desde BigQuery, usa el siguiente esquema de productos de Vertex AI Search para comercio electrónico para crear una tabla de BigQuery con el formato correcto y cargarla con los datos de tu catálogo. Luego, importa el catálogo.
Usa campos integrados en lugar de atributos personalizados
Para todos los demás atributos de productos que no forman parte del esquema de información del producto, usa Product.attributes (atributos personalizados).
Los campos de productos integrados, como el título, la descripción y las marcas, tienen un mayor impacto en la capacidad de búsqueda y la indexación en comparación con los atributos personalizados.
En otras palabras, el backend tiene una comprensión más profunda de los campos integrados que de los atributos personalizados. El backend tiene en cuenta la información de los campos integrados para la optimización de la relevancia. Por este motivo, usa los campos integrados. Esto significa que debes asignar la información de tus productos a los campos integrados siempre que sea posible y usar los atributos del cliente solo cuando sea necesario.
Por ejemplo, establecer las marcas en el campo Product.brands tiene un impacto mucho mayor en la búsqueda y el recuerdo que establecer la misma información en un atributo personalizado. Para un atributo como sleeve length, que no se admite de forma nativa, es mejor usar atributos personalizados.
Usa el campo brand
El campo de marca en la información del producto, que de forma predeterminada se puede buscar, indexar y categorizar en facetas, es un indicador sólido para la clasificación y la relevancia. Un buen porcentaje de las búsquedas son del tipo brand query o query brand, y, sin duda, la marca es una de las facetas más utilizadas.
Los porcentajes de conversiones por clics y compras se ven muy afectados si el producto tiene el campo de marca correcto. Por lo tanto, es importante que el campo de la marca se complete con la información correcta y, si es posible, que nunca quede en blanco. Lo que es más perjudicial es completar los nombres de las marcas con palabras aleatorias, como "NA", "Not available" o "Miscellaneous". Esto asocia firmemente el producto con el texto mencionado en el campo de marcas, lo que podría generar una comprensión incorrecta del producto y una recuperación deficiente.
Si un producto en particular no está asociado a ninguna marca, es mejor dejar los campos vacíos. Sin embargo, se debe tener cuidado para que estos productos de marcas vacías representen un pequeño porcentaje de los productos del catálogo.
Cómo usar el campo de público
Hay dos subcampos en el campo de público de la información del producto. Hay Audience.gender y Audience.ageGroup. Es mucho más eficaz completar estos campos con los datos adecuados, lo que ayuda al modelo a comprender el público objetivo del producto.
Esto es muy importante cuando se habilita la personalización. Tener gender y ageGroup ayuda a segmentar mejor los productos y al modelo a recordar el producto adecuado para el usuario correspondiente.
Los datos de Audience también son útiles cuando tienes búsquedas como camisas para mujeres o calcetines para hombres. Con la información del público completada, la comprensión del producto es mucho mejor y el modelo tiene una recuperación mejorada para las búsquedas específicas por género.
Busca productos con títulos duplicados
El campo Product.title es probablemente el más importante, ya que la mayoría de las búsquedas se superpondrían en gran medida con lo que se establece como Product.title. Probablemente sea la primera información que los usuarios finales verán y con la que interactuarán en la vista de la página de detalles, por lo que es una buena práctica mantener el título del producto único y tener información de texto que sea más relevante para el producto.
Tener dos productos (productos principales) con el mismo título afecta la capacidad de búsqueda y la relevancia de los resultados que se muestran. Si hay dos productos principales independientes con diferencias significativas, mantén los títulos diferentes. Si los productos son iguales, pero solo difieren en algunos aspectos, como el color o el tamaño, estructúralos como tipos principales y variantes.
Configuración de idiomas
Vertex AI Search for commerce admite varios idiomas. Más información aquí. Lo principal que debes tener en cuenta es que el catálogo y la búsqueda deben estar en el mismo idioma. No hay traducción entre idiomas de la información de la búsqueda o del catálogo. Por ejemplo, si tu catálogo está en español, la búsqueda también debe estar en español.
Por lo tanto, es importante marcar el código de idioma en la información del producto de forma adecuada. De lo contrario, se establecerá el inglés (en-US) de forma predeterminada. Esto es importante para los controles de búsqueda, como spellCorrectionSpec, en los que, si no se configura el idioma, se produce un comportamiento no deseado. Esto también es muy importante para comprender la intención de la búsqueda.
Configuración de la información de precios
El campo Product.priceInfo debe ser lo más preciso y completo posible. Esta información de precios se usa para derivar indicadores relacionados con los descuentos y para la optimización de los ingresos. Esto es especialmente importante para las búsquedas de exploración.
En el caso de una estructura de productos con variantes principales, completa el precio de al menos una de las variantes.
En el caso de un producto que no tiene precios a nivel del producto y todos los precios están en el inventario local, lo que significa que la búsqueda siempre está vinculada a un inventario local, completa la información del precio medio de todos los precios a nivel del inventario en la información del precio a nivel del producto.
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 comercio, 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 comercio 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 Search for commerce, consulta Cómo desbloquear los niveles de rendimiento de la búsqueda.
| Métrica de calidad del catálogo | Regla de calidad | Notas |
|---|---|---|
| El URI está presente y es accesible | 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 variante 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. |