Améliorer les résultats

La fonctionnalité de recherche de l'Agent Platform pour les offres commerciales vous permet de spécifier les enregistrements à mettre en avant dans les recherches. Vous pouvez contrôler le classement des résultats en appliquant une règle de boost pour augmenter ou réduire le niveau de priorité des éléments de recherche renvoyés.

Le boost vous permet de contrôler le classement des résultats en mettant en avant (boost) ou en rétrogradant (enfouissement) des éléments spécifiques en fonction des critères que vous définissez. Contrairement au filtrage, qui supprime des éléments de l'ensemble de résultats, le boosting ajuste la position des éléments déjà éligibles au renvoi.

Remplacements de boost et de filtre

Remarque : Les règles de filtrage sont toujours prioritaires sur les règles de boost. Pour en savoir plus sur le filtrage et le tri des résultats de recherche, consultez Filtrer et trier les résultats.

Voici des exemples de types de filtres courants qui sont prioritaires sur les règles de boost :

1. Spécifié par l'utilisateur. Il peut s'agir d'éléments tels que le prix ou la marque. Ils apparaissent à l'utilisateur final sous forme de tuiles ou de facettes sur le site Web.

• Thématique (pertinence). Ces filtres n'existent que pour les requêtes de recherche (pas pour la navigation). Ils excluent les produits moins pertinents des résultats de recherche. Par exemple, la recherche réfrigérateur ne renvoie pas de micro-ondes ni d'accessoires, tels que des poignées de réfrigérateur. Le filtre reconnaît qu'il ne faut pas booster un micro-ondes pour une recherche de réfrigérateur.

Règles de boost

Les règles de boost ne peuvent être appliquées que lorsqu'il existe un score de pertinence de base, par exemple dans les recherches triées par pertinence ou les résultats de navigation avec des scores de tri préalable. Le boost est une fonction de multiplicateur appliquée aux résultats de recherche et de navigation. La syntaxe et la logique du boost peuvent être décomposées comme suit :

• Disponibilité. Le boost ne peut pas remplacer les règles de disponibilité. Si un élément est filtré (par exemple, s'il n'est plus en stock), le booster ne le fera pas apparaître.

• Opérateurs. Vous pouvez utiliser des opérations telles que supérieur à et inférieur à pour les champs numériques dans les conditions de boost, qui ne sont pas disponibles dans le filtrage strict standard.

Valeurs de boost ou d'enfouissement

Un produit peut être conditionné par plusieurs règles de boost ou d'enfouissement, qui sont définies dans la boostSpec classe de l'API Search. Une valeur de boost est un nombre à virgule flottante compris entre -1,0 et 1,0.

• Valeur positive (0,0 à 1,0) : met en avant l'élément, en le déplaçant plus haut dans les résultats. Une valeur de 1,0 offre la promotion maximale.

• Valeur négative (-1,0 à 0,0) : rétrograde (enfouit) l'élément, en le déplaçant plus bas dans les résultats. Une valeur de -1,0 offre la rétrogradation maximale.

Plusieurs règles de boost ou d'enfouissement sur un seul produit

Plusieurs règles de boost ou d'enfouissement peuvent affecter un produit, avec une somme ou un maximum des valeurs de boost déterminant le score final. Lorsque plusieurs règles de boost sont appliquées au même produit, vérifiez toujours si le score d'un autre produit a détrôné le produit de la première place. Le mode maximal est défini par défaut afin que ce problème soit moins susceptible de se produire.

Supposons qu'un produit reçoive des boosts de 2, 3 et 0,5, et qu'un autre produit reçoive un boost de 0,5. Bien que le produit n'ait reçu qu'un score de boost de 0,5, lorsqu'il est boosté à plusieurs reprises, il surpasse l'autre produit. Vérifiez attentivement la spécification de boost pour vous assurer qu'elle ne se chevauche pas ou qu'elle le fait, comme prévu.

Résolution de conflits

Si plusieurs règles de boost s'appliquent au même produit, vous pouvez définir leur interaction.

• Règle de boost maximal (par défaut) : la recherche de l'Agent Platform pour le commerce vérifie la valeur maximale et ignore les autres règles.

• Somme de l'effet de boost (paramètre alternatif) : en cas de rétrogradation et de promotion, la recherche de l'Agent Platform pour le commerce additionne les valeurs de toutes les règles de boost et d'enfouissement applicables. Cela permet un effet cumulatif. La somme résultante est un boost réduit ou un effet d'enfouissement net.

Configurer le boost

Pour configurer un ensemble de données avec des règles de boost ou d'enfouissement, vous définissez des conditions basées sur des attributs de produit (tels que la marque ou le prix) et attribuez une valeur de boost comprise entre -1,0 (enfouissement) et 1,0 (boost) pour ajuster le score de classement des éléments correspondants. Les produits suivants sont disponibles pour la configuration des commandes de boost ou d'enfouissement :

• Recherche : filtre thématique et tous les autres filtres appliqués par l'utilisateur, tels que les facettes sur site. Découvrez comment configurer le boost pour la recherche.

• Navigation : comme il n'y a pas de requête textuelle, seuls les filtres appliqués par l'utilisateur sont appliqués. Des filtres sont également appliqués pour vérifier que le produit (par exemple, les costumes) appartient à la bonne catégorie de produits (pas les pulls, par exemple). Découvrez comment configurer le boost pour les recommandations.

Exemple d'ensemble de données

Afficher l'exemple d'ensemble de données de produits

id	title	chaînes	catégories	price_info.price
"nest_mini_2nd_gen"	"Nest Mini (2e génération)"	["Google", "Nest"]	["Nest > enceintes et écrans"]	49.00
"nest_audio"	"Nest Audio"	["Google", "Nest"]	["Nest > enceintes et écrans"]	99.99
"nest_hub_max"	"Nest Hub Max"	["Google", "Nest"]	["Nest > enceintes et écrans"]	229.00
"nest_hub"	"Nest Hub"	["Google", "Nest"]	["Nest > enceintes et écrans"]	88.99
"google_home_max"	"Google Home Max"	["Google", "Nest"]	["Nest > enceintes et écrans"]	299.00
"google_home_mini"	"Google Home Mini"	["Google", "Nest"]	["Nest > enceintes et écrans"]	49.00
"google_pixel_5"	"Google Pixel 5"	["Google", "Pixel"]	["Pixel > téléphones"]	699.00
"google_pixel_4a_with_5g"	"Google Pixel 4a compatible 5G"	["Google", "Pixel"]	["Pixel > téléphones"]	499.00
"google_pixel_4a"	"Téléphones Google Pixel 4a"	["Google", "Pixel"]	["Pixel > téléphones"]	349.00
"google_pixel_stand"	"Google Pixel Stand"	["Google", "Pixel"]	["Pixel > accessoires sélectionnés"]	79.00
"google_pixel_buds"	"Google Pixel Buds"	["Google", "Pixel"]	["Pixel > accessoires sélectionnés"]	179.00
"google_pixel_5_case"	"Coque pour le Google Pixel 5"	["Google", "Pixel"]	["Pixel > accessoires sélectionnés"]	40.00
"google_pixel_4a_5g_case"	"Coque pour le Google Pixel 4a (5G)"	["Google", "Pixel"]	["Pixel > accessoires sélectionnés"]	40.00
"google_pixel_4a_case"	"Coque pour le Google Pixel 4a"	["Google", "Pixel"]	["Pixel > accessoires sélectionnés"]	40.00

Options de configuration

Dans la recherche de l'Agent Platform pour le commerce, le boost est appliqué en tant que multiplicateur au score de pertinence de base généré par l'algorithme de recherche. Vous pouvez configurer des règles de boost directement dans une requête de recherche à l'aide d'une spécification de boost ou en associant des commandes de diffusion à une configuration de diffusion. Dans la réponse, les éléments correspondant à ces conditions reçoivent un score de pertinence modifié, ce qui les fait apparaître plus haut ou plus bas dans la liste des résultats sans être complètement supprimés. Pour configurer une commande de boost ou d'enfouissement de recherche :

console Cloud

1. Accédez à la page Contrôles dans la console Search for commerce.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Commandes de diffusion, cliquez sur Modifier à droite d'une commande.

3. Dans le menu volant Modifier la commande, cliquez sur le champ sous le champ Nom de la commande pour modifier le nom de la commande.

4. Facultatif : pour la recherche, dans la section Déclencheurs, sélectionnez le type de comportement de l'utilisateur qui déclenche cette commande. Les sections Parcourir les catégories et Rechercher sont grisées.

5. Facultatif : modifiez les Termes de recherche correspondants.

   Remarque : Si vous spécifiez une condition de catégorie ou de terme de requête, ainsi que des conditions de période, la commande ne s'applique que lorsque les deux conditions sont remplies.

6. Facultatif : cliquez sur l'option Ajouter une période pour ajouter une ou plusieurs périodes pendant lesquelles cette commande peut être appliquée.

   **Remarque** : Si vous spécifiez des conditions de période en plus de ce type de condition, la commande n'est appliquée que si les deux conditions sont remplies.

7. Cliquez sur Continuer pour passer à la section Actions.

8. Ajoutez des filtres pour les attributs de produit dans le champ Remonter/redescendre le produit.

   Utilisez la syntaxe d'expression de filtre décrite dans Filtrer et trier les résultats. Par exemple, pour spécifier les versions rouge et bleue de "product1" et "product2", procédez comme suit : (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. Pour Remonter/redescendre la valeur, utilisez le curseur pour définir l'intensité du changement. Les valeurs positives font remonter les résultats et les valeurs négatives les font redescendre. Cliquez sur Continuer.

10. Dans la section Configurations de diffusion, sélectionnez les configurations de diffusion auxquelles appliquer la commande.

11. Envoyez vos paramètres de contrôle.

Vous trouverez désormais la règle de commande de boost ou d'enfouissement ajoutée en tant que nouveau Type de commande sous les Commandes de diffusion de votre projet. Découvrez comment créer une commande de boost et d'enfouissement dans Créer des commandes.

JSON

Cet exemple illustre le boost par prix.

Supposons que vous souhaitiez privilégier les produits moins chers (moins de 95 USD) et réduire le niveau de priorité donné aux produits onéreux (plus de 95 USD). Vous pouvez appliquer une spécification de boost.

{
  "condition_boost_specs": [
    {
      "condition": "price: IN(*, 95.0e)",
      "boost": 0.5
    },
    {
      "condition": "price: IN(95.0e, *)",
      "boost": -0.5
    }
  ]
}

Dans cet exemple, les produits de moins de 95 USD bénéficient d'une promotion (0,5), tandis que ceux de plus de 95 USD sont rétrogradés (-0,5).

Dans ce résultat, "nest_mini_2nd_gen", "google_home_mini" et "nest_hub" pourraient être les trois premiers, tandis que "nest_audio", "nest_hub_max" et "google_home_max" pourraient être les trois derniers. Cependant, aucun ordre spécifique n'est prédéterminé (contrairement au tri par prix) comme indiqué dans la section Filtrer et trier les résultats.

Boost dans la recherche

Pour la recherche, appliquez dynamiquement le score de classement des éléments correspondants en incluant une spécification de boost (boostSpec) avec condition_boost_specs directement dans la SearchRequest.

Conditions et déclencheurs

Le boost de recherche peut être conditionnel. Vous pouvez déclencher une règle de boost en fonction des conditions suivantes :

• Termes de la requête : appliquez le boost uniquement lorsque l'utilisateur recherche des termes spécifiques (par exemple, en boostant les manteaux d'hiver lorsque la requête contient veste).

• Périodes : appliquez le boost uniquement pendant une période promotionnelle spécifique.

• Global : appliquez le boost à toutes les requêtes diffusées par une configuration spécifique.

Exemple de requête et de réponse de recherche

Dans l'exemple d'ensemble de données présenté précédemment, si vous recherchez "enceinte Google", vous obtenez "nest_mini_2nd_gen", "nest_audio", "nest_hub_max", "nest_hub", "google_home_max" et "google_home_mini" sans ordre spécifique.

Afficher l'exemple de requête et de réponse de recherche

Java

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchProductsWithBoostSpec(String query, int pageSize,
    String condition, float boostStrength) throws IOException, InterruptedException {
  BoostSpec boostSpec = BoostSpec.newBuilder()
      .addConditionBoostSpecs(ConditionBoostSpec.newBuilder()
          .setCondition(condition)
          .setBoost(boostStrength)
          .build())
      .build();

  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setBoostSpec(boostSpec)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

Boost dans les recommandations

Le boost pour les recommandations est géré à l'aide de commandes de diffusion. Contrairement à la recherche, le boost de recommandation n'est pas compatible avec les conditions basées sur les requêtes (car il n'y a pas de requête utilisateur). Au lieu de cela, la commande s'applique à toutes les prédictions générées par la configuration de diffusion à laquelle elle est associée. Pour cette raison, vous configurez généralement les recommandations en associant des commandes de diffusion de boost ou d'enfouissement à la configuration de diffusion, plutôt qu'en transmettant une spécification de boost dans la requête.

Champs compatibles pour les recommandations

Lorsque vous définissez les produits à booster dans les recommandations, utilisez une expression de filtre. Alors que le filtrage de recommandation standard est limité aux champs textuels, le boost est compatible avec des champs numériques supplémentaires.

Field type (Type de champ)	Champs disponibles	Description
Textuel	productId, brands, categories, genders, ageGroups, colorFamilies, colors, sizes, title,materials, patterns, conditions, attributes.key, tags	Champs standards disponibles pour le filtrage et le boost. Notez que les tags sont des tags personnalisés associés au produit.
Numérique	price, discount, rating, ratingCount	Exclusivement pour le boost/l'enfouissement. Ces champs vous permettent de booster les produits en fonction du prix, des remises ou des notes des utilisateurs.

Pour en savoir plus, consultez la section Champs compatibles avec le boost/l'enfouissement dans Filtrer les recommandations.

Booster les produits bien notés

Supposons que vous souhaitiez vous assurer que les films bien notés apparaissent plus haut dans leur panneau de recommandations "Autres contenus susceptibles de vous plaire". Pour ce cas d'utilisation, créez une commande de diffusion pour booster les éléments dont le nombre de notes est supérieur à 100. Configurez vos commandes en tenant compte des éléments suivants :

• Type de commande : boost ou enfouissement

• Sélection de produits : recommandation

• Action:

  • Expression de filtre : ratingCount > 100

  • Valeur de boost : 0.5

Cette commande garantit que les éléments populaires et bien notés sont prioritaires dans la liste de recommandations, tout en conservant la pertinence de la personnalisation pour l'utilisateur.

Débogage et dépannage

Chaque produit est éligible à un boost illimité, mais les filtres appliqués par l'utilisateur éliminent les produits de la réponse de recherche. Pour déterminer pourquoi un produit boosté peut ne pas apparaître dans les résultats de recherche et de navigation, vérifiez les points suivants :

• Plusieurs règles de boost (y compris les rétrogradations d'enfouissement) : vérifiez la configuration du mode de boost (somme ou maximum) et déterminez le score final.
• Pertinence : un produit doit être pertinent pour la requête et passer les filtres de pertinence. Si une requête de recherche concerne des chaussures Nike et que le titre du produit est Air Jordans,les mots ne correspondent pas, mais leur relation sémantique étroite génère un score de pertinence élevé. Un titre de produit tel que veste jaune a un faible score de pertinence avec une requête de recherche Nike. De même, si le titre du produit est un numéro de modèle cryptique qui n'a aucun rapport avec un mot quelconque, le score de pertinence sera faible pour n'importe quelle requête.
• Filtres : les règles de filtrage remplacent toute règle de boost et empêchent les produits boostés d'apparaître dans les résultats. Le filtre est toujours appliqué au-dessus du boost. Si un produit comporte des filtres appliqués par l'utilisateur ou si une catégorie de produits filtre la navigation, le boost ne fonctionnera pas du tout.

Utiliser le boosting

Ce tutoriel vous présente quelques exemples de boost de produits.

---

Pour obtenir des instructions détaillées sur cette tâche directement dans l' éditeur Cloud Shell, cliquez sur Visite guidée :

Visite guidée

---