À propos des attributs de produit

Vertex AI Search pour le commerce peut exploiter les attributs de produits pour l'indexation, les attributs dynamiques, la recherche, le filtrage et la qualité du modèle. Cette page traite de la définition des configurations d'attributs de produit et de leur traitement selon la méthode et la configuration que vous utilisez.

Types d'attributs

Les attributs de produit peuvent avoir différents paramètres par défaut et 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. Il s'agit notamment 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 de Product.

  • Attributs personnalisés: ils 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 connaître les 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 systèmes numériques. prédéfinis par Vertex AI Search pour le commerce. Vous pouvez créer des modèles des attributs au niveau de l'inventaire, qui peuvent être textuels ou numériques. 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 la recherche et des recommandations 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 la valeur est "true", la recherche renvoie cette dans les réponses aux requêtes de recherche. Si tous les attributs ont Paramètre "Récupérable" défini sur "false", les résultats de recherche ne contiennent que le nom du produit ou (pour les variantes) le nom du produit et les informations sur la couleur. Le champ REST RetrievableFields est obsolète pour les produits. Utilisez plutôt le contrôle récupérable sur l'ensemble du site.

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

  • Filtrable (version Preview publique): cet attribut peut être utilisé dans les recommandations. les expressions de filtre. Ce contrôle 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 l'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é pour n'importe quel attribut personnalisé. Si vous prévoyez d'indexer un attribut personnalisé, 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 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, l'application des modifications peut prendre jusqu'à 12 heures. Vous pouvez vérifier si vos modifications ont été appliquées le Page Évaluation.

Attributs dynamiques

Lorsque les attributs dynamiques sont activés pour un attribut, la recherche peut utiliser l'attribut 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 modifications ont été appliquées au Page Évaluation.

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.

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 comportent les paramètres de recherche configurés par Vertex AI Search pour le commerce. Ces ne peut pas être modifié.
  • Attributs personnalisés : désactivés par défaut. Vous pouvez l'activer de tout attribut textuel personnalisé.
  • Attributs au niveau de l'inventaire: non compatibles.
  • Dépendances : N/A

Les produits associés à un attribut inclus dans l'index de recherche sont plus susceptibles d'apparaître dans 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, vous pouvez l'utiliser dans des 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 attributs textuels système prédéfinis pour Product, à l'exception de FulfillmentInfo et title. Non disponible pour les attributs numériques.
  • Attributs personnalisés : désactivé par défaut. Vous pouvez activer ce paramètre 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 availability IN_STOCK
  • 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, des configurations d'attribut au niveau du catalogue au niveau du catalogue sont utilisées la 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 encore en mode de configuration au niveau du produit et devez passer au niveau du catalogue mode Configuration, contactez l'assistance. Réseau de Recherche ne permet pas de revenir au mode de configuration au niveau du produit une fois que vous avez basculée.

Pour vérifier le mode de configuration, accédez à la console Search for Retail Page Paramètres. Si le L'option Indexable est disponible sous forme de colonne dans l'onglet Contrôles sur l'ensemble du site. alors le modèle de configuration est défini 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. Cela permet de configurer les attributs de manière globale tous les produits. Les paramètres disponibles dans la console dépendent de : le 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. Le fait de définir des attributs avec cette n'est pas disponible pour les nouveaux utilisateurs et n'est pas recommandé.

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 défini au niveau du catalogue.

Modifications apportées aux paramètres de configuration des attributs pour les prises indexables et incluses dans l'index de recherche immédiatement après l'ingestion du catalogue. Sinon, l'opération peut prendre jusqu'à 12 heures pour que les modifications soient prises en compte. Vous pouvez vérifier si vos modifications appliqué le Page Évaluation.

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é par requête 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 par 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 la configuration d'un attribut individuel. 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 une produits.

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

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

La définition d'attributs à l'aide de cette méthode n'est pas disponible pour les utilisateurs et n'est pas recommandée.

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