Acerca de los atributos de productos

Vertex AI Search para venta minorista puede aprovechar los atributos del producto para la indexación, la faceta dinámica, la capacidad de búsqueda, el filtrado y la calidad del modelo. En esta página, se analiza cómo establecer configuraciones de atributos de productos y cómo se tratan según el método y la configuración que uses.

Tipos de atributos

Los atributos de productos pueden tener diferentes configuraciones predeterminadas y opciones permitidas según su tipo.

  • Atributos del sistema: Los atributos predefinidos del sistema 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. Si quieres ver todos los atributos del sistema disponibles para productos, consulta la documentación de referencia de Product.

  • Atributos personalizados: Los atributos personalizados son atributos adicionales que defines mediante el campo Product.attributes. Por ejemplo, puedes 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 de inventario: Son atributos del sistema o personalizados que proporcionan información a nivel de la tienda sobre el producto. Puedes usar atributos a nivel de inventario para productos cuyas propiedades varían significativamente entre tiendas y regiones, como artículos de supermercado, o productos que tienen promociones específicas de tiendas.

    inventories.price y inventories.originalPrice son atributos numéricos del sistema predefinidos por Vertex AI Search para venta minorista. Puedes crear atributos personalizados a nivel del inventario, que pueden ser textuales o numéricos. Los atributos a nivel de inventario son indexables de forma predeterminada. La configuración de facetas dinámicas y con capacidad de búsqueda no es compatible con los atributos a nivel de inventario.

Opciones de configuración disponibles

La configuración de los atributos afecta el comportamiento de búsqueda y recomendaciones 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 una faceta dinámica según el comportamiento anterior del usuario, como los clics en facetas y las vistas. 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 de ese atributo. Este control se aplica solo a los atributos de texto.
  • Recuperable: Si se configura como verdadera, la búsqueda muestra este atributo en respuestas a las búsquedas. Si todos los atributos tienen configurado Recuperable como falso, los resultados de la búsqueda contienen solo el nombre del producto o, en el caso de las variantes, la información del color y el nombre del producto.

Recomendaciones usa la siguiente configuración de atributos:

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

Indexable

Si un atributo está configurado como indexable, la búsqueda puede filtrarse y crear facetas mediante el atributo.

  • Atributos del sistema: La indexabilidad siempre está habilitada para los atributos predefinidos del sistema. Este parámetro de configuración no se puede inhabilitar para los atributos del sistema.
  • Atributos personalizados: Habilitados de forma predeterminada. Puedes inhabilitar la indexabilidad para cualquier atributo personalizado. Si planeas que un atributo personalizado se pueda indexar, 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 de inventario: Siempre están habilitados para los atributos a nivel de inventario del sistema. No se puede cambiar esta configuración. Está habilitado de forma predeterminada para los atributos personalizados a nivel de inventario. Este parámetro de configuración se puede desactivar.
  • Dependencias: N/A

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

Facetas dinámicas

Cuando la faceta dinámica está habilitada para un atributo, la búsqueda puede usar el atributo como faceta dinámica. Las facetas dinámicas se pueden agregar automáticamente a una búsqueda según el comportamiento pasado del usuario, como los clics de facetas y las vistas.

  • Atributos del sistema: Están habilitados de forma predeterminada si la indexabilidad está configurada como verdadera. Puedes inhabilitar la faceta dinámica para cualquier atributo del sistema.
  • Atributos personalizados: Habilitados de forma predeterminada si la indexabilidad está configurada como verdadera. Puedes inhabilitar la faceta dinámica para cualquier atributo personalizado.
  • Atributos a nivel de inventario: No se admiten.
  • Dependencias: Para habilitar la faceta dinámica de 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.

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

Se pueden buscar

Si un atributo se configura para que se pueda buscar, se mejora la recuperación de ese atributo en las búsquedas.

Solo los valores de atributos textuales pueden tener habilitada la capacidad de búsqueda. No se puede aplicar a atributos numéricos.

  • Atributos del sistema: Los atributos textuales predefinidos del sistema para Product tienen la configuración de capacidad de búsqueda que establece Vertex AI Search para la venta minorista. No se puede cambiar esta configuración.
  • Atributos personalizados: Están inhabilitados de forma predeterminada. Puedes habilitar esta configuración para cualquier atributo textual personalizado.
  • Atributos a nivel de inventario: No se admiten.
  • Dependencias: N/A

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

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: Están desactivados de forma predeterminada. Puedes activar este parámetro de configuración para cualquier atributo de texto predefinido del sistema para Product, excepto FulfillmentInfo y title. No es compatible con atributos numéricos.
  • Atributos personalizados: Están desactivados de forma predeterminada. Puedes activar este parámetro de configuración para cualquier atributo textual personalizado de Product. No es compatible con atributos numéricos.
  • Atributos a nivel de 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 los 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 de catálogo a nivel de catálogo se usan como la fuente de información.
  • Modo de configuración a nivel del producto (obsoleto): En este modo, los parámetros de configuración de los 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 del cambio.

Para verificar el modo de configuración, ve a la página Controles de Search for Retail Console. Si la opción Indexable está disponible como una columna en la pestaña Controles de todo el sitio, el modelo de configuración es 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 los atributos de las siguientes maneras:

  • Search for Retail Console: Establece parámetros de configuración de atributos a nivel de catálogo con Search for Retail Console. Esto configura los atributos de forma global en todos los productos. La configuración que esté disponible en la consola dependerá del modo de configuración.

  • El método de la API AttributeConfig: Establece la configuración de los atributos en el nivel de catálogo mediante la API. Esto configura los atributos en todos los productos.

  • El método de la API Product (obsoleto): Configura atributos personalizados a nivel del producto con el método de la API Product. La configuración de atributos con este método no está disponible para 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 la venta minorista, en la pestaña Controles de todo el sitio. Si quieres obtener más detalles para configurar esto en la consola, consulta Cómo administrar los controles de atributos en todo el sitio.

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

Los cambios en los parámetros de configuración de los atributos para que se puedan indexar y buscar 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 los atributos con AttributesConfig

El recurso de API AttributesConfig te permite administrar la configuración de los atributos en el nivel de catálogo.

En los siguientes campos, se configuran opciones de atributos a nivel de 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 de catálogo.

Los atributos de 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 de catálogo, se le asigna un valor predeterminado.

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

Cómo actualizar un atributo individual

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

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

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

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

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

  • RemoveCatalogAttribute: Quita una configuración de atributos individuales de AttributesConfig.

    Solo se pueden borrar las CatalogAttributes que no se usen en los productos. Si un CatalogAttribute está en uso, RemoveCatalogAttribute no lo borra, pero restablece sus propiedades de configuración a los valores predeterminados. CatalogAttribute.inUse se configura como True si algún producto lo usa.

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

Configura atributos con el método Product (obsoleto)

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

En los siguientes campos, se 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 Product: