AI Commerce Search peut utiliser les attributs de produits pour l'indexation, le facettage dynamique, la facilité de recherche, le filtrage et la qualité du modèle. Cette page explique comment définir des configurations d'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
Productexistants 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 connaître tous les attributs système disponibles pour les produits, consultez la documentation de référence surProduct.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 surProduct.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 attributs 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 d'un magasin et d'une région à l'autre, comme les produits d'épicerie, ou pour les produits qui bénéficient de promotions spécifiques à un magasin.
inventories.priceetinventories.originalPricesont des attributs système numériques prédéfinis par AI Commerce Search. 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'attribut "interrogeable" et l'ajout d'attributs dynamique pour les attributs au niveau de l'inventaire.
Paramètres d'attributs 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.
| Configuration | Description | Attributs système | Attributs personnalisés | Attributs au niveau de l'inventaire |
|---|---|---|---|---|
| Facilité de recherche | Cet attribut peut être recherché à l'aide de requêtes de recherche, ce qui augmente le rappel pour cet attribut (attributs textuels uniquement). | Toujours activé (texte uniquement) | Désactivé par défaut (peut être activé ; texte uniquement) | Non compatible |
| Indexabilité | La recherche peut filtrer et créer des facettes à l'aide de cet attribut. | Toujours activé | Activée par défaut (peut être désactivée) | Système : toujours activé Personnalisé : activé par défaut (peut être désactivé) |
| Attributs dynamiques | La recherche peut utiliser automatiquement cet attribut comme facette dynamique, en fonction du comportement passé des utilisateurs, comme les clics et les vues de facettes (attributs de texte uniquement). | Activé par défaut (si indexability = True) (peut être désactivé) |
Activé par défaut (si indexability = True) (peut être désactivé) |
Non compatible |
| Filtrable (preview) |
Cet attribut peut être utilisé dans les expressions de filtre Recommendations AI. Ce paramètre ne s'applique qu'aux attributs de texte. | Désactivé par défaut (peut être activé pour le texte, sauf pour FulfillmentInfo et Title) |
Désactivé par défaut (peut être activé pour le texte) | Compatible uniquement avec availability=IN_STOCK |
| Correspondance exacte | Cette propriété ne s'applique qu'aux attributs personnalisés textuels. Pour activer la recherche exacte, l'indexation doit être activée. | Non compatible | Désactivé par défaut (peut être activé) | Non compatible |
La recherche utilise les paramètres d'attribut suivants :
- Indexable : la recherche peut filtrer et ajouter des facettes à l'aide de cet attribut.
- Attributs dynamiques : la recherche peut utiliser automatiquement cet attribut en tant qu'attribut dynamique en fonction du comportement passé des utilisateurs, comme les clics et les vues sur les attributs. 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 recherché à l'aide 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 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 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 expressions de filtre de recommandations. Ce paramètre ne s'applique qu'aux attributs de texte.
Indexable
Si un attribut est défini comme indexable, la recherche peut filtrer et facetter à 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é pour n'importe quel attribut personnalisé. Si vous prévoyez de rendre un index d'attributs personnalisés indexable, il doit suivre le modèle d'expression régulière
[a-zA-Z0-9][a-zA-Z0-9_]*. Par exemple,key0LikeThisouKEY_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. 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.
Attributs dynamiques
Lorsque les attributs dynamiques sont activés pour un attribut, la recherche peut l'utiliser comme 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 facettes 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 l'ajout d'attributs dynamique pour n'importe quel attribut personnalisé.
- Attributs au niveau de l'inventaire : non acceptés.
- Dépendances : pour activer le faceting dynamique pour un attribut, vous devez d'abord activer l'indexabilité de 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 automatiquement placées dans des buckets.
Inclus dans l'index de recherche
Si un attribut est défini sur "Inclus dans l'index de recherche", le rappel pour cet attribut dans les requêtes de recherche est amélioré.
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 de recherche des attributs système textuels prédéfinis pour
Productsont configurés par AI Commerce Search. 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 : les résultats de recherche ciblés correspondent aux 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
Bien qu'il existe une limite de 10 attributs filtrables pouvant être agrégés à partir de variantes dans des produits principaux pour les recommandations, si un attribut est associé au filtrage des recommandations, 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 tous les attributs textuels système prédéfinis pour
Product, à l'exception deFulfillmentInfoettitle. Non disponible pour 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 disponible pour les attributs numériques. - Attributs au niveau de l'inventaire : acceptés uniquement pour la valeur
availabilityIN_STOCK. - Dépendances : N/A
Option de recherche exacte
Vous pouvez attribuer une certaine valeur à des requêtes de chaîne spécifiques pour 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 de 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, pour les attributs personnalisés, 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 le mot clé exact 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 être recherché" 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 valeur de chaîne) sur "Recherche exacte". Cela pourrait limiter les résultats de ces requêtes pour tous les iPhones du catalogue de produits.
Pour en savoir plus, consultez À propos des attributs de produit.
Bonnes pratiques pour configurer les attributs
Ces bonnes pratiques sont importantes pour comprendre comment indexer correctement vos attributs personnalisés, en gardant à l'esprit certains mécanismes d'analyse linguistique qui pourraient affecter leur capacité à être recherchés.
- Gestion des caractères alphanumériques (références ou SKU) : l'analyse linguistique par défaut étant optimisée pour le langage naturel, elle peut supprimer les caractères spéciaux tels que les traits d'union (
-) des références (par exemple, en convertissantpart-123enpartet123). Pour que ces numéros puissent être recherchés, vous devez utiliser l'indicateur d'attributexact-searchable. - Solution de contournement pour les N-grammes : pour les numéros de modèle très complexes contenant des caractères spéciaux, la bonne pratique consiste à diviser la chaîne en N-grammes dans votre propre pipeline de données avant l'ingestion, et à stocker la chaîne d'origine dans un attribut personnalisé marqué comme
exact searchable: true. Cela force une correspondance stricte avec vos fragments de n-grammes. - Restrictions concernant les clés d'attributs personnalisés : les clés d'attributs personnalisés ne peuvent pas contenir de traits d'union ni de caractères spéciaux. Pour être indexable, la clé doit correspondre exactement au modèle d'expression régulière
[a-zA-Z0-9][a-zA-Z0-9_]*. Pour en savoir plus, consultez la page À propos des attributs de produit. - Exigence UTF-8 : tous les attributs et valeurs de chaîne doivent être des chaînes encodées au format UTF-8 valides.
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 produits principaux et des variantes dans la recherche et les recommandations
Bien que seuls les articles principaux soient renvoyés dans les résultats de recherche et de recommandation, AI Commerce Search optimise la qualité de la recherche et des recommandations.
Pour les modèles de recherche, les attributs de variantes 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 de produits disposent d'informations complètes et précises pour les attributs clés tels que
product.categories,product.title,product.attributesetproduct.prices.
Gérer les attributs lors de l'indexation et du filtrage
Si le même attribut est défini dans Principal et Variante, 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 principales correspond à la valeur de l'attribut. Tenir compte de la 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é.
Les attributs de variantes 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 d'espace réservé, mais que ses variantes ont des couleurs réelles, la couleur de la variante doit être inséré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 queavailability: 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 de produit correspondant à la valeur de l'attribut du filtre.
Attributs de filtrage facultatifs
Veillez à ce que le champ categories soit propre et optimisé pour la taxonomie. Si vous avez besoin de filtrer davantage les résultats, implémentez le filtrage 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 comme [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 concernant le comportement des attributs
Si votre catalogue se compose de produits principaux et de variantes de produits 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 de produits 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 produit aux champs
Productintégrés (brands,colors,sizeset 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 sur l'ensemble du site : l'API est compatible avec
variantRollupKeyspour les variantes, ce qui vous permet de récupérer des informations détaillées 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. La présence de 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 façon dont les configurations d'attributs sont traitées et les configurations d'attributs que vous pouvez définir.
- 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 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 une fois que vous avez changé de mode.
Pour vérifier le mode de configuration, accédez à la page Contrôles de la console AI Commerce Search dans Gemini Enterprise for Customer Experience. Si l'option Indexable est disponible en tant que colonne dans l'onglet Commandes sur l'ensemble du site, le modèle de configuration est au niveau du catalogue. Si la colonne Indexable n'est pas disponible dans l'onglet Commandes sur l'ensemble 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 AI Commerce Search dans Gemini Enterprise for Customer Experience : définissez les configurations d'attribut au niveau du catalogue à l'aide de la console AI Commerce Search dans Gemini Enterprise for Customer Experience. Cela configure les attributs de manière 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 d'API
AttributeConfig: définissez les configurations d'attribut au niveau du catalogue à l'aide de l'API. Cela configure les attributs pour 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'APIProduct. 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 pour tous les produits à partir de la page Contrôles de la console AI Commerce Search dans Gemini Enterprise for Customer Experience, dans l'onglet Contrôles sur l'ensemble du site. Pour en savoir plus sur la façon de définir ce paramètre dans la console, consultez Gérer les contrôles des 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 indexables et inclus dans l'index de recherche prennent effet immédiatement lors de l'ingestion du 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 :
CatalogAttribute.indexableOption: définit l'option d'indexation pour un attribut.CatalogAttribute.dynamicFacetableOption: définit l'option de facettes dynamiques pour un attribut.CatalogAttribute.searchableOption: définit l'option de recherche pour un attribut.CatalogAttribute.recommendationsFilteringOption(version Preview publique) : définit l'option de filtrage des recommandations pour un attribut.
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. Cela remplace leCatalogAttributespécifié dans leAttributesConfigen mettant à jour l'attribut de catalogue avec le mêmeCatalogAttribute.key.Consultez la documentation de référence de l'API pour
ReplaceCatalogAttribute.RemoveCatalogAttribute: supprime une configuration d'attribut individuelle deAttributesConfig.Seuls les
CatalogAttributesqui ne sont pas utilisés par des produits peuvent être supprimés. Si unCatalogAttributeest utilisé,RemoveCatalogAttributene le supprime pas, mais rétablit les valeurs par défaut de ses propriétés de configuration.CatalogAttribute.inUseest défini surTruesi l'attribut est utilisé par des produits.Consultez la documentation de référence de l'API pour
RemoveCatalogAttribute.
Bonnes pratiques pour nommer et structurer les attributs personnalisés
Lorsque vous étendez vos données produit au-delà du schéma prédéfini, la façon dont vous nommez et mettez en forme vos attributs personnalisés a un impact direct sur la capacité d'AI Commerce Search à indexer, récupérer et filtrer vos produits.
Suivez ces bonnes pratiques pour optimiser les performances de la recherche et éviter les erreurs de validation :
Priorisez d'abord les attributs système natifs. Avant de créer un attribut personnalisé, vérifiez si un attribut système par défaut (tel que
brands,colorInfo,sizesoumaterials) existe déjà pour vos données. Les modèles d'IA de backend comprennent beaucoup mieux les champs par défaut que les attributs personnalisés. Ils les prennent également fortement en compte dans les optimisations de la pertinence et du rappel.- Exemple : Ne transmettez pas d'informations sur la marque en tant que
Product.attributes.brand. Mappez-le plutôt directement au champProduct.brandspar défaut. Enregistrez des attributs personnalisés pour les données très spécifiques, commeProduct.attributes.sleeve_length.
- Exemple : Ne transmettez pas d'informations sur la marque en tant que
Respectez des conventions d'attribution de noms strictes pour l'indexabilité. Si vous prévoyez d'utiliser un attribut personnalisé pour le filtrage, la navigation à facettes ou l'amplification, il doit être marqué comme
Indexable. Pour être indexable, la clé de votre attribut personnalisé doit respecter le modèle d'expression régulière[a-zA-Z0-9][a-zA-Z0-9_]*.- Nommage valide :
sleeve_lengthouKEY_1_LIKE_THIS. - Nommage non valide :
sleeve-length(les traits d'union ne sont pas autorisés et empêcheront l'indexation). - Limites : la clé d'attribut doit être une chaîne encodée au format UTF-8 d'une longueur maximale de 128 caractères. Un produit ne peut pas contenir plus de 200 attributs personnalisés.
- Nommage valide :
Définissez des types de valeurs clairs (texte ou nombres). AI Commerce Search exige que les valeurs des attributs personnalisés soient définies comme textuelles (
text) ou numériques (numbers). Vous devez définir exactement l'un de ces types pour une clé donnée. Si vous tentez de renseigner à la foistextetnumberspour le même attribut, une erreurINVALID_ARGUMENTs'affichera.- Attributs textuels : jusqu'à 400 valeurs autorisées par attribut. Les chaînes vides (
"") ne sont pas autorisées. Chaque valeur doit être une chaîne UTF-8 non vide d'une longueur maximale de 256 caractères. - Attributs numériques : jusqu'à 400 valeurs autorisées par attribut.
- Remarque sur le facettage : si vous souhaitez utiliser un attribut numérique comme
dynamicFacet, vous devez caster le type de données numériques en chaîneTextdans votre pipeline de données avant l'ingestion (par exemple, en transmettant10.99comme"10.99"). Sinon, les attributs numériques ne peuvent être utilisés que comme facettes statiques, où vous devez définir manuellement et explicitement les buckets d'intervalle dans la requête de recherche.
- Attributs textuels : jusqu'à 400 valeurs autorisées par attribut. Les chaînes vides (
Utilisez les mots clés exacts de manière stratégique. La configuration "Recherche exacte" est conçue pour les chaînes alphanumériques très spécifiques qui n'ont pas de signification linguistique, comme
model_name(par exemple,"WA2300AH3000") oupart_number.- Exemple : N'appliquez pas la correspondance exacte aux attributs personnalisés contenant des noms communs anglais ou des marques populaires. Cela limite les résultats de recherche lorsque ces mots courants apparaissent dans une requête de recherche, ce qui entraîne un faible rappel de produits et un impact négatif sur les taux de clics (CTR).