Ce document concerne Recommendations AI, Retail Search et la nouvelle console Retail.

Configurer les attributs

Retail Search peut exploiter les attributs produit pour l'indexation, les attributs dynamiques et la recherche. Cette page explique comment mettre en œuvre ce type de configuration et comment il est traité par Retail Search, en fonction de la méthode et de la configuration utilisées.

Types d'attributs

Les attributs de produit peuvent présenter différents paramètres par défaut et des options autorisées 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. Ils incluent des 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 sur Product.

  • Attributs personnalisés: vous devez définir des attributs personnalisés à l'aide du champ Product.attributes. Il peut s'agir d'un nom de magasin, d'un fournisseur ou d'un style. Pour obtenir des exemples et connaître les limites applicables aux 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 sur le produit au niveau du magasin. Vous pouvez utiliser des attributs au niveau de l'inventaire pour des produits dont les propriétés varient considérablement entre les magasins et les régions, telles que les articles d'épicerie ou les produits qui proposent des promotions spécifiques à un magasin.

    inventories.price et inventories.originalPrice sont des attributs système numériques prédéfinis par l'API Retail. 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 des attributs applicables à la recherche et aux attributs dynamiques pour les attributs au niveau de l'inventaire.

Paramètres de configuration disponibles

Vous pouvez activer et désactiver les types de configuration d'attributs suivants :

  • Indexable : Retail Search peut filtrer les résultats en fonction de cet attribut.
  • Attribut dynamique : Retail Search 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 Retail Search, ce qui augmente le nombre de rappels pour cet attribut. Ce contrôle ne s'applique qu'aux attributs de texte.

Indexable

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

  • Attributs système : l'indexation 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'indexation pour tous les attributs personnalisés. Si vous prévoyez de rendre un attribut personnalisé indexable, celui-ci doit respecter le modèle 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é. Ce paramètre est activé par défaut pour les attributs d'inventaire personnalisés. Il peut être désactivé.
  • Dépendances: non applicable

Les modifications apportées aux configurations d'attribut pour l'option "indexable" prennent effet dans un délai de 12 heures ou immédiatement après la prochaine ingestion de catalogue. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer.

Attributs dynamiques

Lorsque l'attribut dynamique est activé pour un attribut, Retail Search 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 l'attribut dynamique pour tout attribut système.
  • Attributs personnalisés: activés par défaut si l'indexabilité est définie sur "true". Vous pouvez désactiver l'affichage dynamique des attributs personnalisés.
  • Attributs au niveau de l'inventaire : non acceptés.
  • Dépendances: pour activer l'attribut dynamique d'un attribut, vous devez d'abord activer son indexation.

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 automatiquement segmentées.

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 Retail Search augmente.

La recherche ne peut être activée que pour les valeurs d'attributs textuels. Elle ne s'applique pas aux attributs numériques.

  • Attributs système : les attributs système textuels prédéfinis pour Product sont toujours inclus dans l'index de recherche. Ce paramètre ne peut pas être modifié.
  • 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: non applicable

Les produits dont l'attribut peut être recherché n'apparaissent pas systématiquement dans les résultats de recherche pour cet attribut.

Modes de configuration

Le mode de configuration défini par l'API Retail détermine comment les configurations d'attribut sont traitées et quelles configurations vous pouvez définir.

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

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 Retail. Retail Search ne permet pas de revenir au mode de configuration du produit après le basculement.

Pour vérifier le mode de configuration, accédez à la page Commandes de la console Commerce. Si l'option Indexable est disponible sous forme de colonne dans l'onglet Commandes à l'échelle du site, l'API Retail est en mode de configuration au niveau du catalogue. Si la colonne Indexable n'est pas disponible dans l'onglet Commandes à l'échelle du site, l'API Retail est en mode de configuration au niveau du produit.

Méthodes de configuration

Vous pouvez définir les configurations d'attribut de différentes manières:

  • Commerce de détail Cloud Console : configurez les configurations d'attribut au niveau du catalogue à l'aide de Cloud Console. Cette opération permet de configurer les attributs pour tous les produits, de manière globale. Les paramètres disponibles dans la console dépendent du mode de configuration défini pour l'API Retail.

  • Méthode API Product (obsolète) : définissez des attributs personnalisés au niveau du produit à l'aide de la méthode API Product. La définition d'attributs avec cette méthode n'est pas disponible pour les nouveaux utilisateurs de l'API Retail et n'est pas recommandée.

Configurer les attributs dans la console

Vous pouvez définir des options d'attributs à l'échelle mondiale pour tous les produits sur la page Commandes de la console Retail, dans l'onglet Commandes sur l'ensemble du site. Pour savoir comment procéder depuis la console, consultez la section Définir des contrôles d'attributs à l'échelle du site.

L'API Retail doit être en mode de configuration au niveau du catalogue pour utiliser cette fonctionnalité.

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 dans un délai de 12 heures, ou immédiatement lors de votre prochaine ingestion de catalogue. Les modifications de configuration des attributs dynamiques peuvent prendre jusqu'à deux jours. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer.

Configurer les attributs avec AttributesConfig

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

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

Pour récupérer toutes les configurations d'attribut, 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és dans une demande est de 1 000.

Mettre à jour 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. Cela remplace le CatalogAttribute spécifié dans 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.

Seul le produit CatalogAttributes qui n'est pas utilisé par des produits peut être supprimé. Si un CatalogAttribute est utilisé, RemoveCatalogAttribute ne le supprime pas, mais réinitialise 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 d'autres produits.

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

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

Il n'est pas recommandé de définir des attributs avec cette méthode pour les nouveaux utilisateurs de l'API Retail.

Les champs suivants définissent des paramètres indexables et inclus dans l'index de recherche pour un produit spécifique via la méthode API Product:

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

Il n'est pas recommandé de définir des attributs avec cette méthode pour les nouveaux utilisateurs de l'API Retail.

Les champs suivants définissent des paramètres indexables et inclus dans l'index de recherche pour un produit spécifique via la méthode API Product: