À propos des commandes de diffusion

Vous pouvez appliquer des contrôles de diffusion aux configurations de diffusion pour personnaliser le traitement des requêtes de recherche et le renvoi des résultats de recherche. Un contrôle de diffusion est une règle composée d'une paire condition-action, où la condition détermine le moment d'exécution du contrôle de diffusion, et l'action spécifie le comportement adopté par le contrôle de diffusion.

Vous pouvez créer un contrôle de diffusion dans la console Search for Retail ou à l'aide de la méthode Control.create de l'API.

Vous pouvez ensuite associer le nouveau contrôle de diffusion à n'importe laquelle des configurations de diffusion de recherche que vous avez créées. Seuls les contrôles d'une configuration de diffusion active pour une requête sont pris en compte au moment de la diffusion.

Pour en savoir plus sur la création de contrôles de diffusion dans la console Search for Retail, consultez Créer des contrôles de diffusion.

Les contrôles de diffusion suivants sont disponibles :

  • Booster/enterrer : ce paramètre affecte le classement et l'ordre des résultats dans la liste des résultats renvoyés. Disponible pour la recherche et les recommandations.
  • Filtre: supprime de la liste des résultats renvoyés les résultats non conformes au filtre. Disponible uniquement pour la recherche.
  • Redirection : redirige vos utilisateurs vers une page spécifique, en fonction de la requête de recherche. Disponible uniquement pour la recherche.
  • Épinglage: la position exacte dans les résultats est spécifiée pour un produit donné.
  • Linguistique : personnalise la langue des requêtes de recherche. Disponible pour la recherche uniquement. Plusieurs types de contrôles linguistiques sont disponibles :
    • Synonyme : étend les synonymes considérés pour une requête de recherche.
    • Synonyme unidirectionnel : étend les synonymes considérés de manière unidirectionnelle pour des termes spécifiques.
    • Ignorer : empêche l'utilisation d'un terme dans les recherches.
    • Ne pas associer : empêche l'utilisation de termes dans les recherches lorsque des termes spécifiques apparaissent.
    • Remplacement : remplace les termes figurant dans la requête de recherche.

Conditions de contrôle

Les conditions de contrôle déterminent le moment d'exécution d'un contrôle de diffusion.

Les champs de condition de contrôle peuvent être des termes de requête, des périodes ou les deux. Certains types de commandes autorisent plusieurs champs de condition ou n'en autorisent aucun.

Les champs de condition disponibles sont les suivants:

  • Termes de la requête : déclenché lorsque le terme apparaît dans la requête de recherche.
    • Une correspondance complète nécessite que l'intégralité de la requête de recherche corresponde au terme de la requête.
    • Vous pouvez spécifier plusieurs termes de requête. Se déclenche tant que l'un des termes de la requête apparaît dans la requête de recherche.
  • Période d'activité : déclenché lorsque la date de la requête de recherche est comprise dans la période.
    • Vous pouvez spécifier plusieurs périodes. Se déclenche tant que la date de la requête est comprise dans la période (incluse).

Les champs de condition que vous spécifiez déterminent si le contrôle sera appliqué.

  • Les champs de conditions multiples sont combinés à l'aide d'AND. Autrement dit, si vous spécifiez à la fois la période et les termes de la requête, les deux champs de conditions doivent être déclenchés afin que le contrôle s'applique.
  • Les sous-champs de conditions multiples sont combinés à l'aide d'OR. Entre autres, si vous spécifiez plusieurs termes de requête, ceux-ci se déclenchent en cas de correspondance avec l'un des termes. Si vous spécifiez plusieurs périodes, la période se déclenche en cas de correspondance avec l'une des périodes.
  • Aucun champ de condition spécifié signifie que le contrôle s'applique en tout temps. Cependant, certains contrôles nécessitent la définition d'un champ.

Pour en savoir plus sur les paramètres de condition, consultez la documentation de référence de l'API Controls.condition.

Actions de contrôle

Une action de contrôle spécifie le comportement de la commande de diffusion si les conditions sont remplies lors d'une recherche.

Le type d'action que vous pouvez spécifier dépend du type de contrôle de diffusion que vous créez. Par exemple, l'action d'un contrôle remonter/descendre consiste à appliquer une valeur remonter/descendre à des produits que vous spécifiez dans le filtre, tandis que l'action en vue d'un contrôle de synonyme unidirectionnel vise à appliquer un terme associé que vous précisez.

Commandes de boosting/rétrogradation

Les commandes de boostage/d'enterrement vous permettent d'afficher certains résultats de recherche plus haut ou plus bas dans le classement.

Vous pouvez créer un contrôle de mise en avant/d'oubli pour la recherche ou les recommandations. La fonctionnalité de mise en avant/d'oubli des recommandations est en version Preview publique.

Lorsque vous créez un contrôle de boost/enterrer, vous pouvez utiliser des expressions de filtre pour spécifier les conditions basées sur les champs Product.

Vous pouvez ensuite appliquer une valeur boost comprise entre -1,0 et 1,0 pour indiquer dans quelle mesure elle doit aider à booster ou à enterrer les résultats des produits correspondant à ces conditions. Une valeur positive booste les résultats, et une valeur négative les enterre.

La définition d'une force de boost élevée améliore la promotion de l'article, mais ne signifie pas nécessairement que l'article boosté sera le meilleur résultat à tout moment. Les résultats qui sont nettement plus pertinents pour la requête de recherche peuvent toujours l'emporter sur des éléments très privilégiés mais non pertinents. De même, si vous définissez la force de boost sur -1,0, l'article est considérablement rétrogradé, mais les résultats très pertinents peuvent toujours être affichés.

À titre d'exemple d'action booster/enterrer, vous pouvez donner priorité aux produits bon marché et pas aux produits coûteux.

Les conditions de contrôle diffèrent entre les commandes de boosting/rétrogradation pour la recherche et les recommandations:

  • Recherche: vous pouvez définir les termes de requête et les périodes applicables en tant que conditions de contrôle.
  • Recommandations: Les conditions de contrôle ne sont pas disponibles. Le contrôle s'applique toujours.

En tant qu'action de contrôle, spécifiez un filtre pour les produits à booster ou à enterrer, et définissez la valeur booster/enterrer.

Pour créer un contrôle booster/enterrer, consultez la section Créer un contrôle de diffusion.

Pour en savoir plus sur les paramètres de contrôle "Remonter/redescendre", consultez la documentation de référence de l'API Controls.BoostAction.

Commandes de filtrage

Les commandes de filtrage vous permettent d'ajouter des filtres prédéfinis en fonction d'une requête de recherche spécifique.

Vous pouvez utiliser des expressions de filtre basées sur les champs Product. Consultez la section Filtrer et trier les résultats pour connaître la syntaxe d'expression de filtre.

Vous pouvez définir les termes de requête et les périodes applicables en tant que conditions de contrôle. En tant qu'action de contrôle, spécifiez un filtre à appliquer lors de la requête.

Par exemple, pour la requête "chaussures bleues", vous pouvez utiliser une commande de filtre pour filtrer automatiquement les résultats de recherche incluant la couleur bleue. Vous pouvez également utiliser des commandes de filtrage pour empêcher que certains résultats ne soient renvoyés aux acheteurs.

Pour créer un contrôle de filtrage, consultez la section Créer un contrôle de diffusion.

Pour en savoir plus sur les paramètres de contrôle des filtres, consultez la documentation de référence de l'API Controls.FilterAction.

Commandes de redirection

Vous pouvez utiliser un contrôle de redirection pour rediriger les acheteurs vers différentes pages en fonction de leur intention, au lieu de leur montrer uniquement les résultats de recherche.

Vous pouvez définir les termes de requête et les périodes applicables en tant que conditions de contrôle. En tant qu'action de contrôle, spécifiez un URI de redirection vers lequel effectuer la redirection si les conditions sont remplies.

Par exemple, vous pouvez créer un contrôle de redirection de sorte que lors d'une promotion pour un produit "gChaussures", les requêtes contenant "chaussures de course" ou "chaussures de sport" redirigent vers la page du produit gChaussures.

Pour créer un contrôle de redirection, consultez la section Créer un contrôle de diffusion.

Pour en savoir plus sur les paramètres de contrôle des redirections, consultez la documentation de référence de l'API Controls.RedirectAction.

Commandes d'épinglage

Les commandes d'épinglage vous permettent de spécifier une position exacte dans les résultats pour laquelle vous souhaitez qu'un produit apparaisse.

Vous pouvez créer un bouton d'épinglage pour la recherche ou la navigation. Il n'est pas compatible avec les recommandations.

Lorsque vous créez un contrôle d'épinglage, vous pouvez utiliser des expressions de filtre pour spécifier les conditions basées sur les champs Product.

En tant qu'action de contrôle, ajoutez un Rule à votre Condition de recherche ou de navigation, qui sera le champ d'action pin_action..

Vous pouvez ensuite appliquer une valeur pin comprise entre [1,120] pour indiquer la position fixe à laquelle épingler les résultats correspondant à ces conditions.

  • Condition de la règle: vous devez spécifier [Condition.query_terms][] (pour la recherche uniquement) ou [Condition.page_categories][] (pour la navigation uniquement), mais pas les deux.
  • Entrée d'action: les paires [pin_position, product_id] sont mappées (la position d'entrée peut être une valeur comprise entre 1 et 120). La taille maximale correspond à la taille maximale de la page de requête. 10 correspond au nombre de paires autorisées dans la carte des épingles.
  • Résultat de l'action: Épinglez les produits dont les ID correspondent à la position spécifiée dans l'ordre des résultats finaux. Par exemple, supposons que la requête soit "chaussures", que [Condition.query_terms][] soit "shoes" et que pin_map ait {1, pid1}. Le produit avec pid1 est épinglé en première position dans les résultats finaux.

Activer les épingles et les règles appliquées

Lorsqu'un bouton d'épinglage est activé:

  • Les produits dont les ID correspondent à une épingle apparaissent dans la réponse finale à la position exacte spécifiée par le contrôle.
  • Les épingles de la deuxième page ou d'une page ultérieure (numéro de page plus élevé) ne sont pas autorisées. Autrement dit, toute épingle définie sur une position supérieure à la requête page_size est ignorée.
  • Vous pouvez épingler jusqu'à 10 produits avec une seule commande.
  • product_id doit être l'ID d'un produit existant dans le catalogue.

Le produit est toujours rappelé dans chaque recherche et apparaît sur la page, sauf dans les cas suivants:

  • Les filtres et le tri sont appliqués. Cela empêche l'affichage des épingles.
  • L'ordre de tri (par exemple, les résultats de recherche triés par prix) n'est pas défini par défaut.

Comportement des épingles

  • Si un produit est épinglé, il ignore les boosts ou masquages de la requête ou d'autres commandes.
  • Si un produit est épinglé à plusieurs positions, la commande la plus récente est prioritaire.
  • Vous ne pouvez pas épingler deux produits à la même position dans le même contrôle d'épinglage (plan des épingles).
    • Si plusieurs commandes correspondent à la même requête et que chacune d'elles possède une épingle différente pour le même ID de produit, la paire [pin_pos, p_id] de la commande la plus récemment mise à jour prévaut.

Contrôles linguistiques

Vous pouvez créer des ajouts ou des remplacements dans le cadre du traitement des termes pour certaines requêtes.

Contrôles de synonymes

Définir deux mots comme synonymes est un contrôle linguistique qui associe deux mots.

Les commandes de synonymes vous permettent d'inclure des produits supplémentaires dans les résultats de recherche qui ne sont pas récupérés par notre système par défaut.

Par exemple, si vous souhaitez que les résultats de recherche pour "chaussures de course" incluent également "chaussures de sport", créez un contrôle de synonyme linguistique. La condition est que le terme de recherche soit "chaussures de course". L'action consiste à inclure le synonyme "chaussures de sport" dans cette recherche. Ainsi, lorsqu'un client de votre site recherche "chaussures de course", la recherche identifie la correspondance grâce au contrôle linguistique que vous avez créé et l'étend pour inclure "chaussures de sport" lorsqu'elle renvoie un résultat de recherche à l'acheteur.

Pour créer un contrôle de synonymes, consultez la section Créer un contrôle de diffusion.

Contrôles de synonymes bidirectionnels

Utilisez des contrôles de synonymes bidirectionnels pour associer plusieurs termes afin que la recherche les traite de la même manière lors des recherches.

Vous pouvez définir les termes de requête et les périodes applicables en tant que conditions de contrôle. Vous n'avez pas besoin de définir une action de contrôle distincte. Si un terme que vous avez spécifié est utilisé dans la requête, l'action de contrôle consiste à utiliser les autres termes que vous avez spécifiés comme synonymes.

Par exemple, vous pouvez définir un contrôle de synonymes bidirectionnel qui associe les termes "linge de vaisselle" et "linge de cuisine" en tant que synonymes. Lorsqu'un client sur votre site saisit "torchon de cuisine" dans sa requête, la recherche peut alors étendre cette requête afin d'inclure les résultats pour "torchon à vaisselle", et aussi pour "torchon de cuisine".

Pour créer un contrôle de synonymes, consultez la section Créer un contrôle de diffusion.

Notez que les synonymes ne modifient pas la requête d'origine. Par exemple, un synonyme à double sens de "A<==>B" aura les effets suivants:

  • Pour la requête "A", les résultats renvoyés doivent être l'ensemble de résultats A (lorsqu'aucune règle de synonyme n'est appliquée) + une partie de l'ensemble de résultats B, mais ils peuvent être inférieurs à l'union de l'ensemble de résultats A et de l'ensemble de résultats B.

  • Pour la requête "B", les résultats renvoyés doivent être l'ensemble de résultats B + une partie de l'ensemble de résultats A, mais ils peuvent être inférieurs à l'ensemble de résultats A + l'ensemble de résultats B.

Pour en savoir plus sur les paramètres de contrôle des synonymes à double sens, consultez la documentation de référence de l'API Controls.TwowaySynonymsAction.

Contrôles de synonymes unidirectionnels

Les contrôles de synonymes unidirectionnels développent les termes de requête pour les associer de manière unidirectionnelle.

Vous pouvez définir les termes de requête et les périodes applicables en tant que conditions de contrôle. En tant qu'action de contrôle, spécifiez les termes à utiliser comme synonymes unidirectionnels.

Par exemple, vous pouvez définir un contrôle de synonyme unidirectionnel qui développe les recherches du terme "violet" afin d'inclure le terme "pourpre". Comme il s'agit d'un synonyme unidirectionnel, les recherches portant sur le terme "pourpre" ne se développent pas pour inclure le terme "violet".

Pour créer un contrôle de synonyme unidirectionnel, consultez la section Créer un contrôle de diffusion.

Notez que, comme pour les synonymes à double sens, la requête d'origine est exécutée et les synonymes sont fournis en tant qu'indices pour cette requête. Les synonymes de mots complètement différents ne peuvent inclure qu'un petit nombre de termes synonymes dans les résultats. Par exemple, une règle de synonymes pour "chien=>chat" renverra toujours principalement des chiens, ainsi que quelques chats, tandis que l'exemple "rose=>rose" devrait renvoyer des articles roses avec un accent particulier sur les roses.

Pour en savoir plus sur les paramètres de contrôle des synonymes unidirectionnels, consultez la documentation de référence de l'API Controls.OnewaySynonymsAction.

Les synonymes ne fournissent pas des résultats identiques

Les résultats de recherche pour deux synonymes ne sont pas toujours identiques.

Par exemple, si vous définissez "sac pour ordinateur portable" et "bagages" comme synonymes à double sens, le système peut déjà associer "valise" à "bagages". Ainsi, lorsqu'un utilisateur recherche "bagages", Vertex AI Search pour le commerce renvoie des résultats sur "bagages", "valise" et "sac pour ordinateur portable". Toutefois, lorsque vous recherchez "sac pour ordinateur portable", Vertex AI Search pour le commerce n'ajoute que "bagage" aux synonymes. Les résultats peuvent donc ne pas contenir "valise".

Contrôles Ignorer

Les contrôles Ignorer empêchent la recherche d'utiliser certains termes de requête lors des recherches.

Un contrôle d'ignorement n'est pas un opérateur négatif. Il ne garantit pas que Vertex AI Search pour le retail ne fournira aucun résultat pour ce terme. Pour éviter cela, utilisez un contrôle de filtre. Une commande d'ignorer appliquée à une requête à un seul mot peut tout de même renvoyer des résultats, car des synonymes ou une expansion de requête définis par Google peuvent correspondre à certains produits.

Par exemple, un paramètre d'ignorement du mot "huile" renverra toujours des peintures à l'huile pour une requête "peintures à l'huile". La requête sera transmise sous la forme "peintures". De nombreuses peintures à l'huile peuvent être mises en correspondance, mais le jeu de résultats sera plus volumineux, car la recherche porte sur "peintures". Ce type de contrôle peut être utile si la requête "peintures à l'huile" est populaire sur votre site et que vous vendez de nombreux types de peintures, mais peu de peintures à l'huile.

Un paramètre Ignorer ne garantit pas que la recherche ne fournira aucun résultat. Pour éviter cela, utilisez un contrôle de filtre.

Vous pouvez définir les termes de requête et les périodes applicables en tant que conditions de contrôle. Vous n'avez pas besoin de définir une action de contrôle distincte. Si un terme que vous avez spécifié est utilisé dans la requête, l'action de contrôle consiste à ignorer ce terme.

Par exemple, vous pouvez créer un contrôle qui ignore les termes de requête utilisant un langage inapproprié.

Pour créer un contrôle Ignorer, consultez la section Créer un contrôle de diffusion.

Pour en savoir plus sur les paramètres de contrôle d'ignorer, consultez la documentation de référence de l'API Controls.IgnoreAction.

Contrôles Ne pas associer

Les contrôles Ne pas associer empêchent les termes de requête d'être interrogés ensemble lors des recherches contenant d'autres termes que vous spécifiez.

Vous pouvez définir les termes de requête et les périodes applicables en tant que conditions de contrôle. En tant qu'action de contrôle, spécifiez les termes qui ne doivent pas être associés aux termes de la requête.

Par exemple, vous pouvez créer un contrôle qui empêche un nom de marque (tel que "gShoes") d'être associé au terme "bon marché" et "mauvaise qualité" dans une requête, de sorte que si un acheteur recherche "gShoes bon marché de mauvaise qualité", la recherche ne recherche que "gShoes".

Si un résultat pertinent pour le terme de la requête contient également un terme de type "ne pas associer", ce résultat pertinent peut toujours être renvoyé. Pour éviter cela, utilisez une commande de filtrage.

Pour créer un contrôle de type "ne pas associer", consultez la section Créer un contrôle de diffusion.

Pour en savoir plus sur les paramètres de contrôle "Ne pas associer", consultez la documentation de référence de l'API Controls.DoNotAssociateAction.

Contrôles de remplacement

Les contrôles de remplacement remplacent un ou plusieurs termes de requête donnés par un terme différent que vous spécifiez. Vous pouvez spécifier plusieurs termes pouvant être mappés à un seul terme (mais pas l'inverse).

Vous pouvez définir les termes de requête et les périodes applicables en tant que conditions de contrôle. Spécifiez le terme à utiliser en remplacement.

Par exemple, vous pouvez créer une commande qui remplace les pseudonymes d'une marque par le nom complet de la marque plus couramment utilisé dans les descriptions de produits.

Pour créer un contrôle de remplacement dans la console Search for Retail, consultez la section Créer un contrôle de diffusion.

Pour en savoir plus sur les paramètres de contrôle de remplacement, consultez la documentation de référence de l'API Controls.ReplacementAction.