À propos des attributs de produit

Vertex AI Search pour le commerce peut utiliser 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 utilisées.

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. Il s'agit, par exemple, des attributs de produit tels que la marque, la disponibilité, la couleur et la taille. Pour obtenir la liste de tous les attributs système disponibles pour les produits, consultez la documentation de référence sur Product.

  • Attributs personnalisés : il s'agit d'attributs supplémentaires que vous définissez à l'aide du champ Product.attributes. Par exemple, cela peut inclure les noms de magasins, les fournisseurs ou le style. Pour obtenir des exemples et des limites concernant les attributs personnalisés, consultez la documentation de référence sur Product.attributes.

    Voici quelques exemples d'attributs personnalisés figurant dans le top 20 :

    • Gamme de produits à laquelle appartient ce produit
    • Volume des ventes en magasin pour ce produit
    • Occasion pour les vêtements
    • Offres et bons de réduction applicables à ce produit
    • Popularité des produits sur l'ensemble du site

  • 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 entre les magasins et les régions, comme les produits d'épicerie, 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. Il n'est pas possible de définir l'ajout d'attributs dynamique et la 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 recommandation sur l'ensemble de votre site.

La recherche utilise les paramètres d'attributs 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 la valeur est définie sur "true", la recherche renvoie cet attribut dans les réponses aux requêtes de recherche. Si la valeur "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 du produit et des informations sur la couleur. Le champ REST RetrievableFields est obsolète pour les produits. Utilisez plutôt le contrôle récupérable à l'échelle du site.

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

  • Filtrable (aperçu public) : 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 de rendre un index d'attributs personnalisés, il doit suivre 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 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 l'index prennent effet immédiatement après l'importation des données 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.

Attributs dynamiques

Lorsque l'attribut dynamique est activé 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 l'attribut dynamique 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 l'option d'attribut dynamique 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, des buckets doivent être spécifiés dans la requête. Les valeurs numériques ne sont pas automatiquement placées dans des buckets.

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 d'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 d'indexation des attributs système textuels prédéfinis pour Product sont configurés par Vertex AI Search pour le commerce. Ce paramètre ne peut pas être modifié.
  • Attributs personnalisés : désactivés par défaut. Vous pouvez activer cette option de configuration pour n'importe quel attribut personnalisé textuel.
  • Attributs au niveau de l'inventaire : non acceptés.
  • Dépendances : N/A
  • Recherche exacte : les résultats de recherche ciblés sont renvoyés pour les requêtes de recherche qui correspondent à un produit donné de votre catalogue. Cette option est idéale pour les numéros de série. En savoir plus sur l'option de recherche exacte

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, leur affichage n'est pas garanti.

Filtrage des recommandations

Si le filtrage des recommandations est activé pour un attribut, il peut être utilisé dans les expressions de filtre de 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 n'importe quel attribut système textuel prédéfini pour Product, à l'exception de FulfillmentInfo et title. Non disponible pour les attributs numériques.
  • Attributs personnalisés : désactivés par défaut. Vous pouvez activer ce paramètre pour n'importe quel attribut textuel personnalisé pour Product. Non disponible pour les attributs numériques.
  • Attributs au niveau de l'inventaire : acceptés uniquement pour la valeur availability IN_STOCK.
  • Dépendances : N/A

Option de recherche exacte

Vous pouvez attribuer une certaine valeur à des requêtes de chaîne spécifiques à l'option exact-searchable, qui est un champ d'attribut de catalogue. Si une requête correspond à un produit de votre catalogue dont la valeur pour ce champ est la chaîne indiquée dans la requête, ce produit est renvoyé dans la requête de recherche. Cette option est idéale pour les numéros de série, pour lesquels les clients s'attendent à une expérience de recherche ciblée.

En général, le champ ExactSearchableOption est utile pour les attributs de produit avec une valeur exacte (comme ModelId ou ManufacturerId). Les attributs tels que product_id sont des champs d'index principaux, qui peuvent être recherchés de manière exacte par défaut. Le champ item_id est toujours activé pour la requête exacte et ne peut pas être désactivé.

  • Pour éviter de renvoyer des éléments non pertinents dans les recherches, ne définissez jamais l'option "Peut faire l'objet d'une recherche" sur une valeur générique telle que battery.
  • Pour éviter de sous-diffuser les requêtes de recherche, ne définissez pas de champs spéciaux comme tag (qui peut avoir "iphone" comme l'une de ses valeurs de chaîne) sur "exact-searchable". Cela pourrait entraîner la limitation des résultats pour tous les iPhones du catalogue de produits.

Pour en savoir plus, consultez À propos des attributs de produit.

Comportement des attributs

Lorsque vous structurez votre catalogue de produits à l'aide de désignations de produits principaux et de variantes, vous devez savoir comment les attributs de produit sont gérés pour le filtrage. Leur comportement dépend de l'utilisation de la recherche ou des recommandations, et de la façon dont vous configurez la taxonomie de votre catalogue.

Pour garantir un comportement de filtrage prévisible et précis, assurez-vous que les définitions de vos attributs filtrables sont cohérentes et complètes pour les produits principaux et les variantes. Cette approche permet un filtrage précis, ce qui améliore la découverte des produits et la pertinence des recherches.

Comportement des variantes principales dans la recherche par rapport aux recommandations

Bien que seuls les articles principaux soient renvoyés dans les résultats de recherche et de recommandation, Vertex AI Search pour le commerce optimise la qualité de la recherche et des recommandations.

  • Pour les modèles de recherche, les attributs de variante sont utilisés pour le produit principal dans l'index de recherche. Les résultats de recherche affichent différentes options pour le produit principal en fonction des attributs de ses variantes.

  • Pour les modèles de recommandation, les détails et les attributs des produits ne sont pas hérités de la variante principale. Pour une qualité de recommandation optimale, il est essentiel que les produits principaux et les variantes disposent d'informations complètes et précises pour les attributs clés tels que product.categories, product.title, product.attributes et product.prices.

Gérer les attributs lors de l'indexation et du filtrage

Si le même attribut est défini dans Primary et Variant, l'attribut de la variante fait partie du filtrage. Par exemple, supposons qu'un attribut soit défini pour un produit principal et ses variantes (couleur ou taille). Les valeurs des attributs de variante servent principalement au filtrage, au cours duquel le système vérifie si l'une des variantes de l'élément principal correspond à la valeur de l'attribut. Disponibilité des produits : un produit principal peut être marqué comme out-of-stock, mais si au moins l'une de ses variantes est in-stock, le produit principal est disponible dans les résultats de recherche si un filtre in-stock est appliqué.

Pour les raisons suivantes, définissez les mêmes attributs filtrables dans Principal et Variante :

  • Les attributs de variante sont prioritaires pour le filtrage. Si un attribut est défini sur un produit principal et ses variantes, l'attribut de la variante est utilisé pour le filtrage. Par exemple, si un produit principal a une couleur de substitution, mais que ses variantes ont des couleurs réelles, la couleur de la variante doit être renseignée et utilisée pour le filtrage.

  • Pour les attributs liés à l'inventaire, comme la disponibilité, si un produit principal comporte des variantes, la disponibilité du produit principal doit être définie sur OUT_OF_STOCK, tandis que la disponibilité réelle (par exemple, IN_STOCK) doit être définie au niveau de la variante. Ainsi, le produit principal est considéré comme étant en stock tant qu'au moins une variante l'est. Si tel est le cas, les filtres tels que availability: ANY("IN_STOCK") renvoient correctement le produit principal.

  • Lorsqu'une expression de filtre est utilisée, la réponse de prédiction renvoie les produits principaux qui comportent au moins un produit principal ou une variante correspondant à la valeur d'attribut du filtre.

Attributs de filtrage facultatifs

Veillez à ce que le champ categories soit propre et optimisé pour la classification. Si vous avez besoin de plus de filtres, implémentez-les en fonction de catégories générales à l'aide d'attributs personnalisés distincts, et non dans le champ categories. Cela permet également d'éviter d'avoir un impact négatif sur l'entraînement de la saisie semi-automatique pour les suggestions de catégories.

Par exemple, imaginons que vous définissiez généralement des catégories telles que [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] pour le filtrage. La saisie semi-automatique comptabilise les catégories les plus fréquentes pour une requête donnée. Vous obtenez donc lvl1 et lvl2 (tous vos produits) comme catégories suggérées.

Bonnes pratiques

Si votre catalogue se compose de produits principaux et de variantes et que le même attribut est défini dans les deux, l'attribut de la variante sera pris en compte lors du filtrage.

  • Renseignez les attributs avec précision : assurez-vous que les produits principaux et les variantes disposent de détails complets et précis pour leurs attributs, en particulier ceux utilisés pour le filtrage, afin de maximiser leur efficacité.

  • Utilisez les champs intégrés : ne vous fiez pas uniquement aux attributs personnalisés. Mappez les informations sur vos produits avec les champs Product intégrés (brands, colors, sizes et les champs obligatoires). Les champs intégrés ont un impact plus important sur l'optimisation de la capacité de recherche, de l'indexabilité et de la pertinence. Les attributs personnalisés (Product.attributes) sont destinés aux données produit qui ne correspondent pas aux attributs système prédéfinis.

  • Définir le contrôle des champs récupérables à l'échelle du site : l'API est compatible avec variantRollupKeys pour les variantes, ce qui vous permet de récupérer des informations dans les réponses de recherche.

  • Langue cohérente du catalogue : le catalogue de produits doit être dans une seule langue, et les requêtes de recherche doivent être envoyées dans la même langue. Le fait d'avoir plusieurs langues dans le catalogue peut nuire aux performances du modèle. Si vous ne définissez pas le code de langue, cela peut affecter des fonctionnalités telles que la correction orthographique.

  • Informations sur les prix : renseignez précisément les informations sur les prix des produits principaux et des variantes pour garantir des recommandations et des filtres précis. Si un produit ne dispose pas de prix au niveau du produit et repose uniquement sur les prix de l'inventaire en magasin, indiquez le prix médian des prix au niveau de l'inventaire pour le produit principal.

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'attribut 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 du produit après le basculement.

Pour vérifier le mode de configuration, accédez à la page Contrôles de la console Search for Commerce. Si l'option Indexable est disponible en tant que colonne dans l'onglet Contrôles à l'échelle du site, cela signifie que 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, cela signifie que 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 commerce : définissez les configurations d'attribut au niveau du catalogue à l'aide de la console Search for commerce. Cette option configure les attributs de façon globale pour tous les produits. Les paramètres disponibles dans la console dépendent du mode de configuration. Pour savoir comment configurer des attributs dans la console, consultez la section suivante.

  • Méthode API AttributeConfig : définissez les configurations d'attribut au niveau du catalogue à l'aide de l'API. Cette opération 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. 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'attribut de façon globale pour tous les produits à partir de la page Contrôles de la console Search for Commerce, dans l'onglet Contrôles à l'échelle du site. Pour savoir comment procéder depuis la console, consultez 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 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 d'API AttributesConfig vous permet de gérer les configurations d'attributs 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'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és dans une demande est de 1 000.

Modifier un attribut individuel

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

  • 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 méthode 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.

    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)

Cette méthode de définition des attributs n'est pas disponible pour les nouveaux utilisateurs et n'est pas recommandée.

Les champs suivants définissent les paramètres d'indexation et de recherche pour un produit spécifique à l'aide de la méthode d'API Product :