Acerca de los atributos de producto

Vertex AI Search for Retail 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. Esta página se analiza la configuración de los atributos del producto 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 parámetros de configuración predeterminados y opciones permitidas según su tipo.

  • Atributos del sistema: Los atributos predefinidos del sistema son existentes Product campos 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 todos atributos de sistema disponibles para los productos, consulta la Documentación de referencia de Product.

  • Atributos personalizados: Son atributos adicionales que tú defines con el campo Product.attributes. Por ejemplo, esto podría incluir la tienda nombres, proveedores o estilo. Para ver ejemplos y límites de atributos personalizados, consulta el 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 métricas de rendimiento atributos de los productos cuyas propiedades varían significativamente entre las tiendas y regiones, como artículos de supermercado, o bien para productos que tienen restricciones promociones.

    inventories.price y inventories.originalPrice son atributos numéricos del sistema predefinidos por Vertex AI Search for Retail. Puedes crear una configuración atributos a nivel de inventario, que pueden ser textuales o numéricos. Nivel de 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 los atributos afecta el comportamiento de las búsquedas y las recomendaciones en tu sitio.

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

  • Indexable: La búsqueda puede filtrar y agregar 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.
  • Disponible para búsquedas: Este atributo se puede buscar mediante la búsqueda. las consultas, lo que aumenta la recuperación de ese atributo. Este control se aplica solo a los atributos de texto.
  • Recuperable: Si se establece como verdadero, la búsqueda muestra lo siguiente: en las respuestas a las consultas de búsqueda. 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.

En Recomendaciones, se usa la siguiente configuración de atributos:

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

Indexable

Si un atributo se establece como indexable, la búsqueda puede filtrar y agregar facetas. con el atributo.

  • 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 de inventario: Siempre están habilitados para el nivel de inventario del sistema. atributos; no se puede cambiar esta configuración. Habilitada de forma predeterminada para atributos personalizados a nivel de inventario; se puede desactivar este parámetro de configuración.
  • 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 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 la faceta dinámica está habilitada para un atributo, la búsqueda usar el atributo como 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. Tú puede inhabilitar la faceta dinámica para cualquier atributo del sistema.
  • Atributos personalizados: Se habilitan de forma predeterminada si la indexabilidad se establece 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.

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

  • Atributos del sistema: Se incluyen los atributos textuales predefinidos del sistema para Product la configuración de capacidad de búsqueda establecida por Vertex AI Search for Retail. 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 de inventario: No se admiten.
  • Dependencias: N/A

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: Están desactivados de forma predeterminada. Puedes activar este parámetro de configuración para cualquier atributos textuales personalizados para 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 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 de producto y necesitas cambiar a nivel de configuración nuevo, comunícate con el equipo de asistencia. Búsqueda no permite volver al modo de configuración a nivel del producto después de cambia.

Para verificar el modo de configuración, ve a la consola de Search for Retail Página Controles. Si el botón La opción Indexable está disponible como una columna en la pestaña Controles del sitio. entonces 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 del producto.

Métodos de configuración

Puedes establecer la configuración de los atributos de las siguientes maneras:

  • La consola de Search for Retail: de atributos en el nivel de catálogo con el Consola de Search for Retail. Esto configura los atributos de forma global en todos los productos. ¿Cuál de estos parámetros de configuración está disponible en la consola depende de lo siguiente? el 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 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. Establecer atributos con esto no está disponible para usuarios nuevos ni está se recomienda.

Configura los atributos en la consola

Puedes establecer opciones de atributos de forma global en todos los productos desde Consola de Search for Retail Controles en la La pestaña Controles del sitio. Para 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 estar 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, puede tardar hasta 12 horas. o más para que se apliquen los cambios. Puedes probar si tus cambios se modificaron se aplicó el Página Evaluar.

Configura los atributos con AttributesConfig

El recurso de API de AttributesConfig te permite administrar configuraciones de atributos en el nivel de catálogo.

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

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

Actualizar varios atributos

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

Los atributos de catálogo que incluyas en la solicitud se actualizarán en el catálogo o insertarse si no existen. Si un catálogo no tiene valor se le asigna un valor predeterminado.

La cantidad máxima de atributos de catálogo permitida 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 para 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 para ReplaceCatalogAttribute

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

    Solo se pueden borrar las CatalogAttributes que no se usen en los productos. Si una CatalogAttribute está en uso. RemoveCatalogAttribute no lo borra, pero restablece sus propiedades de configuración a los valores predeterminados. CatalogAttribute.inUse se establece en True si alguna persona está usando el atributo productos.

    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 los usuarios nuevos usuarios 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: