Attributs pour la recherche

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

Cette section fournit des définitions de base et des explications sur certains termes liés aux facettes:

  • Attributs: spécifications des attributs pour effectuer une recherche par attributs. Ils aident les utilisateurs à trouver ce qu'ils recherchent en filtrant les résultats. Par exemple, si un utilisateur recherche shoes, les facettes suivantes peuvent être renvoyées: 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. Cela inclut 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 à l'aide du champ Product.attributes. Par exemple, il peut s'agir de style, color ou department.

  • Clé d'attribut: nom d'un attribut. Par exemple, il peut s'agir de attributes.department ou de sizes. Les clés de facette correspondent aux noms des attributs. Par exemple, le nom de l'attribut système (produit) sizes correspond à la clé de facette sizes. De même, le nom de l'attribut personnalisé (produit) department correspond à la clé de facette attributes.department (pour les attributs personnalisés, le préfixe attributes. est ajouté au nom de l'attribut personnalisé pour obtenir la clé de facette). Les termes "nom de l'attribut", "clé de facette" et "nom de la facette" sont interchangeables.

  • Valeur de facette: pour les clés textuelles, il s'agit de l'une des valeurs textuelles d'une facette. Par exemple, la clé de facette textuelle brands peut avoir des valeurs textuelles telles que Asics et Nike. Pour les clés numériques, une valeur de facette est un intervalle. Par exemple, la clé de facette numérique "prix" peut avoir un intervalle au format [20, 30).

  • Type d'attribut ou de facette: il peut s'agir de texte ou de valeurs numériques.

  • Facettes épinglées: facette que vous transmettez dans la requête à l'aide de FacetSpec avec l'option enableDynamicPosition=false. Les facettes doivent apparaître dans leur ordre d'origine avant toutes les facettes dynamiques dans la réponse.

  • Attributs dynamiques: attributs que le moteur de recherche classe à part. Ils sont transmis dans la requête avec l'option enableDynamicPosition=true ou récupérés en fonction des modèles de recherche. Ils sont ensuite classés par les mêmes modèles entraînés, les plus pertinents étant en haut de la liste.

  • Attribut dynamique, attribut dynamique ou attribut pouvant être utilisé en tant que vignette : lorsque l'attribut est activé pour les attributs dynamiques, la recherche peut l'utiliser automatiquement en tant qu'attribut dynamique en fonction du comportement passé des utilisateurs (clics et vues associés à l'attribut, par exemple). Pour activer l'attribut dynamique pour un attribut, vous devez également activer l'indexation pour cet attribut.

  • Filtre: la syntaxe du filtre 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 de facette Asics de la clé de facette attributes.brands, une partie du filtre peut être (attributes.brands:ANY(\"Asics",\"Nike\")). L'expression de filtre est sensible à la casse. Pour en savoir plus sur ce filtre, consultez ce guide de l'utilisateur.

À propos des attributs et des vignettes dynamiques

Lorsque les attributs dynamiques sont activés pour une configuration de diffusion, la recherche peut utiliser automatiquement des attributs en tant qu'attributs dynamiques et cartes dans les résultats de recherche pour cette configuration, en fonction du comportement passé de l'utilisateur (clics et vues associés à un attribut par exemple). Les facettes dynamiques sont transmises dans la requête avec l'option enableDynamicPosition=true ou extraites en fonction des modèles de recherche. Ils sont ensuite classés par les mêmes modèles, les plus pertinents étant en haut.

Par défaut, la plupart des clés de facette sont facettables. Les paramètres d'attributs dynamiques dans l'API peuvent être remplacés pour certaines clés de facette spécifiques de votre choix par des contrôles d'attributs à l'échelle du site dans la console Retail Search. En d'autres termes, si vous ne souhaitez pas que certaines clés de facette soient facettables, vous devez désactiver la facettation dynamique pour chacune de ces clés dans l'onglet Attribute controls. Pour en savoir plus, consultez la section Gérer les contrôles d'attributs à l'échelle du site.

Notez que les facettes et les cartes dynamiques peuvent être créées en utilisant exclusivement des données de catalogue de produits précises. Cependant, afin d'optimiser la fonctionnalité pour votre site, les modèles d'attributs doivent pouvoir apprendre de l'activité sur votre site. Pour cela, 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 aucune de vos configurations de diffusion n'a activé les cartes et les facettes dynamiques, et que vous venez de les activer dans une configuration de diffusion, attendez trois à quatre jours avant qu'elles ne fonctionnent.

Contrôles d'attributs

Cette section explique comment créer différents types de commandes de facettes, dont beaucoup régissent également le comportement des tuiles:

Vertex AI Search pour le commerce effectue une mise en correspondance sensible à la casse pour toutes ces commandes de facettes, sauf indication contraire.

Pour contrôler les valeurs d'attribut et le comportement des cartes spécifiques, accédez à l'onglet Commandes des attributs dans la console de la recherche pour le commerce.

Accéder à la page "Contrôles"

Cliquez sur Créer un contrôle pour modifier les attributs renvoyés par la recherche. Le volet Créer un contrôle s'ouvre. Cliquez sur le champ Type de commande pour ouvrir un menu déroulant dans lequel vous pouvez sélectionner le type de commande. Chacune d'elles ouvre une boîte de dialogue contenant des options permettant de contrôler vos facettes. Tous les types de commandes de facettes nécessitent au moins les informations sur l'attribut, mais chaque formulaire nécessite des informations légèrement différentes.

Texte alternatif

Créer une commande "Ignorer les valeurs d'attribut et de vignette"

Créez une commande d'ignorer les valeurs d'attribut et de vignette lorsque vous souhaitez supprimer certaines valeurs d'attribut et de vignette indésirables pour certaines clés d'attribut et de vignette spécifiques.

Ce contrôle est utile pour effacer les valeurs d'attribut et de vignette indésirables, comme NA et Not_applicable. Mais vous pouvez également l'utiliser pour effacer les tendances saisonnières, comme Easter en octobre.

Pour créer une commande qui ignore les valeurs d'attribut et de vignette:

  1. Accédez à la page "Contrôles" dans la console de la recherche pour les marchands.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles des facettes, cliquez sur Créer un contrôle.

    Le volet Créer un contrôle s'ouvre.

  3. Sélectionnez Ignorer les valeurs d'attribut et de vignette.

  4. Spécifiez le nom de l'attribut.

    Par exemple, brands pour un attribut système. Pour un attribut personnalisé, le nom 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. Spécifiez une ou plusieurs valeurs d'attribut comme Valeurs à ignorer.

    Par exemple, NA, Not_applicable et Easter.

  7. Cliquez sur Envoyer.

Créer une commande "Remplacer les valeurs d'attribut et de vignette"

Créez une commande de remplacement des valeurs d'attribut et de vignette lorsque vous souhaitez regrouper un certain nombre de valeurs d'attribut et de vignette similaires en un seul terme.

Le remplacement des valeurs d'attribut et de vignette est parfois appelé fusion des valeurs d'attribut et de vignette.

Pour éviter les conflits et les mappages 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 pouvez pas ensuite remplacer dark red par red.

Pour chaque nom d'attribut, une valeur d'attribut ne doit pas apparaître plus d'une fois dans le champ Remplacer les valeurs.

Pour créer une commande qui remplace l'attribut et les valeurs:

  1. Accédez à la page "Contrôles" dans la console de la recherche pour les marchands.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles des facettes, cliquez sur Créer un contrôle.

    Le volet Créer un contrôle s'ouvre.

  3. Sélectionnez Remplacer les valeurs d'attribut et de vignette.

  4. Spécifiez 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 en tant que Valeurs de remplacement (par exemple, 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 les 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, l'affichage des termes de remplacement peut prendre jusqu'à quatre jours.

Lorsque le contrôle de remplacement des valeurs d'attribut prend effet, si la clé d'attribut (attributes.colors dans cet exemple) est renvoyée dans la réponse, les valeurs d'attribut remplacées (telles que dark red et crimson) ne sont pas présentes en tant que valeurs d'attribut. Elles sont remplacées par leurs conditions de remplacement (par exemple, red).

Créer un paramètre de fusion des facettes

Il est préférable de définir correctement les noms et les valeurs des attributs personnalisés des produits 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 commandes de fusion de facettes. Vous créez un contrôle de fusion de facettes si vous souhaitez fusionner (remplacer) une facette par une autre. Par exemple, vous pouvez avoir plusieurs clés de facette personnalisées pour des couleurs telles que attributes.colors_jeans, attributes.colors_clothes et attributes.colors_hue, et vous souhaitez les remplacer par une clé de facette personnalisée existante appelée attributes.colors.

Les clés fusionnées doivent idéalement être:

  • Noms d'attributs personnalisés qui sont permanents et ne changent pas de type.
  • Noms d'attributs de nombreux produits ingérés.

Si vous supprimez une clé fusionnée, vous perdez ses données d'engagement, qui sont utilisées pour entraîner des modèles de facettes dynamiques.

Lors de l'indexation de chaque produit, les clés et les clés fusionnées sont incluses en tant que noms d'attributs, sauf si vous dépassez le nombre maximal d'attributs autorisés par produit. Si le nombre maximal d'attributs dépasse le quota autorisé par produit, la recherche tronque de manière arbitraire les clés fusionnées qui deviennent des noms d'attributs.

Par exemple, si vous avez déjà atteint le nombre maximal de noms d'attributs personnalisés pour un produit spécifique et que l'un de ses noms d'attributs personnalisés est colors_jeans, supposons que vous utilisiez un contrôle de fusion de facettes pour fusionner attributes.colors_jeans dans attributes.colors. Dans ce cas, le nom de l'attribut colors ne sera pas ajouté à ce produit spécifique, car il contient déjà le nombre maximal de clés personnalisées par produit. Les clés fusionnées ne seront pas supprimées des noms d'attributs (personnalisés) des produits, mais elles ne seront pas renvoyées en tant que clés de facettes dynamiques non plus. De même, si vous fusionnez plusieurs clés avec la même clé et que le nombre de valeurs d'attribut pour la clé fusionnée dépasse la limite de valeurs d'attribut autorisées, la recherche tronque de manière arbitraire les valeurs d'attribut.

Pour créer un contrôle qui fusionne une facette avec une autre:

  1. Accédez à la page "Contrôles" dans la console de la recherche pour les marchands.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles des facettes, cliquez sur Créer un contrôle.

    Le volet Créer un contrôle s'ouvre.

  3. Sélectionnez Fusionner les attributs.

  4. Spécifiez une clé de facette personnalisée valide qui se 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é de facette personnalisée valide comme clé fusionnée.

  6. Cliquez sur Envoyer.

Ce paramètre prend généralement effet dans un délai de deux à quatre jours.

Créer un contrôle d'intervalles numériques définis

La commande "Définir des intervalles numériques" vous permet de déterminer les intervalles d'un attribut ou d'une carte numériques au lieu d'accepter des intervalles calculés.

Par exemple, la recherche peut calculer les intervalles [10,15), [15,20), [20,25), [25,30), [30,40], [40,50] et [50,infini) pour la clé de facette numérique personnalisée attributes.monitor_size. Toutefois, vous préférerez peut-être les intervalles [0,14), [14,17), [17,21), [21,24), [24,27), [27,32) et [32,infini).

À propos des intervalles calculés et des intervalles définis

Pour tous les attributs personnalisés numériques et les attributs système numériques price, rating et ratingCount, la recherche calcule certains intervalles avec des limites arrondies en fonction de la distribution de toutes les valeurs d'attribut (numériques) pour 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é de facette numérique à l'aide des commandes Définir des 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 pour une clé de facette numérique, ces intervalles sont conservés.

  • Sinon, si une clé de facette numérique est dynamique ou transmise dans la requête sans intervalles, les intervalles que vous incluez à l'aide des commandes Définir des intervalles numériques sont ajoutés à cette clé de facette numérique si ces intervalles ne sont pas vides.

  • Sinon, les intervalles calculés avec des limites arrondies mentionnés précédemment sont ajoutés.

Créer la commande

Si vous souhaitez spécifier vos propres intervalles pour les clés de facette et de carte numériques au lieu d'utiliser celles que Vertex AI Search for Retail calcule pour vous, créez un ensemble de commandes d'intervalles numériques.

Pour créer un contrôle permettant d'ajouter des intervalles:

  1. Accédez à la page "Contrôles" dans la console de la recherche pour les marchands.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles des facettes, cliquez sur Créer un contrôle.

    Le volet Créer un contrôle s'ouvre.

  3. Sélectionnez Définir des intervalles de facettes et de cartes numériques.

  4. Spécifiez 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. Spécifiez au moins l'une des valeurs Minimum ou Maximum. Si les deux sont spécifiés, le minimum ne peut pas être supérieur au maximum. Vous pouvez choisir que chaque limite soit inclusive ou exclusive.

  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 permettant de supprimer des attributs et des vignettes

La commande "Supprimer les attributs" vous permet de supprimer un attribut et une clé de carte spécifiques des attributs dynamiques. Les clés d'attribut et de vignette sont supprimées en fonction de certains termes de requête ou de catégories de pages donnés.

Ce type de contrôle des facettes contrôle l'attribut lui-même. Si ce type de contrôle est appliqué, aucun attribut ni aucune vignette associés à cet attribut en tant que membres ne seront renvoyés dans la recherche.

Cette commande est utile si vous souhaitez supprimer certaines clés de facette et de carte pour certains termes de requête ou de navigation. Par exemple, vous pouvez utiliser cette commande pour supprimer la clé de facette attributes.shoe_size pour la requête "chaussures".

Pour créer une commande permettant de supprimer un attribut ou une vignette:

  1. Accédez à la page "Contrôles" dans la console de la recherche pour les marchands.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles des facettes, cliquez sur Créer un contrôle. Le volet Créer un contrôle s'ouvre.

  3. Sélectionnez Supprimer les attributs et les vignettes.

  4. Chaque commande s'applique à la recherche ou à la navigation, mais pas aux deux. Effectuez l'une des opérations suivantes :

    • Pour les requêtes de recherche, cliquez sur Rechercher, puis spécifiez des termes de requête partiels ou exacts à faire correspondre. Pour en savoir plus, consultez les conditions d'utilisation et les conditions d'utilisation des requêtes. Les termes de la requête doivent être en minuscules dans les deux cas. Par exemple, vous pouvez spécifier les termes de requête partiels shirts, polo, jackets, t-shirt et fall coats. Les clés de facette spécifiées ensuite n'apparaîtront pas en tant que facette dynamique si la requête en minuscules est l'un de ces termes de requête ou en contient un en tant qu'unigramme.

    • Pour la navigation, 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 le même que celui des catégories de pages des événements 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 ce dernier et l'une des catégories de pages transmises dans l'événement (pour la navigation), les clés de facette spécifiées ensuite n'apparaîtront pas en tant que facette dynamique.

  5. Spécifiez au moins une clé de facette valide dans Attributs à ignorer.

  6. Cliquez sur Envoyer.

Créer un contrôle de forçage des attributs de retour

La commande de forçage des facettes peut affecter la position de la liste d'une clé de facette dynamique pour une requête ou un événement de navigation spécifique.

Ce paramètre est utile si vous souhaitez forcer une clé de facette spécifique parmi les facettes dynamiques pour certains termes de requête ou de navigation. Par exemple, vous pouvez utiliser ce contrôle pour forcer la clé de facette brands à s'afficher à la position 10 ou à une position inférieure pour la requête handbags. Si le facet brands figure déjà dans le top 10 des facettes dynamiques pour cette requête, il ne devrait pas bouger beaucoup. S'il ne figure pas dans le top 10 ni dans la liste des facettes dynamiques, il devrait passer à la position 10 environ.

Pour créer un contrôle pour le facette "Forcer l'attribut de retour" :

  1. Accédez à la page "Contrôles" dans la console de la recherche pour les marchands.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles des facettes, cliquez sur Créer un contrôle.

    Le volet Créer un contrôle s'ouvre.

  3. Sélectionnez Forcer les attributs de retour.

  4. Chaque commande s'applique à la recherche ou à la navigation, mais pas aux deux. Effectuez l'une des opérations suivantes :

    • Pour les requêtes de recherche, cliquez sur Rechercher, puis spécifiez des termes de requête partiels ou exacts à faire correspondre. Pour en savoir plus, consultez les conditions d'utilisation et les conditions d'utilisation des requêtes. Les termes de la requête doivent être en minuscules dans les deux cas. Par exemple, vous pouvez spécifier les termes de requête partiels shirts, polo, jackets, t-shirt et fall coats. Les clés de facette spécifiées ensuite doivent apparaître autour de leur position respective ou plus haut parmi les facettes dynamiques si la requête en minuscules est l'un de ces termes de requête ou en contient un en tant qu'unigramme.

    • Pour la navigation, 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 le même que celui des catégories de pages des événements 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 ce dernier et l'une des catégories de pages transmises dans l'événement (pour la navigation), les clés de facette spécifiées ensuite doivent apparaître autour de leur position respective ou plus haut parmi les facettes dynamiques.

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

  6. Si vous souhaitez spécifier plusieurs clés de facette, cliquez sur Ajouter un ajustement, puis répétez l'étape précédente.

  7. Cliquez sur Envoyer.

Créer une commande de reclassement des attributs dynamiques

Le classement des facettes dynamiques dépend de la requête (recherche) ou des catégories de pages (parcours). Le contrôle de reclassement des attributs dynamiques permet également au classement de dépendre de certaines valeurs d'attributs utilisées par l'utilisateur.

Par exemple, à l'aide de ce contrôle, 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'attributs sur lesquelles vous souhaitez reclasser les résultats par clé d'attribut, ou uniquement la clé d'attribut et reclasser les résultats sur toutes ses valeurs.

Pour créer un paramètre permettant de reclasser les attributs dynamiques:

  1. Accédez à la page "Contrôles" dans la console de la recherche pour les marchands.

    Accéder à la page "Contrôles"

  2. Dans l'onglet Contrôles des facettes, cliquez sur Créer un contrôle.

    Le volet Créer un contrôle s'ouvre.

  3. Sélectionnez Reclasser les attributs dynamiques.

  4. Spécifiez une clé de facette textuelle personnalisée valide (toutes les clés personnalisées ont le préfixe attributes.).

  5. Vous pouvez spécifier des valeurs de facette spécifiques ou appliquer la règle à toutes les facettes.

    • Si vous souhaitez réorganiser les résultats en fonction de toutes les valeurs de facette, cliquez sur Toutes les valeurs changent.

    • Si vous souhaitez modifier le classement en fonction de valeurs de facette spécifiques, cliquez sur Modifications des valeurs sélectionnées. Insérez ensuite toutes les valeurs de facette sur lesquelles vous souhaitez reclasser les résultats (majuscules et minuscules sont pris en compte). Par exemple, il peut s'agir de watches, luggages ou bed.

  6. Cliquez sur Envoyer.

Vous devez transmettre toutes les clés de facette activées par l'utilisateur dans la requête pour les raisons suivantes:

  • Supposons qu'un utilisateur recherche des promotions et qu'une première liste de clés de facette s'affiche.
  • L'utilisateur active ensuite la clé de facette attributes.age_group.
  • Ensuite, ils activent la clé de facette attributes.department avec les valeurs de facette watches, pour lesquelles vous configurez un contrôle de reclassement.

À ce stade, la recherche réorganise les clés.

Il est donc possible que la clé de facette attributes.age_group précédemment engagée 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 ne pouvez afficher que les 20 premières clés à l'utilisateur. Par conséquent, assurez-vous que ces clés précédemment activées par l'utilisateur lui seront présentées. Si vous ne souhaitez pas afficher trop de touches à l'utilisateur, vous devrez peut-être filtrer certaines touches intermédiaires non utilisées dans la réponse.