À propos des attributs de produit

Vertex AI Search pour le commerce peut exploiter les attributs produit pour l'indexation, les attributs dynamiques, la recherche, le filtrage et la qualité du modèle. Cette page explique comment configurer les attributs de produit et comment ils sont traités en fonction de la méthode et de la configuration que vous utilisez.

Types d'attributs

Les paramètres par défaut et les options autorisées des attributs de produit peuvent varier en fonction de leur type.

  • Attributs système: les attributs système prédéfinis sont des champs Product existants qui fournissent plus d'informations sur le produit. Il s'agit d'attributs de produit tels que la marque, la disponibilité, la couleur et la taille. Pour connaître tous les attributs système disponibles pour les produits, consultez la documentation de référence de Product.

  • Attributs personnalisés: les attributs personnalisés sont des attributs supplémentaires que vous définissez à l'aide du champ Product.attributes. Il peut s'agir, par exemple, de noms de magasins, de fournisseurs ou de styles. Pour obtenir des exemples et des limites concernant les attributs personnalisés, consultez la documentation de référence sur Product.attributes.

  • Attributs au niveau de l'inventaire: attributs système ou personnalisés qui fournissent des informations au niveau du magasin sur le produit. Vous pouvez utiliser des attributs au niveau de l'inventaire pour les produits dont les propriétés varient considérablement d'un magasin à l'autre et d'une région à l'autre, comme les produits alimentaires, ou pour les produits qui bénéficient de promotions spécifiques à un magasin.

    inventories.price et inventories.originalPrice sont des attributs système numériques prédéfinis par Vertex AI Search pour le commerce. Vous pouvez créer des attributs personnalisés au niveau de l'inventaire, qui peuvent être textuels ou numériques. Les attributs au niveau de l'inventaire sont indexables par défaut. Vous ne pouvez pas définir de facettes dynamiques et interrogeables pour les attributs au niveau de l'inventaire.

Paramètres de configuration disponibles

Les paramètres de configuration des attributs ont un impact sur le comportement de recherche et de recommandation sur l'ensemble de votre site.

La recherche utilise les paramètres d'attribut suivants:

  • Indexable: la recherche peut filtrer les résultats en fonction de cet attribut.
  • Attribut dynamique: la recherche peut utiliser automatiquement cet attribut en tant qu'attribut dynamique en se basant sur le comportement passé des utilisateurs (clics et vues par exemple). Pour activer l'option d'attribut dynamique pour un attribut, Indexable doit être défini sur "true" pour cet attribut.
  • Inclus dans l'index de recherche: cet attribut peut être trouvé par les requêtes de recherche, ce qui augmente le nombre de rappels pour cet attribut. Ce contrôle ne s'applique qu'aux attributs de texte.
  • Récupérable: si cette valeur est définie sur "true", la recherche renvoie cet attribut dans les réponses aux requêtes de recherche. Si la valeur "retrievable" est définie sur "false" pour tous les attributs, les résultats de recherche ne contiennent que le nom du produit ou (pour les variantes) le nom du produit et des informations sur la couleur. Le champ REST RetrievableFields est obsolète pour les produits. Utilisez plutôt la commande récupérable au niveau du site.

Les recommandations utilisent les paramètres d'attribut suivants:

  • Filtrable (version Preview publique): cet attribut peut être utilisé dans les expressions de filtre de recommandations. Ce contrôle ne s'applique qu'aux attributs de texte.

Indexable

Si un attribut est défini comme "indexable", la recherche peut l'utiliser comme filtre.

  • Attributs système: l'indexabilité est toujours activée pour les attributs système prédéfinis. Ce paramètre ne peut pas être désactivé pour les attributs système.
  • Attributs personnalisés: activés par défaut. Vous pouvez désactiver l'indexabilité pour n'importe quel attribut personnalisé. Si vous prévoyez d'indexer des attributs personnalisés, ils doivent suivre le format d'expression régulière [a-zA-Z0-9][a-zA-Z0-9_]*. Par exemple, key0LikeThis ou KEY_1_LIKE_THIS.
  • Attributs au niveau de l'inventaire: toujours activés pour les attributs au niveau de l'inventaire système. Ce paramètre ne peut pas être modifié. Activé par défaut pour les attributs personnalisés au niveau de l'inventaire. Ce paramètre peut être désactivé.
  • Dépendances: N/A

Les modifications apportées à la configuration de l'index prennent effet immédiatement après l'importation des données du catalogue. Sinon, la prise en compte des modifications peut prendre jusqu'à 12 heures ou plus. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer.

Attributs dynamiques

Lorsque les attributs dynamiques sont activés pour un attribut, la recherche peut l'utiliser en tant qu'attribut dynamique. Les attributs dynamiques peuvent être ajoutés automatiquement à une recherche en fonction des comportements antérieurs des utilisateurs, tels que les clics et les vues d'attributs.

  • Attributs système: activés par défaut si l'indexabilité est définie sur "true". Vous pouvez désactiver les attributs dynamiques pour n'importe quel attribut système.
  • Attributs personnalisés: activés par défaut si l'indexabilité est définie sur "true". Vous pouvez désactiver les attributs dynamiques pour n'importe quel attribut personnalisé.
  • Attributs au niveau de l'inventaire: non acceptés.
  • Dépendances: pour activer les attributs dynamiques pour un attribut, vous devez d'abord activer l'indexabilité pour cet attribut.

L'option "attribut dynamique" d'un attribut est toujours appliquée de façon globale. La configuration d'attribut dynamique que vous appliquez est utilisée par tous les produits du catalogue qui utilisent cet attribut.

Les modifications de configuration de l'option "attribut dynamique" peuvent nécessiter jusqu'à deux jours pour prendre effet. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer.

Pour les attributs personnalisés numériques, les buckets doivent être spécifiés dans la requête. Les valeurs numériques ne sont pas regroupées automatiquement.

Inclus dans l'index de recherche

Si un attribut est défini comme inclus dans l'index de recherche, le nombre de rappels pour cet attribut dans les requêtes de recherche augmente.

Seules les valeurs des attributs textuels peuvent être incluses dans l'index de recherche. Elle ne s'applique pas aux attributs numériques.

  • Attributs système: les paramètres de recherche des attributs système textuels prédéfinis pour Product sont configurés par Vertex AI Search pour le commerce. Ces paramètres ne peuvent pas être modifiés.
  • Attributs personnalisés: désactivés par défaut. Vous pouvez activer cette configuration pour n'importe quel attribut personnalisé textuel.
  • Attributs au niveau de l'inventaire: non acceptés.
  • Dépendances: N/A
  • Recherche exacte: la recherche ciblée renvoie des résultats pour les requêtes de recherche qui correspondent à un produit donné de votre catalogue. Cette option convient aux numéros de série. En savoir plus sur l'option de recherche exacte

Bien que les produits associés à un attribut inclus dans l'index de recherche aient plus de chances d'apparaître dans les résultats de recherche pour cet attribut, cela n'est pas garanti.

Filtrage des recommandations

Si le filtrage des recommandations est activé pour un attribut, vous pouvez l'utiliser dans des expressions de filtre de recommandations pour filtrer les produits dans les prédictions.

  • Attributs système: désactivé par défaut. Vous pouvez activer ce paramètre pour tous les attributs textuels système prédéfinis pour Product, à l'exception de FulfillmentInfo et title. Non compatible avec les attributs numériques.
  • Attributs personnalisés: désactivé par défaut. Vous pouvez activer ce paramètre pour tous les attributs textuels personnalisés pour Product. Non compatible avec les attributs numériques.
  • Attributs au niveau de l'inventaire: acceptés uniquement pour la valeur IN_STOCK de availability.
  • Dépendances: N/A

Modes de configuration

Le mode de configuration détermine la manière dont les configurations d'attributs sont traitées et les configurations d'attributs que vous pouvez appliquer.

  • Mode de configuration au niveau du catalogue (par défaut): dans ce mode, les configurations d'attributs au niveau du catalogue sont utilisées comme source de vérité.
  • Mode de configuration au niveau du produit (obsolète): dans ce mode, les configurations d'attributs au niveau du produit sont utilisées comme source de vérité.

Auparavant, la configuration au niveau du produit était le mode par défaut. Si vous êtes toujours en mode de configuration au niveau du produit et que vous devez basculer vers le mode de configuration au niveau du catalogue, contactez l'assistance. Search ne permet pas de revenir au mode de configuration au niveau du produit après le basculement.

