Acerca de los atributos de productos

Vertex AI Search para la venta minorista puede aprovechar los 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 analizan las opciones de configuración de los atributos de productos y cómo se tratan según el método y la configuración que usas.

Tipos de atributos

Los atributos de productos 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 obtener todos los atributos del sistema disponibles para los productos, consulta la documentación de referencia de Product.

  • Atributos personalizados: Los 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.

  • Atributos a nivel del inventario: Son atributos del sistema o personalizados que proporcionan información sobre el producto a nivel de la tienda. Puedes usar atributos a nivel del inventario para los productos cuyas propiedades varían significativamente entre tiendas y 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 Retail. Puedes crear atributos personalizados a nivel del inventario, que pueden ser textuales o numéricos. Los atributos a nivel del inventario son indexables de forma predeterminada. No se admite la configuración de facetas dinámicas y que se pueden buscar para los atributos a nivel del inventario.

Opciones de configuración disponibles

La configuración de atributos afecta el comportamiento de búsquedas y recomendaciones en tu sitio.

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

  • Indexable: La Búsqueda puede filtrar y crear facetas con este atributo.
  • Facetas dinámicas: La Búsqueda puede usar automáticamente este atributo como una 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 muestra este atributo en las respuestas a las búsquedas. Si todos los atributos tienen la opción Recuperable establecida como "false", los resultados de la búsqueda solo contienen 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 dejó de estar disponible para los productos. En su lugar, usa el control recuperable para todo el sitio.

Las recomendaciones usan la siguiente configuración de atributos:

  • Filtrable (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 crear facetas con él.

  • Atributos del sistema: La indexabilidad siempre está habilitada para los atributos del sistema predefinidos. No se puede inhabilitar este parámetro de configuración para los atributos del sistema.
  • Atributos personalizados: Habilitados de forma predeterminada. Puedes inhabilitar la indexabilidad para cualquier atributo personalizado. Si planeas hacer que un atributo personalizado sea indexable, este debe seguir el patrón de regex [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 las facetas dinámicas están habilitadas para un atributo, la búsqueda puede usar el atributo como una faceta dinámica. Las facetas dinámicas se pueden agregar automáticamente a una búsqueda en función del comportamiento anterior de los usuarios, 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: Están habilitados de forma predeterminada si la indexabilidad está configurada como "true". 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 indexabilidad 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.

Para 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 los atributos textuales pueden tener habilitada la capacidad de búsqueda. No se aplica a atributos numéricos.

  • Atributos del sistema: Vertex AI Search for Retail configura la configuración de búsqueda de los atributos del sistema textual predefinidos para Product. No se puede cambiar esta configuración.
  • Atributos personalizados: Están 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
  • Se puede buscar de forma exacta: La búsqueda segmentada muestra 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 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 las expresiones de filtro de recomendaciones para filtrar productos en las predicciones.

  • Atributos del sistema: Desactivado de forma predeterminada. Puedes activar este parámetro de configuración para cualquier atributo textual predefinido del sistema 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

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 de 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 Retail. 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 la configuración de atributos de las siguientes maneras:

  • La consola de Search for Retail: Establece configuraciones de atributos a nivel del catálogo con la consola de Search for Retail. De esta manera, se configuran los atributos de forma global en todos los productos. La configuración disponible en la consola depende del modo de configuración.

  • El método de la API de AttributeConfig: Establece configuraciones de atributos a nivel del catálogo con la API. Esto configura los 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. La configuración de atributos con este método no está disponible para los usuarios nuevos y no se recomienda.

Configura los atributos en la consola

Puedes establecer opciones de atributos de forma global en todos los productos desde la página Controles de la consola de Búsqueda para venta minorista, 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 de inmediato en 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 las configuraciones de atributos a nivel del catálogo.

En los siguientes campos, se establecen opciones de atributos a nivel del catálogo:

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

Cómo actualizar 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 un valor para un campo de atributo del catálogo, se le asigna un valor predeterminado.

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

Cómo actualizar un atributo individual

Los siguientes métodos se usan 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 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 los productos. Si se está usando un CatalogAttribute, RemoveCatalogAttribute no lo borra, pero 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 a través del método de la API de Product: