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 et explications de base pour certains termes. liés aux attributs:

  • Attributs : spécifications des attributs pour 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, les facettes suivantes peuvent être renvoyées : price, attributes.department, attributes.colors et attributes.size.

  • Attributs système: prédéfinis Les attributs système sont des champs de produit existants 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 attributs supplémentaires que vous définissez à l'aide du champ Product.attributes. Pour par exemple style, color ou department.

  • Touche d'attribut: nom d'un attribut. Il peut s'agir, par exemple, attributes.department ou sizes. Les touches de facette correspondent les noms d'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). Le nom de l'attribut des termes, la clé d'attribut et 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é d'attribut textuelle brands pourrait avoir de telles valeurs textuelles que Asics et Nike. Pour les clés numériques, une valeur d'attribut 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 apparaissent dans leur ordre d'origine avant toutes les facettes dynamiques de la réponse.

  • Attributs dynamiques: il s'agit des attributs qui sont classés dans les sur le côté. Elles sont transmises dans la requête avec l'option enableDynamicPosition=true ou récupérées selon les 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 filter consiste en une expression. langage permettant de construire un prédicat à partir d'un ou de plusieurs champs des produits en cours de filtrage. Par exemple, si un utilisateur interagit avec les valeurs d'attribut Asics des 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 guide de l'utilisateur.

À propos des attributs et des cartes dynamiques

Lorsque les attributs dynamiques sont activés pour configuration de diffusion, rechercher pouvez utiliser automatiquement les attributs en tant qu'attributs et tuiles dynamiques dans les résultats de recherche pour en fonction du comportement antérieur de l'utilisateur, comme les clics et les vues d'attribut. Les attributs dynamiques sont transmis dans la requête avec l'option enableDynamicPosition=true ou récupérées selon les 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 l'attribut sur l'ensemble du site de commande.

Notez que les facettes et les cartes dynamiques peuvent être créées en utilisant exclusivement des données de catalogue de produits précises. Toutefois, pour que cette fonctionnalité fonctionne de façon optimale pour votre site, les modèles de facettes doivent apprendre de l'activité sur votre 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 une commande pour modifier les attributs renvoyés par la recherche. Un volet Créer une commande 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 un attribut à ignorer et des valeurs de tuile lorsque vous souhaitez supprimer des attributs des valeurs d'attribut et de tuile pour certains attributs et clés de tuiles spécifiques.

Cette commande est utile pour effacer les valeurs d'attribut et de tuile 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 tuile:

  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 Commandes des facettes, cliquez sur Créer une commande

    Le volet Créer une commande 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. Le nom d'un attribut personnalisé commence par attributes., par exemple : Exemple : attributes.department et attributes.colors.

  5. Facultatif: Spécifiez l'heure de début et/ou l'heure de fin.

  6. Indiquez une ou plusieurs valeurs d'attribut sous Ignorer les valeurs.

    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 tuile est parfois appelé valeurs d'attribut et de tuile fusionnées.

Pour éviter les conflits et les mappages inutiles, si une valeur d'attribut est facet_value_1 est remplacé par une autre valeur d'attribut, facet_value_2, cette dernière ne peut pas être remplacé 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 les valeurs et les attributs :

  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 une commande s'ouvre.

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

  4. Indiquez le nom de l'attribut.

    Cette fonctionnalité n'est compatible qu'avec les attributs personnalisés, qui commencent par le préfixe avec attributes (par exemple, attributes.department) et attributes.colors

  5. Indiquez une ou plusieurs valeurs d'attribut sous Remplacer les valeurs, 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 la commande de remplacement des valeurs d'attribut prend effet, si la clé d'attribut (dans ce exemple attributes.colors) est renvoyé dans la réponse, l'attribut remplacé (telles que dark red et crimson) ne seront pas présentes en tant que valeurs d'attribut. Ils sont remplacées par leurs conditions de remplacement (par exemple, red).

Créer une commande de fusion d'attributs

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 recherche. Toutefois, si vous ne pouvez pas modifier les noms des attributs personnalisés, vous pouvez créer des commandes de fusion de facettes. Créez une commande de fusion d'attributs si vous souhaitez fusionner (remplacer) un attribut par un autre. Par exemple, vous pouvez avoir plusieurs touches d'attribut personnalisées pour des couleurs comme attributes.colors_jeans, attributes.colors_clothes et attributes.colors_hue, et que vous souhaitez remplacer avec une clé d'attribut personnalisée existante appelée attributes.colors.

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

  • Noms d'attributs personnalisés permanents, dont le type ne changera pas.
  • 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 arbitrairement 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 d'attribut colors ne sera pas ajouté à produit spécifique, car il contient déjà le nombre maximal de clés personnalisées produit. Les clés fusionnées ne seront pas supprimées des noms d'attributs (personnalisés) de mais elles ne seront pas non plus renvoyées en tant que clés d'attributs dynamiques. De même, si vous fusionnez plusieurs clés avec la même clé et que le nombre de valeurs d'attribut de 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 une commande qui a fusionné un attribut dans un autre:

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

    Accéder à la page "Contrôles"

  2. Dans l'onglet Commandes des facettes, cliquez sur Créer une commande

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Merge facets (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 sélecteur d'intervalles numériques

La commande de définition des intervalles numériques vous permet de déterminer les intervalles un attribut ou une tuile numériques au lieu d'avoir à 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 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 certains intervalles sont spécifiés dans la requête pour un attribut 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 d'attributs et de tuiles numériques au lieu de à l'aide de ceux calculés pour vous par Vertex AI Search pour le commerce, puis créez une définir des commandes 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 des facettes, cliquez sur Créer un contrôle.

    Le volet Créer une commande s'ouvre.

  3. Sélectionnez Définir des attributs numériques et des intervalles de tuiles.

  4. Spécifiez le nom d'un attribut numérique.

    Par exemple, price pour un 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, la valeur minimale ne peut pas être supérieure au maximum. Vous pouvez choisir chaque limite être Inclusif 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 un contrôle pour supprimer des attributs et des cartes

La commande de suppression d'attributs vous permet de supprimer un attribut et une clé de tuile spécifiques de la les attributs dynamiques. Les attributs et les clés d'emplacement sont supprimés en fonction de certains termes de requête donnés ou catégories de pages.

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 des clés d'attributs et de tuiles pour une requête ou parcourir. 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 permettant de supprimer un attribut ou une tuile:

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

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

  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. Afficher les détails dans les termes de requête et conditions. Les termes de requête doivent être en minuscules pour 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 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 une commande d'attributs de retour forcé

La commande "Forcer les attributs de retour" peut influer sur la position dans la liste d'un 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 des attributs dynamiques pour certains termes de requête ou la navigation. Par exemple, vous pouvez utiliser cette pour forcer l'affichage de la clé d'attribut brands à une position inférieure ou égale à 10 pour la requête handbags. Si l'attribut brands est déjà en haut 10 pour les attributs dynamiques de cette requête, elle ne devrait pas se déplacer 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 Commandes des facettes, 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 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 et spécifiez des des termes de requête ou des termes de requête exacts à faire correspondre. Pour en savoir plus, consultez les conditions d'utilisation et les conditions d'utilisation des requêtes. Les termes de requête doivent être en minuscules pour 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 une page. catégories. 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. Pour il peut s'agir de page_categories : Sales > 2023 Black Friday Deals. S'il existe un Correspondance exacte (sensible à la casse) entre cette dernière et l'une des pages catégories transmises dans l'événement (pour la navigation), puis les clés d'attribut spécifiés ensuite doivent s'afficher autour de leur position respective ou plus élevé parmi les attributs 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 dynamique des attributs dépend de la requête (recherche) ou des catégories de pages (parcourir). 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 d'attribut.

Pour créer une commande pour les attributs dynamiques de reclassement, procédez comme suit:

  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 d'attribut spécifiques ou les appliquer à tous.

    • Si vous souhaitez effectuer un reclassement de toutes les valeurs d'attribut, cliquez sur Toute valeur change.

    • 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.
  • Ensuite, l'utilisateur engage d'abord la clé d'attribut 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é d'attribut attributes.age_group précédemment engagée ne soit pas renvoyée dans la de réponse. Si vous transmettez cette clé dans la requête (à l'aide d'un Facetspec avec enableDynamicPosition définie sur true), elle est 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.