Pour vérifier le mode de configuration, accédez à la page Commandes de la console Search for Retail. Si l'option Indexable est disponible en tant que colonne dans l'onglet Contrôles à l'échelle du site, le modèle de configuration est au niveau du catalogue. Si la colonne Indexable n'est pas disponible dans l'onglet Contrôles à l'échelle du site, le modèle de configuration est au niveau du produit.

Méthodes de configuration

Vous pouvez définir des configurations d'attributs de différentes manières:

  • Console Search for Retail: définissez les configurations d'attributs au niveau du catalogue à l'aide de la console Search for Retail. Les attributs sont ainsi configurés de manière globale pour tous les produits. Les paramètres disponibles dans la console dépendent du mode de configuration.

  • Méthode API AttributeConfig: définissez les configurations d'attributs au niveau du catalogue à l'aide de l'API. Cela configure les attributs pour tous les produits.

  • Méthode API Product (obsolète): définissez des attributs personnalisés au niveau du produit à l'aide de la méthode API Product. Les nouveaux utilisateurs ne peuvent pas définir d'attributs avec cette méthode, et celle-ci n'est pas recommandée.

Configurer des attributs dans la console

Vous pouvez définir des options d'attributs de façon globale pour tous les produits à partir de la page Contrôles de la console Retail Search, dans l'onglet Contrôles à l'échelle du site. Pour savoir comment procéder depuis la console, consultez la section Gérer les contrôles d'attributs à l'échelle du site.

Pour utiliser cette fonctionnalité, le mode de configuration doit être au niveau du catalogue.

Les modifications apportées aux paramètres de configuration d'attribut pour les propriétés indexables et incluses dans l'index de recherche prennent effet immédiatement lors de l'ingestion de catalogue. Sinon, la prise en compte des modifications peut prendre jusqu'à 12 heures ou plus. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer.

Configurer des attributs avec AttributesConfig

La ressource API AttributesConfig vous permet de gérer les configurations d'attributs au niveau du catalogue.

Les champs suivants définissent des options d'attribut au niveau du catalogue:

Pour récupérer toutes les configurations d'attributs, utilisez la méthode GetAttributesConfig.

Mettre à jour plusieurs attributs

Utilisez la méthode updateAttributesConfig pour mettre à jour plusieurs attributs au niveau du catalogue.

Les attributs de catalogue que vous incluez dans la requête sont mis à jour dans le catalogue ou insérés s'ils n'existent pas. Si aucune valeur n'est définie pour un champ d'attribut de catalogue, une valeur par défaut lui est attribuée.

Le nombre maximal d'attributs de catalogue autorisé dans une requête est de 1 000.

Modifier un attribut individuel

Les méthodes suivantes permettent de mettre à jour des attributs de catalogue individuels:

  • AddCatalogAttribute: ajoute une configuration d'attribut individuelle à un attribut de catalogue.

    Consultez la documentation de référence de l'API pour AddCatalogAttribute.

  • ReplaceCatalogAttribute: modifie la configuration d'un attribut individuel. Cette opération remplace le CatalogAttribute spécifié dans le AttributesConfig en mettant à jour l'attribut de catalogue avec le même CatalogAttribute.key.

    Consultez la documentation de référence de l'API pour ReplaceCatalogAttribute.

  • RemoveCatalogAttribute: supprime une configuration d'attribut individuelle de AttributesConfig.

    Seuls les CatalogAttributes qui ne sont pas utilisés par des produits peuvent être supprimés. Si un CatalogAttribute est utilisé, RemoveCatalogAttribute ne le supprime pas, mais rétablit ses propriétés de configuration sur les valeurs par défaut. CatalogAttribute.inUse est défini sur True si l'attribut est utilisé par des produits.

    Consultez la documentation de référence de l'API pour RemoveCatalogAttribute.

Configurer des attributs avec la méthode Product (obsolète)

Les nouveaux utilisateurs ne peuvent pas définir d'attributs avec cette méthode, et celle-ci n'est pas recommandée.

Les champs suivants définissent les paramètres d'indexabilité et de recherche d'un produit spécifique via la méthode API Product: