Cette page présente certaines des fonctionnalités de facettes et comment les utiliser.
Définitions liées aux attributs
Cette section fournit quelques définitions et explications de base pour certains termes liés aux facettes:
Facets (Attributs) : spécifications d'attribut permettant d'effectuer une recherche par attributs. Elles aident les utilisateurs à trouver ce qu'ils veulent en filtrant les résultats. Par exemple, si un utilisateur recherche
shoes
, certains attributs pouvant être renvoyés sontprice
,attributes.department
,attributes.colors
etattributes.size
.Attributs système: les attributs système prédéfinis sont des champs de produit existants qui fournissent plus d'informations sur le produit. Ceux-ci incluent quelques attributs de produit prédéfinis, tels que
brand
,availability
,color
etsize
.Attributs personnalisés: les attributs personnalisés sont des attributs supplémentaires que vous définissez dans le champ Product.attributes. Par exemple, il peut s'agir de
style
,color
oudepartment
.Facet key (Clé d'attribut) : nom d'un attribut. Par exemple, il peut s'agir de
attributes.department
ousizes
. Les clés d'attribut correspondent aux noms d'attributs. Par exemple, le nom d'attribut du système (produit)sizes
correspond à la clé d'attributsizes
. De même, le nom d'attribut personnalisé (produit)department
correspond à la clé d'attributattributes.department
(pour les attributs personnalisés, le préfixeattributes.
est ajouté au nom de l'attribut personnalisé pour obtenir la clé d'attribut). Les termes nom d'attribut, clé d'attribut et nom d'attribut sont interchangeables.Valeur de l'attribut: pour les clés textuelles, il s'agit de l'une des valeurs textuelles d'un attribut. Par exemple, la clé d'attribut textuel
brands
peut avoir des valeurs textuelles telles queAsics
etNike
. Pour les clés numériques, une valeur d'attribut est un intervalle. Par exemple, le prix de la clé de l'attribut numérique peut avoir un intervalle de la forme [20, 30).Type d'attribut ou d'attribut: ils peuvent être textuels ou numériques.
Attributs épinglés: il s'agit d'un attribut que vous transmettez dans la requête à l'aide de FacetSpec avec l'option enableDynamicPosition
=false
. Les attributs doivent apparaître dans leur ordre d'origine avant tous les attributs dynamiques de la réponse.Attributs dynamiques: il s'agit des attributs qui interviennent dans le classement des recherches. Elles sont transmises dans la requête avec l'option
enableDynamicPosition
=true
ou récupérées en fonction des modèles de recherche. Ils sont ensuite classés en fonction des mêmes modèles entraînés, les plus pertinents apparaissant en premier.Ajout d'attributs dynamique ou d'attributs dynamiques : lorsqu'un attribut est activé pour les attributs dynamiques, la recherche peut automatiquement l'utiliser comme attribut dynamique en fonction du comportement antérieur de l'utilisateur, comme les clics et les vues d'attribut. Pour activer les attributs dynamiques pour un attribut, vous devez également activer l'indexation pour cet attribut.
Filtre: la syntaxe de filter consiste en un langage d'expression permettant de construire un prédicat à partir d'un ou de plusieurs champs des produits filtrés. Par exemple, si un utilisateur interagit avec les valeurs d'attribut
Asics
de la clé d'attributattributes.brands
, une partie du filtre peut être(attributes.brands:ANY(\"Asics",\"Nike\"))
. L'expression du filtre est sensible à la casse. Pour en savoir plus sur le filtre, consultez ce guide de l'utilisateur.
À propos des attributs dynamiques
Lorsque les attributs dynamiques sont activés pour une configuration de diffusion, la recherche peut automatiquement les utiliser en tant qu'attributs dynamiques dans les résultats de recherche pour cette configuration, en fonction du comportement antérieur des utilisateurs, tels que les clics et les vues d'attributs.
Les attributs dynamiques ne sont pas efficaces pour la configuration de diffusion si les attributs dynamiques ne sont pas activés. Les attributs dynamiques sont transmis dans la requête avec l'option enableDynamicPosition
=true
ou extraits en fonction des modèles de recherche. Elles sont ensuite classées en fonction des mêmes modèles, les plus pertinents apparaissant en premier.
Par défaut, la plupart des clés d'attribut peuvent être ajoutées par facettes. Les paramètres d'attributs dynamiques de l'API peuvent être remplacés pour certaines clés d'attribut spécifiques de votre choix grâce aux commandes d'attributs à l'échelle du site dans la console Search for Retail. En d'autres termes, si vous souhaitez que certaines clés d'attribut ne puissent pas être attributées, vous devez désactiver les attributs dynamiques pour chacune de ces clés dans l'onglet Attribute
controls
. Pour en savoir plus, consultez Gérer les contrôles des attributs sur l'ensemble du site. Notez que les attributs dynamiques peuvent être créés
uniquement sur la base de données précises du catalogue de produits. Toutefois, pour que cette fonctionnalité fonctionne de manière optimale pour votre site, les modèles d'attributs doivent apprendre de l'activité sur votre site. Pour ce faire, vous devez définir précisément les champs de requête, de catégorie et de filtre dans vos importations d'événements de recherche.
Si les attributs dynamiques ne sont activés dans aucune de vos configurations de diffusion et que vous venez de les activer dans une configuration de diffusion, vous devez attendre trois à quatre jours avant qu'ils ne fonctionnent.
Contrôles d'attributs
Cette section fournit des instructions pour créer différents types de contrôles d'attributs:
- Commandes pour ignorer les valeurs d'attribut
- Commandes de remplacement des valeurs d'attribut
- Commandes d'attributs de fusion
- Définir des contrôles d'intervalles numériques
- Supprimer les contrôles d'attributs
- Forcer le contrôle des attributs de retour
- Reclasser le contrôle des attributs dynamiques
Sauf indication contraire, Vertex AI Search pour le commerce effectue une mise en correspondance sensible à la casse pour tous ces contrôles d'attributs.
Créer une commande "Ignorer les valeurs d'attribut"
Créez une commande "Ignorer les valeurs d'attribut" lorsque vous souhaitez supprimer des valeurs d'attribut indésirables pour certaines clés d'attribut spécifiques.
Cette commande est utile pour effacer des valeurs d'attributs indésirables telles que NA
et Not_applicable
. Toutefois, vous pouvez également l'utiliser pour effacer des tendances saisonnières, comme Easter
si vous êtes en octobre.
Pour créer une commande qui ignore les valeurs d'attribut:
Accédez à la page "Commandes" de la console Search for Retail.
Dans l'onglet Contrôles d'attributs, cliquez sur add_boxCréer une commande.
Le volet Créer une commande s'ouvre.
Sélectionnez Ignorer les valeurs d'attribut.
Indiquez le nom de l'attribut.
Par exemple,
brands
pour un attribut système. Le nom d'un attribut personnalisé commence parattributes.
(par exemple,attributes.department
etattributes.colors
).(Facultatif) Indiquez l'heure de début et/ou l'heure de fin.
Sélectionnez Ignorer les valeurs pour une ou plusieurs valeurs d'attribut.
Exemples :
NA
,Not_applicable
etEaster
.Cliquez sur Envoyer.
Créer une commande de remplacement des valeurs d'attribut
Créez une commande de remplacement des valeurs d'attribut lorsque vous souhaitez regrouper un certain nombre de valeurs d'attribut similaires en un seul terme.
Le remplacement des valeurs d'attribut est parfois appelé fusion des valeurs d'attribut.
Pour éviter les conflits et les mises en correspondance inutiles, si une valeur d'attribut facet_value_1
est remplacée par une autre valeur d'attribut facet_value_2
, cette dernière ne peut pas être remplacée par une autre valeur d'attribut. Par exemple, si vous remplacez ruby
par dark red
, vous ne pourrez pas remplacer dark red
par red
par la suite.
Une valeur d'attribut ne doit pas apparaître plus d'une fois dans le champ Replace values (Remplacer des valeurs) pour chaque nom d'attribut.
Pour créer une commande qui remplace les valeurs d'attribut:
Accédez à la page "Commandes" de la console Search for Retail.
Dans l'onglet Contrôles d'attributs, cliquez sur add_boxCréer une commande.
Le volet Créer une commande s'ouvre.
Sélectionnez Remplacer les valeurs d'attribut.
Indiquez le nom de l'attribut.
Cette fonctionnalité ne fonctionne que pour les attributs personnalisés, qui commencent par le préfixe
attributes.
(par exemple,attributes.department
etattributes.colors
).Spécifiez une ou plusieurs valeurs d'attribut dans Remplacer des valeurs.
Exemples :
RED
,Red
,dark red
,bright red
,ruby
etcrimson
.Une valeur d'attribut ne peut apparaître qu'une seule fois dans le champ Remplacer des valeurs.
Spécifiez une seule valeur d'attribut comme Terme de remplacement (par exemple,
red
).Cliquez sur Envoyer.
Bien que les valeurs remplacées puissent disparaître rapidement, il peut s'écouler jusqu'à quatre jours avant que les termes de remplacement n'apparaissent.
Lorsque la commande de remplacement des valeurs d'attribut prend effet, si la clé d'attribut (dans cet exemple, attributes.colors
) est renvoyée dans la réponse, les valeurs d'attribut remplacées (telles que dark red
et crimson
) ne seront pas présentes en tant que valeurs d'attribut. Elles sont remplacées par leurs conditions de remplacement (par exemple, red
).
Créer un contrôle des attributs de fusion
Il est préférable de définir correctement les noms et les valeurs d'attribut personnalisé du produit de votre côté avant que les produits ne soient ingérés dans la base de données de la recherche. Toutefois, si vous ne pouvez pas modifier les noms des attributs personnalisés, vous pouvez créer des contrôles d'attributs de fusion. Vous créez un contrôle d'attributs de fusion si vous souhaitez fusionner (remplacer) un attribut par un autre. Par exemple, vous pouvez avoir plusieurs clés d'attribut personnalisées pour des couleurs telles que attributes.colors_jeans
, attributes.colors_clothes
et attributes.colors_hue
, que vous souhaitez remplacer par une clé d'attribut personnalisée existante appelée attributes.colors
.
Pour créer une commande ayant fusionné un attribut avec un autre:
Accédez à la page "Commandes" de la console Search for Retail.
Dans l'onglet Contrôles d'attributs, cliquez sur add_boxCréer une commande.
Le volet Créer une commande s'ouvre.
Sélectionnez Fusionner les attributs.
Spécifiez une clé d'attribut personnalisée valide qui fusionne avec une autre.
Cette fonctionnalité ne fonctionne que pour les attributs personnalisés, qui commencent par le préfixe
attributes.
(par exemple,attributes.colors_clothes
etattributes.colors_jeans
).Spécifiez une clé d'attribut personnalisée valide en tant que clé fusionnée.
Cliquez sur Envoyer.
Ce contrôle prend généralement deux à quatre jours.
Créer une commande d'intervalles numériques définie
La commande d'intervalles numériques définis vous permet de déterminer les intervalles pour un attribut numérique au lieu de devoir accepter des intervalles calculés.
Par exemple, la recherche peut calculer les intervalles [10,15), [15,20) [20,25), [25,30), [30,40) et [40,50) et [50,infini) pour la clé d'attribut numérique personnalisée attributes.monitor_size
. Toutefois, vous pouvez préférer les intervalles [0,14), [14,17), [17,21), [21,24), [24,27), [27,32) et [32,infini).
À propos des intervalles calculés et définir des intervalles
Pour tous les attributs numériques personnalisés et les attributs système numériques price
, rating
et ratingCount
, la recherche calcule des intervalles avec des limites arrondies en fonction de la distribution de toutes les valeurs d'attribut (numériques) de chacun de ces attributs. Vous pouvez également spécifier des intervalles dans la requête. Enfin, vous pouvez définir vos propres intervalles pour chaque clé d'attribut numérique à l'aide des commandes de définition d'intervalles numériques suivantes.
Voici l'ordre de priorité qui détermine les intervalles utilisés:
Tout d'abord, si des intervalles sont spécifiés dans la requête de clé d'attribut numérique, ils sont conservés.
Sinon, si une clé d'attribut numérique est dynamique ou transmise dans la requête sans intervalles, les intervalles que vous incluez à l'aide des commandes de définition d'intervalles numériques sont ajoutés à cette clé d'attribut numérique si ces intervalles ne sont pas vides.
Sinon, les intervalles calculés mentionnés précédemment avec des limites arrondies sont ajoutés.
Créer la commande
Si vous souhaitez spécifier vos propres intervalles pour les clés d'attributs numériques au lieu d'utiliser ceux que Vertex AI Search calcule pour vous, créez un ensemble de contrôles d'intervalles numériques.
Pour créer une commande permettant d'ajouter des intervalles:
Accédez à la page "Commandes" de la console Search for Retail.
Dans l'onglet Contrôles d'attributs, cliquez sur add_boxCréer une commande.
Le volet Créer une commande s'ouvre.
Sélectionnez Définir des intervalles numériques.
Indiquez le nom d'un attribut numérique.
Par exemple,
price
pour un attribut système. Pour un attribut personnalisé, le nom commence parattributes.
(par exemple,attributes.number_of_pieces
).Indiquez au moins une valeur parmi Minimum ou Maximum. Si les deux noms sont spécifiés, la valeur minimale ne peut pas être supérieure à la valeur maximale. Vous pouvez définir chaque limite sur Inclusive ou Exclusif.
Pour ajouter d'autres intervalles, cliquez sur + Ajouter des intervalles. Le nombre maximal d'intervalles est de 40.
Cliquez sur Envoyer.
Créer une commande de suppression d'attributs
La commande de suppression d'attributs vous permet de supprimer une clé d'attribut spécifique des attributs dynamiques. Les clés d'attribut sont supprimées en fonction de certains termes de requête ou catégories de pages.
Cette commande est utile si vous souhaitez supprimer des clés d'attribut pour certains termes de requête ou certaines navigations. Par exemple, vous pouvez utiliser cette commande pour supprimer la clé d'attribut attributes.shoe_size
pour la requête "chaussures".
Pour créer une commande de suppression de l'attribut:
Accédez à la page "Commandes" de la console Search for Retail.
Dans l'onglet Contrôles d'attributs, cliquez sur add_boxCréer une commande.
Le volet Créer une commande s'ouvre.
Sélectionnez Supprimer les attributs.
Chaque commande concerne la recherche ou la navigation, mais elle ne peut pas s'appliquer aux deux. Effectuez l'une des opérations suivantes :
Pour les requêtes de recherche, cliquez sur Rechercher et spécifiez des termes de requête partiels ou exacts à mettre en correspondance. Consultez les informations détaillées dans les conditions et les conditions. Dans les deux cas, les termes de requête doivent être en minuscules. Par exemple, vous pouvez spécifier les termes de requête partiels
shirts
,polo
,jackets
,t-shirt
etfall coats
. Les clés d'attribut spécifiées ensuite n'apparaîtront pas en tant qu'attribut dynamique si la requête en minuscules est l'un de ces termes de requête ou contient l'un de ces termes sous forme d'unigramme.Pour parcourir les pages, cliquez sur Parcourir les catégories et spécifiez des catégories de pages. Vous pouvez spécifier une liste (jusqu'à 10 entrées) de catégories ou de services. Le format doit être identique à celui des catégories de page de l'événement utilisateur. Par exemple, il peut s'agir de
page_categories
:Sales > 2023 Black Friday Deals
. S'il existe une correspondance exacte (sensible à la casse) entre cette dernière et l'une des catégories de pages transmises dans l'événement (pour la navigation), les clés d'attribut spécifiées ensuite n'apparaîtront pas en tant qu'attribut dynamique.
Spécifiez au moins une clé d'attribut valide dans Attributs à ignorer.
Cliquez sur Envoyer.
Créer un contrôle des attributs de retour forcé
La commande d'attributs de retour de force peut affecter la position dans la liste d'une clé d'attribut dynamique pour une requête ou un événement de navigation spécifique.
Cette commande est utile si vous souhaitez forcer une clé d'attribut spécifique parmi les attributs dynamiques pour certains termes de requête ou certaines navigations. Par exemple, vous pouvez utiliser cette commande pour forcer la clé d'attribut brands
à apparaître à la 10e position ou à une position inférieure pour la requête handbags
. Si l'attribut brands
figure déjà dans le top 10 des attributs dynamiques de cette requête, il ne devrait pas beaucoup bouger. S'il ne figure pas dans le top 10 ou s'il ne figure pas dans la liste des attributs dynamiques, il doit passer à la position 10 approximativement.
Pour créer une commande pour l'attribut de retour forcé:
Accédez à la page "Commandes" de la console Search for Retail.
Dans l'onglet Contrôles d'attributs, cliquez sur add_boxCréer une commande.
Le volet Créer une commande s'ouvre.
Sélectionnez Forcer les attributs de retour.
Chaque commande concerne la recherche ou la navigation, mais elle ne peut pas s'appliquer aux deux. Effectuez l'une des opérations suivantes :
Pour les requêtes de recherche, cliquez sur Rechercher et spécifiez des termes de requête partiels ou exacts à mettre en correspondance. Consultez les informations détaillées dans les conditions et les conditions. Dans les deux cas, les termes de requête doivent être en minuscules. Par exemple, vous pouvez spécifier les termes de requête partiels
shirts
,polo
,jackets
,t-shirt
etfall coats
. Les clés d'attribut spécifiées ensuite doivent apparaître autour de leur position respective ou au-dessus dans les attributs dynamiques si la requête en minuscules est l'un de ces termes de requête ou contient l'un de ces termes de requête sous forme d'unigramme.Pour parcourir les pages, cliquez sur Parcourir les catégories et spécifiez des catégories de pages. Vous pouvez spécifier une liste (jusqu'à 10 entrées) de catégories ou de services. Le format doit être identique à celui des catégories de page de l'événement utilisateur. Par exemple, il peut s'agir de
page_categories
:Sales > 2023 Black Friday Deals
. En cas de correspondance exacte (sensible à la casse) entre cette dernière et l'une des catégories de pages transmises dans l'événement (pour la navigation), les clés d'attribut spécifiées ensuite doivent apparaître autour de leur position respective ou au-dessus parmi les attributs dynamiques.
Spécifiez une clé d'attribut valide et une position entière comprise entre 1 et 100 (inclus).
Si vous souhaitez spécifier plusieurs clés d'attribut, cliquez sur +Ajouter un ajustement et recommencez l'étape précédente.
Cliquez sur Envoyer.
Créer une commande d'attributs dynamiques de reclassement
Le classement dynamique des attributs dépend de la requête (recherche) ou des catégories de page (navigation). La commande d'attributs dynamiques de reclassement permet également au classement de dépendre de certaines valeurs d'attribut engagées par l'utilisateur.
Par exemple, si l'utilisateur interagit avec la valeur d'attribut watches
de la clé d'attribut attributes.department
après une recherche ou une navigation, le classement dépendra également de la valeur d'attribut watches
. Vous pouvez spécifier les valeurs d'attribut que vous souhaitez reclasser par clé d'attribut, ou spécifier uniquement la clé d'attribut et le reclasser sur toutes ses valeurs d'attribut.
Pour créer une commande pour les attributs dynamiques de reclassement:
Accédez à la page "Commandes" de la console Search for Retail.
Dans l'onglet Contrôles d'attributs, cliquez sur add_boxCréer une commande.
Le volet Créer une commande s'ouvre.
Sélectionnez Reclasser les attributs dynamiques.
Spécifiez une clé d'attribut textuelle personnalisée valide (toutes les clés personnalisées portent le préfixe
attributes.
).Vous pouvez spécifier des valeurs d'attribut spécifiques ou les appliquer à tous.
Si vous souhaitez reclasser toutes ses valeurs d'attribut, cliquez sur add_boxToute modification de valeur.
Si vous souhaitez reclasser des valeurs d'attribut spécifiques, cliquez sur add_boxModifications des valeurs sélectionnées. Insérez ensuite toutes les valeurs d'attribut que vous souhaitez reclasser (sensible à la casse). Par exemple, il peut s'agir de
watches
,luggages
oubed
.
Cliquez sur Envoyer.
Vous devez transmettre toutes les clés d'attribut engagées par l'utilisateur dans la requête pour la raison suivante. Supposons qu'un utilisateur recherche des ventes. L'utilisateur obtient une première liste de clés d'attribut. Ensuite, l'utilisateur interagit d'abord avec la clé d'attribut attributes.age_group
. Ensuite, ils engagent la clé d'attribut attributes.department
avec les valeurs d'attribut watches
, pour lesquelles vous avez configuré une commande de reclassement. La recherche reclasse alors les clés. Il est donc possible que la clé d'attribut précédemment engagée attributes.age_group
ne soit pas renvoyée dans la réponse. Si vous transmettez cette clé dans la requête (à l'aide d'un Facetspec avec enableDynamicPosition
défini sur true
), elle sera automatiquement renvoyée dans la réponse. Toutefois, la recherche peut renvoyer cette clé à la position 27, et vous pouvez n'afficher que les 20 premières clés à l'utilisateur. De ce fait, de votre côté, vous devez vous assurer que ces clés précédemment engagées par l'utilisateur sont présentées à l'utilisateur (vous devrez peut-être filtrer certaines clés intermédiaires non utilisées dans la réponse si vous ne souhaitez pas présenter trop de clés à l'utilisateur).