Acerca de los catálogos y los productos

En esta página se describen las prácticas recomendadas para crear la información de su catálogo y rellenar los datos del catálogo.

Información general

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

Los datos del catálogo que importes en Vertex AI Search for commerce influyen directamente en la calidad del modelo resultante y, por lo tanto, en la calidad de los resultados de búsqueda y recomendación. En general, cuanto más precisa y específica sea la información del catálogo que proporciones, mayor será la calidad del modelo.

Tu catálogo debe estar actualizado. Puede subir los cambios del catálogo con la frecuencia que necesite. Lo ideal es que lo haga todos los días en el caso de los catálogos con una alta tasa de cambios. Puede subir (aplicar un parche) elementos de producto que ya tenga. Solo se actualizarán los campos modificados. No se aplican cargos por subir información de catálogos. Para obtener más información, consulta el artículo Mantener actualizado el catálogo.

Ramas de catálogo

Si usas la búsqueda, puedes usar ramas de catálogo para probar los nuevos datos que has subido sin conexión antes de publicarlos en tu sitio.

Puedes usar hasta tres ramas, identificadas como 0, 1 y 2. Tu sitio activo apunta a default_branch para obtener los datos del catálogo. Especifica qué rama es la activa default_branch (la predeterminada es la rama 0) mediante setDefaultBranch o la pestaña Datos de la consola de búsqueda de comercio. A continuación, su sitio usa los datos del catálogo proporcionados por la sucursal a la que apunta default_branch.

Por ejemplo, supongamos que default_branch tiene el ID de sucursal 0, por lo que su sitio utiliza los datos del catálogo que ha subido a esa sucursal. Puedes subir nuevos datos de catálogo a la rama 1 y obtener una vista previa. Una vez que haya confirmado que el catálogo se ha subido correctamente, puede cambiar a la rama 1 como default_branch activa.

La caché del catálogo puede tardar hasta 30 minutos en actualizarse después de cambiar de rama.

Si usas recomendaciones, utiliza solo la rama predeterminada debido al retraso de la actualización al cambiar de rama. Si la diferencia de datos entre las ramas es grande, el retraso en la actualización puede afectar negativamente a los resultados de las predicciones.

Información obligatoria del producto

Los siguientes campos son obligatorios, por lo que debe proporcionar valores para ellos cuando cree artículos de producto en su catálogo. También deben corresponderse con los valores utilizados en su base de datos de productos interna y reflejar con precisión el producto representado, ya que se incluyen en el entrenamiento de sus modelos.

En algunos casos, también se requieren otros campos. Consulta la lista completa de todos los campos de producto en la página de referencia Product.

Toda la información de producto que proporciones se puede usar para mejorar la calidad de las recomendaciones y los resultados de búsqueda. Asegúrate de proporcionar tantos campos como sea posible.

Campo Notas
name Nombre de recurso completo y único 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 manualmente.
id El ID de producto que usa su base de datos de productos. El campo ID debe ser único en todo el catálogo. Se usa el mismo valor cuando registras un evento de usuario y también lo devuelven los métodos predict y search.
title Título del producto de su base de datos de productos. Una cadena codificada en UTF-8. Límite de 1250 caracteres.
categories Categorías de producto. Cada producto debe asignarse a al menos una categoría. Si un producto pertenece a más de una categoría, repita el campo para cada categoría. El valor debe ser una cadena codificada en UTF-8 no vacía con un límite de 5000 caracteres. Especifique siempre la ruta completa de la categoría. Por ejemplo: ["Sports & Fitness > Athletic Clothing > Shoes"].

Categorías de catálogo

En esta sección se describe la estructura del catálogo y cómo designarlo para usarlo 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 de cada producto. Las categorías principales no son obligatorias y no deben incluirse.

A continuación, se muestra un ejemplo de cómo estructurar su 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 de la navegación debe gestionarse mediante otros atributos personalizados.

Nombres de las categorías

Los nombres de las categorías deben elegirse con cuidado para evitar introducir palabras clave incorrectas y mejorar el rendimiento. Usar términos más específicos y precisos mejora la relevancia y reduce los problemas.

  • Recomendado: Alimentos congelados > Frutas congeladas
  • No recomendado: Frutas y verduras congeladas > Frutas congeladas

Estructura específica de un proyecto a nivel de catálogo

Crea un solo catálogo para cada idioma. Si operas en varios países, puedes usar el mismo catálogo para ofrecer resultados de búsqueda en diferentes países.

Proporcione 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 de un país a otro, cree un inventario local para cada país. Especifica sus precios allí.

Para optimizar los resultados de búsqueda, indique el nombre de cada país como SearchRequest.entity y UserEvent.entity. Utilice entidades de país solo con fines de clasificación.

Estructura del producto

Cuando gestionas tu catálogo de productos en Vertex AI Search for commerce, es fundamental que sepas cómo se gestionan los atributos de los productos principales y de las variantes para que la búsqueda y las recomendaciones sean eficaces. Las designaciones de SKU de producto determinan la jerarquía del catálogo.

Estructura del catálogo y del inventario

Tipos de designación de producto

Hay tres tipos de designación de producto:

  1. Los elementos principales o superiores se devuelven en las recomendaciones o en los resultados de búsqueda y sirven como contenedores lógicos o grupos de elementos similares. Los primarios pueden ser artículos individuales (a nivel de SKU) y grupos de artículos similares (grupos de SKUs).

  2. Los artículos con variantes o secundarios son versiones específicas e individuales de un producto principal de un grupo de SKUs. Por ejemplo, si el producto principal es Camiseta de cuello de pico,las variantes podrían ser Camiseta de cuello de pico marrón, talla XL y Camiseta de cuello de pico blanca, talla S.

  3. Los artículos de colección son paquetes de productos principales o productos variantes, como un conjunto de joyas con un collar, pendientes y un anillo. Las estructuras jerárquicas son similares a los productos y las variantes, y 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.

Jerarquías de clasificación de productos

Con los tres tipos a nivel de producto, hay tres jerarquías de clasificación de productos principales:

  • Variante principal: la variante principal casi siempre es solo un marcador de posición de información (común) y las variantes son las SKUs reales que se pueden comprar. Por ejemplo, las camisetas se estructurarían mejor de forma jerárquica, como elementos principales con su conjunto de variantes correspondiente. Cada variante representa un SKU individual (para cada talla) y cada artículo principal representa un grupo de SKUs, donde cada SKU es una talla diferente de un estilo de camiseta general. Esta organización por estructura de SKU permite que los resultados de búsqueda y los paneles de recomendaciones muestren una variedad de estilos de camisetas. Permite al comprador desglosar un estilo principal concreto para seleccionar la variante (talla) que quiere comprar.
  • Solo principal: según estos tipos de designación de producto, los productos de alimentación se catalogan mejor como productos principales, cada uno de los cuales consta de un solo producto de 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 reordenación, Vertex AI Search for commerce tiene una lógica que les atribuye las compras. Por ejemplo, un comprador hace clic en los productos de un juego de sábanas y, a continuación, añade al carrito o compra un producto principal de esa colección. La colección se atribuye a 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úrelos como primario-variante, ya que esto ofrece varias ventajas:

  • La página de búsqueda tiene resultados diversos 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 búsqueda se llenaría con los mismos productos.
  • Los productos tienen un sistema de clasificación más completo, ya que los productos principales con variantes se clasifican mejor si una variante concreta recibe más interacciones. Esto ayuda a volver a clasificar y optimizar los ingresos.
  • Facilidad para mantener el catálogo. Si un atributo cambia en un grupo de productos que solo se diferencian en la talla, puede hacerlo mediante una estructura de variante principal. Por ejemplo, puede cambiar el atributo a nivel principal en lugar de cambiar varios elementos principales.
  • Las funciones de la API y los campos de respuesta de búsqueda de las claves de acumulación de variantes y los campos recuperables solo se admiten en 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 tienes que aumentar o enriquecer la respuesta de búsqueda con detalles adicionales, que Vertex AI Search for commerce puede devolver si se marcan como recuperables.

Configurar el catálogo de productos

Al planificar su catálogo de productos, debe decidir si contiene productos designados como principales, principales y variantes, o una combinación de ambos. Piensa en la estructura de los SKUs de tus productos. Sus productos pueden ser artículos principales, que pueden tener variantes.

En función de cómo se designen los SKUs de tus productos, ten en cuenta las opciones que tienes 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
  • Su SKU debe formar 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 en la página de detalles de su producto se muestra un selector de opciones, tallas o colores, estas opciones suelen subirse como variantes a su catálogo de productos. Decida si quiere que los diferentes tipos del mismo producto con atributos distintos, como la talla y el color, aparezcan como un único resultado de búsqueda o como resultados independientes. Por ejemplo, en el caso de un libro, puede decidir si quiere que el SKU de la edición de tapa dura y el de la edición de tapa blanda del mismo libro aparezcan como resultados de búsqueda independientes (SKU = principal) o como uno solo (SKU = variante, grupo de SKUs = principal).

Cuando configure su catálogo de productos, tenga en cuenta que las recomendaciones y los resultados de búsqueda solo devuelven artículos principales.

Productos principales mínimos

Si determina que su catálogo debe tener tanto productos principales como variantes (es decir, grupos de SKUs y SKUs), pero solo tiene SKUs, debe crear productos principales para los grupos de SKUs. A veces, estas primarias se denominan primarias virtuales o primarias falsas.

Estas primarias solo deben contener información mínima: id, title y categories.

Si no se especifica type, el tipo de producto será el principal de forma predeterminada. Si vas a importar, no es necesario que especifiques name. Para obtener más información, consulta la sección anterior Información de producto obligatoria.

Importación de catálogos

Si tu catálogo está en Cloud Storage, BigQuery u otro almacenamiento, haz una importación de datos en bloque.

Para obtener información detallada sobre cómo subir un catálogo, consulta el artículo Importar información de catálogos.

Corrección de la URL del producto

El campo product.uri es la URL canónica que enlaza directamente con la página de detalles del producto. Debe ser un URI rastreable públicamente y no 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 obtiene la mayor cantidad de información posible, que se usa para calcular la relevancia y la popularidad. El backend también determina cómo se ha interactuado con el URI en la Web, incluidos los enlaces de retroceso. El nombre de dominio de nivel superior debe ser el mismo en todos los URIs de producto.

Si tiene el mismo producto en varios sitios de banners, le recomendamos que utilice la función de varias entidades. Ponte en contacto con el equipo de la cuenta para tratar este tema.

Vertex AI Search for commerce usa las URLs de los productos para enriquecer sus descripciones. Si usa una URL diferente en el catálogo de productos que en el sitio web, asegúrese de que ambas URLs hagan referencia al mismo producto y tengan información casi idéntica.

Las URLs de producto mejoran los catálogos de las siguientes formas:

  • Enriquecer los datos de producto: Vertex AI Search para el comercio extrae información complementaria rastreando el URI del producto, el identificador de recurso único que se encuentra 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. El conocimiento más profundo de los productos que se obtiene mediante el rastreo de URIs contribuye directamente a la calidad de los datos del catálogo.
  • Mejorar la calidad y la relevancia de la búsqueda: las señales web recogidas de los URIs rastreados se usan para mejorar la calidad de la búsqueda. El backend utiliza la información rastreada, incluida la forma en que se ha interactuado con el URI en la Web (por ejemplo, cuando el usuario hace clic en enlaces de retroceso), para asignar puntuaciones de relevancia y popularidad en los resultados de búsqueda.
  • Proporcionar una base para el entrenamiento de modelos: 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 las ventajas de las URLs de producto, siga estas prácticas recomendadas:

  • Se debe poder acceder públicamente a la página web enlazada y debe cargarse correctamente. No debe estar protegida por un muro de inicio de sesión o autenticación.
  • Cada URI debe ser único y apuntar siempre a la página web del producto correcto. Su contenido debe reflejar con precisión la información de los productos del catálogo. Mantener el mismo nombre de dominio de nivel superior en todos los URIs de producto.

Inventario de productos

El inventario de productos incluye lo siguiente:

  • Precio (tanto el actual como el original)

  • Disponibilidad (por ejemplo, en stock, agotado, bajo pedido o reservado)

  • Cantidad disponible

  • Información sobre la gestión de pedidos, como la recogida en tienda, el envío a tienda y la entrega al día siguiente

Hay dos niveles de inventario: a nivel de producto y local.

Inventario a nivel de producto

En el caso de los comerciantes que solo venden online, el inventario se especifica a nivel de producto. El precio, la disponibilidad y otros datos de inventario se definen para cada producto del catálogo.

Para obtener más información sobre el inventario a nivel de producto, incluido cómo mantener los datos de inventario, consulte Actualizar el inventario de Vertex AI Search for commerce.

Inventario local

Los comercios que tengan tiendas físicas y una tienda online deben mantener la información del inventario de cada tienda. Para ello, usan el inventario local.

Hay dos campos de producto que se pueden usar para almacenar el inventario local. Ambos campos son listas de ubicaciones (IDs de sitio) con información de inventario asociada:

Puede usar uno de los campos o ambos para proporcionar información a nivel de tienda.

Para obtener más información sobre los inventarios locales, consulte el artículo Actualizar el inventario local en Vertex AI Search for commerce.

Estructura de 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 producto principales se almacenan sin precios.

  • Productos variantes (con el precio más bajo en el país): por ejemplo, la variante del producto principal (color, talla) debe tener el precio más bajo en el país. Los datos de precios de las variantes se agregan a los datos de producto principales, y el precio principal se utiliza para la clasificación. Los precios específicos de una ubicación se ignoran.

  • Inventario local (precios específicos de una región o una tienda): usa la información de precios del inventario local para volver a clasificar los productos en el momento de la publicación.

  • Atributos de producto principal: los productos principales solo deben incluir atributos comunes a todas sus variantes asociadas.

Corrección de la disponibilidad de los productos

El sistema de actualización de inventario asigna el valor del campo de disponibilidad a medida que cambia el estado del stock del producto. Hacer un seguimiento de todos los productos que están en estado IN_STOCK y OUT_OF_STOCK.

Si la mayoría de los productos tienen el valor OUT_OF_STOCK, la respuesta de búsqueda tendrá muchos productos agotados y, al añadir un filtro, se reducirán las cifras de recuerdo. Si el producto se ha agotado, pero el estado del catálogo es IN_STOCK, los usuarios verán que el producto está disponible, pero probablemente tengan problemas a la hora de comprarlo o añadirlo al carrito. Esto influye más en la experiencia del cliente que en el entrenamiento del modelo. Mantén el campo Product.availability lo más actualizado posible mediante las APIs patchProduct o las APIs de importación con un readMask.

Esquema de producto

Cuando importes un catálogo de BigQuery, usa el siguiente esquema de producto de Vertex AI Search for commerce para crear una tabla de BigQuery con el formato correcto y cargarla con los datos de tu catálogo. A continuación, importa el catálogo.

Usar campos integrados en lugar de atributos personalizados

Para todos los demás atributos de producto que no formen parte del esquema de información de producto, utilice el Product.attributes (atributos personalizados).

Los campos de producto integrados, como el título, la descripción y las marcas, tienen un mayor impacto en la capacidad de búsqueda y de indexación que los atributos personalizados.

Es decir, el backend tiene un conocimiento más profundo de los campos integrados que de los atributos personalizados. El backend tiene en cuenta la información de los campos integrados para optimizar la relevancia. Por este motivo, te recomendamos que uses los campos integrados. Esto significa que debe asignar la información de sus productos a los campos integrados siempre que sea posible y solo usar atributos de cliente cuando sea necesario.

Por ejemplo, definir las marcas en el campo Product.brands tiene un impacto mucho mayor en la búsqueda y el recuerdo que definir la misma información en un atributo personalizado. En el caso de atributos como sleeve length, que no se admiten de forma nativa, es mejor usar atributos personalizados.

Usar el campo de marca

El campo de marca de la información de producto, que se puede buscar, indexar y facetar de forma predeterminada, es una señal clara para la clasificación y la relevancia. Un buen porcentaje de las consultas de búsqueda tienen el formato brand query o query brand, y se podría decir que la marca es una de las facetas más utilizadas.

Las ratios de conversión de clics y compras se ven muy afectadas si el producto tiene el campo de marca correcto. Por eso, es importante que el campo de marca se rellene con la información correcta y, si es posible, que nunca se deje en blanco. Lo que es más perjudicial es rellenar los nombres de marca con palabras aleatorias como "NA", "Not available" o "Miscellaneous". De esta forma, el producto se asocia firmemente con el texto mencionado en el campo de marcas, lo que puede llevar a una interpretación incorrecta del producto y a un mal recuerdo.

Si un producto concreto no está asociado a ninguna marca, es mejor dejar los campos en blanco. Sin embargo, debe asegurarse de que estos productos de marca vacíos representen un pequeño porcentaje de los productos del catálogo.

Usar el campo de audiencia

El campo de audiencia de la información del producto tiene dos subcampos. Hay Audience.gender y Audience.ageGroup. Es mucho más eficaz rellenar estos campos con los datos adecuados, lo que ayuda al modelo a entender la audiencia a la que va dirigido el producto.

Esto influye mucho cuando la personalización está habilitada. 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 consultas como camisas para mujer o calcetines para hombre. Una vez que se ha rellenado la información de la audiencia, el modelo entiende mucho mejor los productos y ha mejorado la capacidad de recordar las consultas específicas de género.

Buscar productos con títulos duplicados

El Product.title es probablemente el campo más importante, ya que la mayoría de las consultas de búsqueda se solaparían en gran medida con lo que se haya definido como Product.title. Probablemente sea la primera información que vean los usuarios finales y con la que interactúen en la vista de página de detalles, por lo que es recomendable que el valor de product.title sea único y que la información de texto sea la más relevante para el producto.

Si hay dos productos principales con el mismo título, se verán afectadas la capacidad de búsqueda y la relevancia de los resultados devueltos. Si hay dos productos principales independientes con diferencias significativas, mantén los títulos diferentes. Si los productos son iguales, pero solo se diferencian en algunos aspectos, como el color, la talla o la estructura, defínalos como tipos principal y variante.

Ajustes de idioma

Vertex AI Search for commerce admite varios idiomas. Más información aquí. Lo más importante es que el catálogo y la consulta de búsqueda deben estar en el mismo idioma. No se traduce la información de las consultas ni de los catálogos de un idioma a otro. Por ejemplo, si su catálogo está en español, la consulta de 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 correctamente. De lo contrario, se usará el inglés (en-US) de forma predeterminada. Esto es importante para los controles de búsqueda, como spellCorrectionSpec, ya que, si no se define el idioma, se producirá un comportamiento no deseado. Esto también es extremadamente importante para entender la intención de las consultas.

Configuración de la información de precios

El campo Product.priceInfo debe ser lo más preciso y completo posible. Esta información sobre los precios se usa para obtener señales relacionadas con los descuentos y se utiliza en la optimización de los ingresos. Esto es especialmente importante en el caso de las consultas de navegación.

En el caso de una estructura de producto con variantes principales, indique el precio de al menos una de las variantes.

En el caso de un producto que no tenga precios a nivel de 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, rellene la información del precio medio de todos los precios a nivel de inventario en la información del precio a nivel de producto.

Métricas de calidad de los datos del catálogo

La página Calidad de los datos de la consola de búsqueda de comercio evalúa si debe actualizar los datos del catálogo para mejorar la calidad de los resultados de búsqueda y acceder a los niveles de rendimiento de búsqueda.

En la siguiente tabla se describen las métricas de calidad que usa Vertex AI Search for commerce para ayudarte a evaluar tus datos de producto. Para obtener más información 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 de comercio, consulte el artículo Desbloquear 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 las señales web rastreadas con esta URI para mejorar la calidad de la búsqueda.
Cumple los requisitos de tiempo Product.availableTime es anterior a la hora actual y Product.expireTime es posterior a la hora actual. Solo se pueden buscar los productos que cumplen los requisitos de tiempo.
El atributo de búsqueda está presente El producto tiene al menos un attribute definido como de búsqueda. Los atributos personalizados que se marcan como aptos para búsquedas se pueden buscar mediante consultas de texto.
La descripción está presente El producto tiene un elemento Product.description que no está 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 completo ayuda a mejorar la calidad de la búsqueda.
Tiene una variante con imagen El producto variant tiene al menos un Product.image. Puede ignorar esta métrica si todos sus productos están en el nivel primary. Esta métrica tiene fines informativos y no afecta a la calidad de la búsqueda.
Tiene una variante con información sobre el precio El producto variant tiene el valor Product.priceInfo. Puede ignorar esta métrica si todos sus productos están en el nivel primary. Esta métrica tiene fines informativos y no afecta a la calidad de la búsqueda.