Acerca de los atributos de productos

Vertex AI Search para comercio puede usar atributos de productos para la indexación, la creación de facetas dinámicas, la capacidad de búsqueda, el filtrado y la calidad del modelo. En esta página, se analiza la configuración de los atributos de productos y cómo se tratan según el método y la configuración que uses.

Tipos de atributos

Los atributos del producto pueden tener diferentes parámetros de configuración predeterminados y opciones permitidas según su tipo.

  • Atributos del sistema: Los atributos del sistema predefinidos son campos Product existentes que proporcionan más información sobre el producto. Estos incluyen atributos del producto, como la marca, la disponibilidad, el color y el tamaño. Para ver todos los atributos del sistema disponibles para los productos, consulta la documentación de referencia de Product.

  • Atributos personalizados: Son atributos adicionales que defines con el campo Product.attributes. Por ejemplo, esto podría incluir nombres de tiendas, proveedores o estilos. Para ver ejemplos y límites de los atributos personalizados, consulta la documentación de referencia de Product.attributes.

    Estos son algunos ejemplos de los 20 atributos personalizados principales:

    • Línea de productos a la que pertenece este producto
    • Volumen de ventas en la tienda de este producto
    • Ocasión para la ropa
    • Ofertas y cupones aplicables a este producto
    • Popularidad de los productos en todo el sitio

  • Atributos a nivel del inventario: Son atributos personalizados o del sistema que proporcionan información a nivel de la tienda sobre el producto. Puedes usar atributos a nivel del inventario para los productos cuyas propiedades varían significativamente entre las tiendas y las regiones, como los artículos de supermercado, o para los productos que tienen promociones específicas de la tienda.

    inventories.price y inventories.originalPrice son atributos numéricos del sistema predefinidos por Vertex AI Search for Commerce. Puedes crear atributos personalizados a nivel del inventario, que pueden ser textuales o numéricos. Los atributos a nivel del inventario se pueden indexar de forma predeterminada. No se admite la configuración de la búsqueda y la categorización dinámica en facetas para los atributos a nivel del inventario.

Opciones de configuración disponibles

Los parámetros de configuración de los atributos afectan el comportamiento de las recomendaciones y la búsqueda en tu sitio.

La Búsqueda usa la siguiente configuración de atributos:

  • Indexable: La Búsqueda puede filtrar y facetar con este atributo.
  • Facetas dinámicas: La Búsqueda puede usar automáticamente este atributo como faceta dinámica en función del comportamiento pasado de los usuarios, como los clics y las vistas de la faceta. A fin de habilitar las facetas dinámicas para un atributo, Indexable debe configurarse como verdadero en ese atributo.
  • Se puede buscar: Este atributo se puede buscar mediante búsquedas, lo que aumenta la recuperación para ese atributo. Este control se aplica solo a los atributos de texto.
  • Recuperable: Si se establece como verdadero, la búsqueda devuelve este atributo en las respuestas a las búsquedas. Si todos los atributos tienen el valor Retrievable establecido en falso, los resultados de la búsqueda solo contendrán el nombre del producto o (para las variantes) el nombre del producto y la información del color. El campo REST RetrievableFields está obsoleto para los productos. En su lugar, usa el control recuperable para todo el sitio.

Las recomendaciones utilizan los siguientes parámetros de configuración de atributos:

  • Se puede filtrar (versión preliminar pública): Este atributo se puede usar en expresiones de filtro de recomendaciones. Este control solo se aplica a los atributos de texto.

Indexable

Si un atributo se configura como indexable, la búsqueda puede filtrar y facetar con el atributo.

  • Atributos del sistema: La indexación siempre está habilitada para los atributos del sistema predefinidos. Este parámetro de configuración no se puede inhabilitar para los atributos del sistema.
  • Atributos personalizados: Habilitado de forma predeterminada. Puedes inhabilitar la indexación de cualquier atributo personalizado. Si planeas hacer que un índice de atributos personalizados sea apto para la indexación, debe seguir el patrón de expresión regular [a-zA-Z0-9][a-zA-Z0-9_]*. Por ejemplo, key0LikeThis o KEY_1_LIKE_THIS.
  • Atributos a nivel del inventario: Siempre están habilitados para los atributos a nivel del inventario del sistema. No se puede cambiar este parámetro de configuración. Está habilitado de forma predeterminada para los atributos personalizados a nivel del inventario. Este parámetro de configuración se puede desactivar.
  • Dependencias: N/A

Los cambios en la configuración del índice se aplican inmediatamente después de que importas los datos del catálogo. De lo contrario, los cambios pueden tardar hasta 12 horas o más en aplicarse. Puedes probar si se aplicaron los cambios en la página Evaluar.

Facetas dinámicas

Cuando se habilita la creación de facetas dinámicas para un atributo, la búsqueda puede usarlo como una faceta dinámica. Las facetas dinámicas se pueden agregar automáticamente a una búsqueda en función del comportamiento anterior del usuario, como los clics y las vistas de faceta.

  • Atributos del sistema: Se habilitan de forma predeterminada si la indexabilidad se establece como verdadera. Puedes inhabilitar la creación de facetas dinámicas para cualquier atributo del sistema.
  • Atributos personalizados: Se habilitan de forma predeterminada si la indexabilidad se establece como verdadera. Puedes inhabilitar la creación de facetas dinámicas para cualquier atributo personalizado.
  • Atributos a nivel del inventario: No se admiten.
  • Dependencias: Para habilitar las facetas dinámicas para un atributo, primero debes habilitar la indexación para ese atributo.

La configuración de creación de facetas dinámicas para un atributo es global siempre. Los productos de todo el catálogo que usan ese atributo usan la configuración de creación de facetas dinámicas que aplicas a ese atributo.

Los cambios en la configuración de las facetas dinámicas toman hasta dos días. Puedes probar si se aplicaron los cambios en la página Evaluar.

En el caso de los atributos personalizados numéricos, se deben especificar los buckets en la solicitud. Los valores numéricos no se agrupan automáticamente.

Se puede buscar

Si un atributo está configurado para la búsqueda, se mejora la recuperación de ese atributo en las búsquedas.

Solo los valores de atributos textuales pueden tener habilitada la función de búsqueda. No se aplica a atributos numéricos.

  • Atributos del sistema: Los atributos del sistema textuales predefinidos para Product tienen su configuración de capacidad de búsqueda establecida por Vertex AI Search for Commerce. No se puede cambiar esta configuración.
  • Atributos personalizados: Inhabilitados de forma predeterminada. Puedes habilitar esta configuración para cualquier atributo personalizado textual.
  • Atributos a nivel del inventario: No se admiten.
  • Dependencias: N/A
  • Búsqueda exacta: La búsqueda segmentada devuelve resultados para las búsquedas que coinciden con cualquier producto determinado de tu catálogo. Esta opción funciona bien para los números de serie. Obtén más información sobre la opción de búsqueda exacta.

Si bien es más probable que los productos con un atributo que se puede buscar aparezcan en los resultados de la búsqueda para ese atributo, no se garantiza que aparezcan.

Filtrado de recomendaciones

Si un atributo tiene activado el filtrado de recomendaciones, se puede usar en expresiones de filtro de recomendaciones para filtrar productos en las predicciones.

  • Atributos del sistema: Desactivados de forma predeterminada. Puedes activar este parámetro de configuración para cualquier atributo textual del sistema predefinido para Product, excepto para FulfillmentInfo y title. No se admite para atributos numéricos.
  • Atributos personalizados: Desactivado de forma predeterminada. Puedes activar este parámetro de configuración para cualquier atributo textual personalizado de Product. No se admite para atributos numéricos.
  • Atributos a nivel del inventario: Solo se admiten para el valor availability IN_STOCK.
  • Dependencias: N/A

Opción de búsqueda exacta

Puedes asignar un valor determinado a búsquedas de cadenas específicas para la opción exact-searchable, un campo de atributo del catálogo. Si una búsqueda coincide con algún producto de tu catálogo en el que el valor de ese campo es la cadena proporcionada en la búsqueda, se muestra 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.

Por lo general, para los atributos personalizados, el campo ExactSearchableOption es útil para los atributos de productos con un valor exacto (como ModelId o ManufacturerId). 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 mostrar elementos no relacionados en las búsquedas, nunca establezcas la opción de búsqueda en un valor genérico, como battery.
  • Para evitar que se publiquen menos búsquedas de lo esperado, no establezcas campos especiales, como tag (que podría tener "iphone" como uno de sus valores de cadena), como de búsqueda exacta. Si lo haces, es posible que esas búsquedas limiten los resultados para todos los iPhones del catálogo de productos.

Para obtener más información, consulta Acerca de los atributos del producto.

Comportamiento del atributo

Cuando estructures tu catálogo de productos con designaciones de productos principales y variantes, ten en cuenta cómo se manejan los atributos de productos para el filtrado. Su comportamiento depende de si usas la búsqueda o las recomendaciones, y de cómo configures la taxonomía de tu catálogo.

Para garantizar un comportamiento de filtrado predecible y preciso, mantén la coherencia y la integridad en las definiciones de los atributos filtrables en los productos principales y las variantes. Este enfoque ayuda a filtrar con precisión, lo que mejora el descubrimiento de productos y la relevancia de la búsqueda.

Comportamiento de la variante principal en la búsqueda en comparación con las recomendaciones

Si bien solo se muestran los elementos principales en los resultados de la búsqueda y las recomendaciones, Vertex AI Search para comercio optimiza la calidad de la búsqueda y las recomendaciones.

  • En el caso de los modelos de búsqueda, los atributos de variantes se usan para el producto principal en el índice de búsqueda. En los resultados de la Búsqueda, se muestran diversas opciones para el producto principal según los atributos de sus variantes.

  • En el caso de los modelos de recomendación, los detalles y atributos del producto no se heredan del producto principal a la variante. Para obtener una calidad óptima en las recomendaciones, es fundamental que los productos principales y las variantes tengan detalles completos y precisos para los atributos clave, como product.categories, product.title, product.attributes y product.prices.

Cómo controlar los atributos durante la indexación y el filtrado

Si el mismo atributo se define en Principal y Variante, el atributo de la variante forma parte del filtrado. Por ejemplo, supongamos que se define un atributo para un producto principal y sus variantes (color o tamaño). Los valores de los atributos de variantes se utilizan principalmente para filtrar, durante lo cual el sistema verifica si alguna de las variantes principales coincide con el valor del atributo. Disponibilidad del producto: Un producto principal se puede marcar como out-of-stock, pero, si al menos una de sus variantes es in-stock, el producto principal estará disponible en los resultados de la búsqueda si se aplica un filtro in-stock.

Por los siguientes motivos, establece los mismos atributos filtrables en Principal y Variante:

  • Los atributos de variantes tienen prioridad para el filtrado. Si se define un atributo en un producto principal y sus variantes, se usa el atributo de la variante para el filtrado. Por ejemplo, si un producto principal tiene un color de marcador de posición, pero sus variantes tienen colores reales, se debe completar el color de la variante y usarlo para el filtrado.

  • En el caso de los atributos relacionados con el inventario, como la disponibilidad, si un producto principal tiene variantes, la disponibilidad del producto principal debe establecerse en OUT_OF_STOCK, mientras que la disponibilidad real (como IN_STOCK) debe establecerse a nivel de la variante. De esta manera, el producto principal se considera en existencia siempre que al menos una variante esté en existencia. De ser así, los filtros como availability: ANY("IN_STOCK") muestran correctamente el producto principal.

  • Cuando se usa una expresión de filtro, la respuesta de predicción devolverá los productos principales que tengan al menos un producto principal o variante que coincida con el valor del atributo del filtro.

Atributos opcionales para el filtrado

Mantén el campo categories limpio y optimizado para la taxonomía. Si se necesita más filtrado, implementa el filtrado en función de categorías amplias con atributos personalizados separados, no en el campo categories. Esto también evita que se vea afectado negativamente el entrenamiento de autocompletado para las sugerencias de categorías.

Por ejemplo, supongamos que sueles establecer categorías como [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] para filtrar. La función de autocompletar cuenta las categorías más frecuentes para una búsqueda determinada, por lo que obtendrás lvl1 y lvl2 (todos tus productos) como categorías sugeridas.

Prácticas recomendadas

Si tu catálogo consta de productos principales y variantes y el mismo atributo se define en ambos, se tendrá en cuenta el atributo en la variante durante el filtrado.

  • Completa los atributos con precisión: Asegúrate de que tanto los productos principales como las variantes tengan detalles completos y precisos para sus atributos, en especial, los que se usan para filtrar, de modo que se maximice la eficacia.

  • Usa campos integrados: No te bases únicamente en los atributos personalizados. Asigna la información de tu producto a los campos integrados de Product (brands, colors, sizes y los campos obligatorios). Los campos integrados tienen un mayor impacto en la capacidad de búsqueda, la indexación y las optimizaciones de relevancia. Los atributos personalizados (Product.attributes) se utilizan para los datos de productos que no se ajustan a los atributos del sistema predefinidos.

  • Establece el control de campos recuperables en todo el sitio: La API admite variantRollupKeys para las variantes, lo que te permite recuperar detalles en las respuestas de búsqueda.

  • Idioma coherente del catálogo: El catálogo de productos debe estar en un solo idioma, y las búsquedas deben enviarse en el mismo idioma. Tener varios idiomas en el catálogo puede degradar el rendimiento del modelo. Si no se configura el código de idioma, se pueden afectar funciones como la corrección ortográfica.

  • Información del precio: Completa con precisión la información del precio de los productos principales y de las variantes para garantizar recomendaciones y filtros precisos. Si un producto no tiene precios a nivel del producto y depende únicamente de los precios del inventario local, completa los precios del producto principal con la mediana de los precios a nivel del inventario.

Modos de configuración

El modo de configuración determina cómo se tratan las configuraciones de atributos y qué configuraciones de atributos puedes establecer.

  • Modo de configuración a nivel del catálogo (predeterminado): En este modo, las configuraciones de atributos a nivel del catálogo se usan como fuente de información.
  • Modo de configuración a nivel del producto (obsoleto): En este modo, las configuraciones de atributos a nivel del producto se usan como fuente de información.

Anteriormente, la configuración a nivel del producto era el modo predeterminado. Si aún estás en el modo de configuración a nivel del producto y necesitas cambiar al modo de configuración a nivel del catálogo, comunícate con el equipo de asistencia. La búsqueda no admite volver al modo de configuración a nivel del producto después de que realices el cambio.

Para verificar el modo de configuración, ve a la página Controles de la consola de Search for Commerce. Si la opción Indexable está disponible como columna en la pestaña Controles de todo el sitio, el modelo de configuración es a nivel del catálogo. Si la columna Indexable no está disponible en la pestaña Controles de todo el sitio, el modelo de configuración es a nivel del producto.

Métodos de configuración

Puedes establecer configuraciones de atributos de las siguientes maneras:

  • La consola de Search for commerce: Establece la configuración de los atributos a nivel del catálogo con la consola de Search for commerce. Esto configura los atributos de forma global en todos los productos. La configuración disponible en la consola depende del modo de configuración. Consulta la siguiente sección para obtener más detalles sobre cómo configurar atributos en la consola.

  • El método de la API de AttributeConfig: Establece configuraciones de atributos a nivel del catálogo con la API. Esto configura atributos en todos los productos.

  • El método de la API de Product (obsoleto): Establece atributos personalizados a nivel del producto con el método de la API de Product. Este método no está disponible para los usuarios nuevos y no se recomienda.

Configura atributos en la consola

Puedes establecer de forma global opciones de atributos en todos los productos desde la página Controles de la consola de Búsqueda para comercio, en la pestaña Controles de todo el sitio. Para obtener más detalles sobre cómo configurar esto en la consola, consulta Administra los controles de atributos de todo el sitio.

Para usar esta función, el modo de configuración debe ser a nivel del catálogo.

Los cambios en la configuración de los atributos para la indexación y la búsqueda se aplican inmediatamente después de la transferencia del catálogo. De lo contrario, los cambios pueden tardar hasta 12 horas o más en aplicarse. Puedes probar si se aplicaron los cambios en la página Evaluar.

Configura atributos con AttributesConfig

El recurso de la API de AttributesConfig te permite administrar la configuración de atributos a nivel del catálogo.

Los siguientes campos establecen opciones de atributos a nivel del catálogo:

Para recuperar todas las configuraciones de atributos, usa el método GetAttributesConfig.

Actualiza varios atributos

Usa el método updateAttributesConfig para actualizar varios atributos a nivel del catálogo.

Los atributos del catálogo que incluyes en la solicitud se actualizan en el catálogo o se insertan si no existen. Si no hay ningún valor para un campo de atributo del catálogo, se le asigna un valor predeterminado.

La cantidad máxima de atributos del catálogo permitidos en una solicitud es de 1,000.

Actualiza un atributo individual

Se usan los siguientes métodos para actualizar atributos individuales del catálogo:

  • AddCatalogAttribute: Agrega una configuración de atributo individual a un atributo del catálogo.

    Consulta la documentación de referencia de la API de AddCatalogAttribute.

  • ReplaceCatalogAttribute: Modifica la configuración de un atributo individual. Esto reemplaza el CatalogAttribute especificado en el AttributesConfig actualizando el atributo del catálogo con el mismo CatalogAttribute.key.

    Consulta la documentación de referencia de la API de ReplaceCatalogAttribute.

  • RemoveCatalogAttribute: Quita una configuración de atributo individual de AttributesConfig.

    Solo se pueden borrar los CatalogAttributes que no estén en uso por productos. Si se usa un CatalogAttribute, RemoveCatalogAttribute no lo borra, sino que restablece sus propiedades de configuración a los valores predeterminados. CatalogAttribute.inUse se establece en True si algún producto usa el atributo.

    Consulta la documentación de referencia de la API de RemoveCatalogAttribute.

Configura atributos con el método Product (obsoleto)

La configuración de atributos con este método no está disponible para los usuarios nuevos y no se recomienda.

Los siguientes campos establecen parámetros de configuración indexables y de búsqueda para un producto específico con el método de la API de Product: