À propos des attributs de produit

Vertex AI Search pour le commerce peut exploiter les attributs des produits pour l'indexation, la création d'attributs dynamiques, la possibilité de rechercher, le filtrage et la qualité des modèles. Cette page explique comment définir les configurations des attributs de produit et comment elles sont traitées en fonction de la méthode et de la configuration que vous utilisez.

Types d'attributs

Les attributs de produit peuvent avoir des paramètres par défaut et des options autorisées différents selon 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. Ceux-ci 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: les attributs personnalisés sont des attributs supplémentaires que vous définissez à l'aide du champ Product.attributes. Par exemple, il peut s'agir des noms, des fournisseurs ou du style des magasins. 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 sur le produit au niveau du magasin. Vous pouvez utiliser des attributs au niveau de l'inventaire pour les produits dont les propriétés varient considérablement selon les magasins et les régions, comme les produits alimentaires, ou pour les produits faisant l'objet 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. Il n'est pas possible de définir des attributs dynamiques et inclus dans l'index de recherche 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 recommandations sur votre site.

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

  • Indexable: cet attribut permet de filtrer et d'appliquer des attributs de recherche.
  • Attributs dynamiques: la recherche peut automatiquement utiliser cet attribut en tant qu'attribut dynamique en fonction du comportement antérieur des utilisateurs, comme les clics et les vues d'attribut. 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 faire l'objet d'une recherche par le biais de requêtes de recherche, ce qui augmente le rappel pour cet attribut. Ce contrôle ne s'applique qu'aux attributs de texte.
  • Récupérable: si défini sur "true", la recherche renvoie cet attribut dans les réponses aux requêtes de recherche. Si l'option "Récupérable" 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 et la couleur du produit.

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. Cette commande ne s'applique qu'aux attributs de texte.

Indexable

Si un attribut est défini comme indexable, la recherche peut appliquer un filtre et un attribut à l'aide de cet attribut.

  • 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é de n'importe quel attribut personnalisé. Si vous envisagez de rendre un attribut personnalisé indexable, il doit suivre le modèle d'expression régulière [a-zA-Z0-9][a-zA-Z0-9_]*. Exemples : key0LikeThis ou KEY_1_LIKE_THIS.
  • Attributs au niveau de l'inventaire: toujours activés pour les attributs système au niveau de l'inventaire. 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 votre index prennent effet immédiatement après l'importation des données de catalogue. Dans le cas contraire, un délai de 12 heures ou plus peut être nécessaire pour que vos modifications soient prises en compte. 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 utiliser celui-ci 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 compatibles.
  • 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 numériques personnalisés, 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 sur "inclus dans l'index de recherche", le rappel de cet attribut dans les requêtes de recherche est amélioré.

L'option de recherche ne peut être activée que pour les valeurs d'attributs textuels. Elle n'est pas applicable 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 tout attribut personnalisé textuel.
  • Attributs au niveau de l'inventaire: non compatibles.
  • Dépendances: N/A

Bien que les produits avec un attribut inclus dans l'index de recherche soient plus susceptibles d'apparaître dans les résultats de recherche pour cet attribut, il n'est pas garanti qu'ils apparaissent.

Filtrage des recommandations

Si le filtrage des recommandations est activé pour un attribut, il peut être utilisé dans les expressions de filtre des recommandations pour filtrer les produits dans les prédictions.

  • Attributs système: désactivés 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és par défaut. Vous pouvez activer ce paramètre pour tous les attributs textuels personnalisés de Product. Non compatible avec les attributs numériques.
  • Attributs au niveau de l'inventaire: compatibles uniquement pour la valeur availability IN_STOCK.
  • Dépendances: N/A

Modes de configuration

Le mode de configuration détermine la manière dont les configurations d'attribut sont traitées et les configurations d'attribut que 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 au niveau du catalogue sont utilisées comme source de référence.
  • 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 de référence.

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 passer au mode de configuration au niveau du catalogue, contactez l'assistance. La recherche 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 Paramètres de la console Search for Retail. Si l'option Indexable est disponible sous forme de colonne dans l'onglet Commandes sur l'ensemble du site, le modèle de configuration est appliqué au niveau du catalogue. Si la colonne Indexable n'est pas disponible dans l'onglet Commandes sur l'ensemble du site, le modèle de configuration est appliqué au niveau du produit.

Méthodes de configuration

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

  • Console Search for Retail: définissez les configurations d'attribut au niveau du catalogue à l'aide de la console Search for Retail. Cela permet de configurer les attributs de tous les produits à l'échelle mondiale. Les paramètres disponibles dans la console dépendent du mode de configuration.

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

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

Configurer les attributs dans la console

Vous pouvez définir des options d'attributs de manière globale pour tous les produits depuis la page Commandes de la console Search for Retail, dans l'onglet Commandes sur l'ensemble du site. Pour savoir comment définir cette option dans la console, consultez Gérer les commandes d'attributs sur l'ensemble du site.

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

Les modifications apportées aux paramètres de configuration des attributs pour les attributs indexables et indexables prennent effet immédiatement après l'ingestion du catalogue. Sinon, un délai de 12 heures ou plus peut être nécessaire pour que les modifications soient prises en compte. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer.

Configurer les attributs avec AttributesConfig

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

Les champs suivants définissent les options d'attribut 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 un champ d'attribut de catalogue ne contient aucune valeur, une valeur par défaut lui est attribuée.

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

Mettre à jour un attribut individuel

Les méthodes suivantes sont utilisées pour mettre à jour des attributs de catalogue individuels:

  • AddCatalogAttribute: ajoute une configuration d'attribut individuel à 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 action 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 les produits peuvent être supprimés. Si un élément CatalogAttribute est utilisé, RemoveCatalogAttribute ne le supprime pas, mais réinitialise ses propriétés de configuration aux 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 les attributs avec la méthode Product (obsolète)

La définition d'attributs avec cette méthode n'est pas disponible pour les nouveaux utilisateurs et n'est pas recommandée.

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: