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 deProduct
.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 deProduct.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
yinventories.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
oKEY_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
, exceptoFulfillmentInfo
ytitle
. 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 APIProduct
. 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:
CatalogAttribute.indexableOption
: Establece la opción indexable de un atributo.CatalogAttribute.dynamicFacetableOption
: Establece la opción de faceta dinámica para un atributo.CatalogAttribute.searchableOption
: Configura la opción de búsqueda de un atributo.CatalogAttribute.recommendationsFilteringOption
(versión preliminar pública): Establece la opción de filtrado de recomendaciones para un atributo.
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 elCatalogAttribute
especificado enAttributesConfig
mediante la actualización del atributo del catálogo con el mismoCatalogAttribute.key
.Consulta la documentación de referencia de la API para
ReplaceCatalogAttribute
.RemoveCatalogAttribute
: Quita una configuración de atributos individuales deAttributesConfig
.Solo se pueden borrar las
CatalogAttributes
que no se usen en los productos. Si unCatalogAttribute
está en uso,RemoveCatalogAttribute
no lo borra, pero restablece sus propiedades de configuración a los valores predeterminados.CatalogAttribute.inUse
se configura comoTrue
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
:
Product.attributes.indexable
.Product.attributes.searchable
. Solo está disponible para atributos personalizados.