Acerca de los atributos de producto

Vertex AI Search para el sector del comercio puede usar atributos de producto para la indexación, la facetado dinámico, la capacidad de búsqueda, el filtrado y la calidad del modelo. En esta página se explica cómo configurar los atributos de producto y cómo se tratan en función del método y la configuración que utilices.

Tipos de atributos

Los atributos de producto pueden tener diferentes ajustes predeterminados y opciones permitidas en función de su tipo.

• Atributos del sistema: los atributos del sistema predefinidos son campos Product que proporcionan más información sobre el producto. Entre ellos, se incluyen atributos de producto como la marca, la disponibilidad, el color y la talla. Para ver todos los atributos del sistema disponibles para los productos, consulta la Productdocumentación de referencia.

• Atributos personalizados: son atributos adicionales que se definen mediante el campo Product.attributes. Por ejemplo, pueden ser nombres de tiendas, proveedores o estilos. Para ver ejemplos y límites de 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 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 de inventario: atributos del sistema o personalizados que proporcionan información sobre el producto a nivel de tienda. Puede usar atributos de nivel de inventario para productos cuyas propiedades varían significativamente entre tiendas y regiones, como los productos de alimentación, o para productos que tengan promociones específicas de cada tienda.

  inventories.price y inventories.originalPrice son atributos de sistema numérico predefinidos por Vertex AI Search para el sector del comercio. Puede crear atributos de nivel de inventario personalizados, que pueden ser de texto o numéricos. Los atributos a nivel de inventario se pueden indexar de forma predeterminada. No se admite la configuración de facetas dinámicas y de búsqueda en atributos a nivel de inventario.

Ajustes de configuración disponibles

Los ajustes de configuración de atributos influyen en el comportamiento de las búsquedas y las recomendaciones en todo su sitio.

La búsqueda usa los siguientes ajustes de atributos:

• Indexable: la búsqueda puede filtrar y desglosar la información mediante este atributo.
• Faceta dinámica: la búsqueda puede usar automáticamente este atributo como faceta dinámica en función del comportamiento anterior de los usuarios, como los clics y las vistas de las facetas. Para habilitar el filtrado dinámico de un atributo, la propiedad Indexable debe tener el valor "true" en ese atributo.
• Se puede buscar: este atributo se puede buscar mediante consultas de búsqueda, lo que aumenta la cobertura de ese atributo. Este control solo se aplica a los atributos de texto.
• Retrievable: si se define como true, la búsqueda devuelve este atributo en las respuestas a las consultas de búsqueda. Si el valor de todos los atributos es false en Retrievable, los resultados de búsqueda solo incluirán el nombre del producto o, en el caso de 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 de todo el sitio que se puede recuperar.

Las recomendaciones usan los siguientes ajustes de atributos:

• Filtrable (vista previa 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 define como indexable, la búsqueda puede filtrar y facetar usando el atributo.

• Atributos del sistema: la indexabilidad siempre está habilitada en los atributos del sistema predefinidos. Este ajuste no se puede inhabilitar en los atributos del sistema.
• Atributos personalizados: esta opción está habilitada de forma predeterminada. Puede inhabilitar la indexación de cualquier atributo personalizado. Si tienes previsto hacer que un atributo personalizado sea indexable, 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 de inventario: siempre están habilitados para los atributos a nivel de inventario del sistema. Este ajuste no se puede cambiar. Esta opción está habilitada de forma predeterminada para los atributos de nivel de inventario personalizados, pero se puede desactivar.
• Dependencias: N/A

Los cambios en la configuración del índice se aplican inmediatamente después de importar los datos del catálogo. De lo contrario, los cambios pueden tardar 12 horas o más en aplicarse. Puede comprobar si los cambios se han aplicado en la página Evaluar.

Facetado dinámico

Cuando se habilita la creación de facetas dinámicas para un atributo, la búsqueda puede usar el atributo como faceta dinámica. Las facetas dinámicas se pueden añadir automáticamente a una búsqueda en función del comportamiento anterior de los usuarios, como los clics y las visualizaciones de facetas.

• Atributos del sistema: habilitados de forma predeterminada si la indexabilidad se define como true. Puede inhabilitar la facetado dinámico de cualquier atributo del sistema.
• Atributos personalizados: habilitados de forma predeterminada si la indexabilidad se define como true. Puedes inhabilitar la creación dinámica de facetas en cualquier atributo personalizado.
• Atributos a nivel de inventario: no admitidos.
• Dependencias: para habilitar la facetado dinámico de un atributo, primero debe habilitar la indexabilidad de ese atributo.

La facetación dinámica de un atributo siempre es global. La configuración de facetado dinámico que aplique a ese atributo se usará en los productos del catálogo que usen ese atributo.

Los cambios en la configuración de los facetados dinámicos tardan hasta dos días en aplicarse. Puedes comprobar si los cambios se han aplicado en la página Evaluar.

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

Disponible para búsquedas

Si un atributo se define como apto para búsquedas, se mejora la recuperación de ese atributo en las consultas de búsqueda.

Solo se puede habilitar la opción de búsqueda en los valores de los atributos de texto. No se aplica a los atributos numéricos.

• Atributos del sistema: los atributos del sistema de texto predefinidos de Product tienen su configuración de capacidad de búsqueda configurada por Vertex AI Search para el sector del comercio. Estos ajustes no se pueden cambiar.
• Atributos personalizados: inhabilitados de forma predeterminada. Puede habilitar esta configuración para cualquier atributo personalizado de texto.
• Atributos a nivel de inventario: no admitidos.
• Dependencias: N/A
• Búsqueda exacta: la búsqueda segmentada devuelve resultados para las consultas de búsqueda que coinciden con cualquier producto de su catálogo. Esta opción es adecuada para números de serie. Consulta más información sobre la opción de búsqueda exacta.

Aunque es más probable que los productos con un atributo por el que se pueda buscar aparezcan en los resultados de búsqueda de ese atributo, no se garantiza que lo hagan.

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: están desactivados de forma predeterminada. Puedes activar este ajuste para cualquier atributo de texto del sistema predefinido de Product, excepto para FulfillmentInfo y title. No se admite en atributos numéricos.
• Atributos personalizados: desactivados de forma predeterminada. Puedes activar este ajuste para cualquier atributo de texto personalizado de Product. No se admite en atributos numéricos.
• Atributos a nivel de inventario: solo se admiten con el valor availability IN_STOCK.
• Dependencias: N/A

Opción de búsqueda exacta

Puede asignar un valor determinado a consultas de cadena específicas en la opción exact-searchable, un campo de atributo de catálogo. Si una consulta coincide con algún producto de su catálogo en el que el valor de ese campo es la cadena proporcionada en la consulta, se devuelve exactamente ese producto en la consulta de búsqueda. Esta opción es adecuada para números de serie, en los que los clientes esperan una experiencia de búsqueda específica.

Por lo general, en los atributos personalizados, el campo ExactSearchableOption es útil para los atributos de producto con un valor exacto (como ModelId o ManufacturerId). Los atributos como product_id son campos de índice primario que se pueden buscar de forma exacta de forma predeterminada. El campo item_id siempre está activado en la coincidencia exacta y no se puede inhabilitar.

• Para evitar que se devuelvan elementos no relacionados en las búsquedas, no asigne nunca a la opción de búsqueda un valor genérico, como battery.
• Para evitar que no se muestren resultados en las consultas de búsqueda, no asigne el valor "exact-searchable" a campos especiales como tag, que podría tener "iphone" como uno de sus valores de cadena. Si lo hace, es posible que esas consultas limiten los resultados de todos los iPhones del catálogo de productos.

Para obtener más información, consulte el artículo Acerca de los atributos de producto.

Comportamiento de los atributos

Cuando estructure su catálogo de productos con designaciones de producto principal y de variante, debe saber cómo se gestionan los atributos de producto para filtrar. Su comportamiento depende de si usas la búsqueda o las recomendaciones, así como de cómo configures la taxonomía de tu catálogo.

Para que el comportamiento de los filtros sea predecible y preciso, mantenga la coherencia y la integridad de las definiciones de los atributos filtrables en los productos principales y en las variantes. Este enfoque ayuda a filtrar con precisión, lo que mejora la visibilidad de los productos y la relevancia de las búsquedas.

Comportamiento de las variantes principales en la búsqueda frente a las recomendaciones

Aunque solo se devuelven elementos principales en los resultados de búsqueda y recomendación, Vertex AI Search para el sector del comercio optimiza la calidad de la búsqueda y las recomendaciones.

• En los modelos de búsqueda, los atributos de variante se usan para el producto principal en el índice de búsqueda. En los resultados de búsqueda se muestran diversas opciones del producto principal en función de los atributos de sus variantes.

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

Gestionar atributos durante la indexación y el filtrado

Si se define el mismo atributo en Principal y Variante, el atributo de la variante se incluye en el filtro. Por ejemplo, supongamos que se define un atributo para un producto principal y sus variantes (color o talla). Los valores de los atributos de variante se usan principalmente para filtrar, durante el cual el sistema comprueba si alguna de las variantes principales coincide con el valor del atributo. Por ejemplo, un producto principal puede estar marcado como out-of-stock, pero si al menos una de sus variantes está marcada como in-stock, el producto principal estará disponible en los resultados de búsqueda si se aplica un filtro in-stock.

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

• Los atributos de variante tienen prioridad a la hora de filtrar. Si se define un atributo en un producto principal y en sus variantes, se usará el atributo de la variante para filtrar. Por ejemplo, si un producto principal tiene un color de marcador de posición, pero sus variantes tienen colores reales, el color de la variante debe rellenarse y se utiliza para filtrar.

• 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 ser OUT_OF_STOCK, mientras que la disponibilidad real (como IN_STOCK) debe definirse a nivel de variante. De esta forma, el producto principal se considera en stock siempre que al menos una variante lo esté. Si es así, los filtros como availability: ANY("IN_STOCK") devuelven 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 filtrar

Mantén el campo categories limpio y optimizado para la taxonomía. Si necesitas aplicar más filtros, hazlo en función de categorías generales mediante atributos personalizados independientes, no en el campo categories. De esta forma, también se evita que se vea afectada negativamente la formación de la función Autocompletar para las sugerencias de categorías.

Por ejemplo, supongamos que suele definir categorías como [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] para filtrar. La función Autocompletar cuenta las categorías más frecuentes de una consulta determinada, por lo que lvl1 y lvl2 (todos sus productos) son las categorías sugeridas.

Prácticas recomendadas

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

• Rellene los atributos con precisión: asegúrese de que tanto los productos principales como las variantes tengan detalles completos y precisos en sus atributos, especialmente en los que se usan para filtrar, con el fin de maximizar la eficacia.

• Usar campos predefinidos: no se base únicamente en atributos personalizados. Asigne su información de producto a los campos Product integrados (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 usan para los datos de producto que no se ajustan a los atributos de sistema predefinidos.

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

• Idioma del catálogo coherente: el catálogo de productos debe estar en un solo idioma y las consultas de búsqueda deben enviarse en el mismo idioma. Si el catálogo incluye varios idiomas, el rendimiento del modelo puede verse afectado. Si no se define el código de idioma, puede afectar a funciones como la corrección ortográfica.

• Información sobre precios: rellene correctamente la información sobre precios de los productos principales y de las variantes para que las recomendaciones y los filtros sean precisos. Si un producto no tiene precios a nivel de producto y solo se basa en los precios del inventario local, rellene los precios del producto principal con la mediana de los precios a nivel de 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 definir.

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

Antes, la configuración a nivel de producto era el modo predeterminado. Si sigues en el modo de configuración a nivel de producto y necesitas cambiar al modo de configuración a nivel de catálogo, ponte en contacto con el equipo de Asistencia. La búsqueda no permite volver al modo de configuración a nivel de producto después de haber cambiado.

Para comprobar el modo de configuración, ve a la página Controles de la consola de búsqueda de comercio. 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 de 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 de producto.

Métodos de configuración

Puede definir las configuraciones de los atributos de las siguientes formas:

• Consola de búsqueda de comercio: configura los atributos a nivel de catálogo mediante la consola de búsqueda de comercio. De esta forma, se configuran los atributos de todos los productos. Los ajustes disponibles en la consola dependen del modo de configuración. Consulta la siguiente sección para obtener más información sobre cómo configurar atributos en la consola.

• Método de la API AttributeConfig: configura los atributos a nivel de catálogo mediante la API. De esta forma, se configuran los atributos de todos los productos.

• Método de la API Product (obsoleto): define atributos personalizados a nivel de producto con el método de la API Product. Los nuevos usuarios no pueden definir atributos con este método, por lo que no se recomienda.

Configurar atributos en la consola

Puede definir opciones de atributos de forma global en todos los productos desde la página Buscar en la consola de comercio Controles, en la pestaña Controles de todo el sitio. Para obtener más información sobre cómo configurar esta opción en la consola, consulta el artículo Gestionar controles de atributos de todo el sitio.

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

Los cambios en los ajustes de configuración de atributos para indexables y que se pueden buscar se aplican inmediatamente después de la ingestión del catálogo. De lo contrario, los cambios pueden tardar hasta 12 horas o más en aplicarse. Puedes comprobar si los cambios se han aplicado en la página Evaluar.

Configurar atributos con AttributesConfig

El recurso de API AttributesConfig te permite gestionar las configuraciones de atributos a nivel de catálogo.

Los siguientes campos definen las opciones de los atributos a nivel de catálogo:

• CatalogAttribute.indexableOption: define la opción indexable de un atributo.
• CatalogAttribute.dynamicFacetableOption: define la opción de facetado dinámico de un atributo.
• CatalogAttribute.searchableOption: define la opción de búsqueda de un atributo.
• CatalogAttribute.recommendationsFilteringOption (Vista previa pública): define la opción de filtrado de recomendaciones de un atributo.

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

Actualizar varios atributos

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

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

El número máximo de atributos de catálogo permitidos en una solicitud es 1000.

Actualizar un atributo concreto

Los siguientes métodos se usan para actualizar atributos de catálogo concretos:

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

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

• ReplaceCatalogAttribute: modifica la configuración de un atributo concreto. Sustituye 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: elimina una configuración de atributo individual de AttributesConfig.

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

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

Configurar atributos con el método Product (obsoleto)

Los usuarios nuevos no pueden definir atributos con este método, por lo que no se recomienda.

Los siguientes campos definen los ajustes de indexación y búsqueda de un producto específico mediante el método de la API Product:

• Product.attributes.indexable.
• Product.attributes.searchable. Solo está disponible para atributos personalizados.