Attributs pour la recherche

Cette page présente certaines des fonctionnalités de facettes et comment les utiliser.

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 sont price, attributes.department, attributes.colors et attributes.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 et size.

  • 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 ou department.

  • Facet key (Clé d'attribut) : nom d'un attribut. Par exemple, il peut s'agir de attributes.department ou sizes. 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'attribut sizes. De même, le nom d'attribut personnalisé (produit) department correspond à la clé d'attribut attributes.department (pour les attributs personnalisés, le préfixe attributes. 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 que Asics et Nike. 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'attribut attributes.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:

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:

  1. Accédez à la page "Commandes" de la console Search for Retail.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles d'attributs, cliquez sur Créer une commande.

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Ignorer les valeurs d'attribut.

  4. Indiquez le nom de l'attribut.

    Par exemple, brands pour un attribut système. Le nom d'un attribut personnalisé commence par attributes. (par exemple, attributes.department et attributes.colors).

  5. (Facultatif) Indiquez l'heure de début et/ou l'heure de fin.

  6. Sélectionnez Ignorer les valeurs pour une ou plusieurs valeurs d'attribut.

    Exemples : NA, Not_applicable et Easter.

  7. 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:

  1. Accédez à la page "Commandes" de la console Search for Retail.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles d'attributs, cliquez sur Créer une commande.

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Remplacer les valeurs d'attribut.

  4. 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 et attributes.colors).

  5. Spécifiez une ou plusieurs valeurs d'attribut dans Remplacer des valeurs.

    Exemples : RED, Red, dark red, bright red, ruby et crimson.

    Une valeur d'attribut ne peut apparaître qu'une seule fois dans le champ Remplacer des valeurs.

  6. Spécifiez une seule valeur d'attribut comme Terme de remplacement (par exemple, red).

  7. 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:

  1. Accédez à la page "Commandes" de la console Search for Retail.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles d'attributs, cliquez sur Créer une commande.

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Fusionner les attributs.

  4. 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 et attributes.colors_jeans).

  5. Spécifiez une clé d'attribut personnalisée valide en tant que clé fusionnée.

  6. 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:

  1. Accédez à la page "Commandes" de la console Search for Retail.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles d'attributs, cliquez sur Créer une commande.

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Définir des intervalles numériques.

  4. Indiquez le nom d'un attribut numérique.

    Par exemple, price pour un attribut système. Pour un attribut personnalisé, le nom commence par attributes. (par exemple, attributes.number_of_pieces).

  5. 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.

  6. Pour ajouter d'autres intervalles, cliquez sur + Ajouter des intervalles. Le nombre maximal d'intervalles est de 40.

  7. 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:

  1. Accédez à la page "Commandes" de la console Search for Retail.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles d'attributs, cliquez sur Créer une commande.

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Supprimer les attributs.

  4. 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 et fall 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.

  5. Spécifiez au moins une clé d'attribut valide dans Attributs à ignorer.

  6. 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é:

  1. Accédez à la page "Commandes" de la console Search for Retail.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles d'attributs, cliquez sur Créer une commande.

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Forcer les attributs de retour.

  4. 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 et fall 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.

  5. Spécifiez une clé d'attribut valide et une position entière comprise entre 1 et 100 (inclus).

  6. Si vous souhaitez spécifier plusieurs clés d'attribut, cliquez sur +Ajouter un ajustement et recommencez l'étape précédente.

  7. 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:

  1. Accédez à la page "Commandes" de la console Search for Retail.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles d'attributs, cliquez sur Créer une commande.

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Reclasser les attributs dynamiques.

  4. Spécifiez une clé d'attribut textuelle personnalisée valide (toutes les clés personnalisées portent le préfixe attributes.).

  5. 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 Toute modification de valeur.

    • Si vous souhaitez reclasser des valeurs d'attribut spécifiques, cliquez sur Modifications 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 ou bed.

  6. 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).