Cette page a été traduite par l'API Cloud Translation.

À propos des commandes de diffusion

Vous pouvez appliquer des contrôles de diffusion aux configurations de diffusion pour personnaliser la façon dont la recherche traite les requêtes de recherche et renvoie les résultats. Un contrôle de diffusion est une règle composée d'une paire condition-action, où la condition détermine le moment où le contrôle de diffusion exécute une action. L'action spécifie le comportement du contrôle de diffusion.

Vous pouvez créer un contrôle de diffusion à l'aide de la méthode d'API Control.create.

Si vous ne souhaitez pas utiliser l'API, vous pouvez choisir Console pour créer des contrôles de diffusion dans Vertex AI Search pour le commerce.

Bonnes pratiques d'intégration et de configuration

Cette section décrit les bonnes pratiques d'intégration et de configuration à l'aide des commandes de diffusion.

Commencer sans commandes

Commencez à utiliser Vertex AI Search pour le commerce avec des contrôles de diffusion minimes ou inexistants. Les contrôles de diffusion tels que "Remonter" et "Redescendre" interfèrent avec l'optimisation du classement qui est initialement effectuée pour améliorer les revenus et la pertinence des résultats de recherche.

Les contrôles de diffusion ne doivent être ajoutés que si cela répond à un besoin commercial très important. Par exemple, ABC.com est une place de marché de mode en ligne. Ils proposent les marques internes pqr et xyz, ainsi que d'autres marques. ABC.com peut désormais choisir de mettre en avant ses marques internes pqr et xyz, c'est-à-dire de les placer en haut des résultats de recherche pour certaines requêtes spécifiques, comme tops pour femmes. Dans le cas d'utilisation professionnel, ABC.com peut avoir de meilleures marges avec les produits des marques pqr et xyz. Cela justifie l'interférence avec le classement par défaut, c'est-à-dire de ne pas utiliser de boost.

Une autre raison de commencer avec un minimum de contrôles est que le modèle d'IA de backend apprend et s'adapte en permanence en fonction des tendances et des habitudes d'achat des utilisateurs (le backend s'entraîne sur une période de 30 à 90 jours d'événements). Un grand nombre de cas d'utilisation liés aux synonymes seront déjà traités.

En résumé, la décision d'ajouter des contrôles de diffusion doit être étayée par un indicateur de revenus ou un cas d'utilisation commercial solides.

Configuration des attributs

Consultez les conditions préalables à la configuration des attributs. Les attributs permettent d'étendre la structure des informations sur les produits et d'ajouter des attributs de produit définis par l'utilisateur. Les attributs ne doivent pas être utilisés comme source d'informations. Définissez également des indicateurs "true"/"false" pour les attributs qui le rendent consultable et indexable. Définissez au moins un des indicateurs de configuration sur "true" pour les attributs.

Configuration des attributs de correspondance exacte

L'option de configuration de correspondance exacte est utilisée pour les attributs tels que model_name ou part_number, qui sont généralement des caractères alphanumériques uniques. Par exemple, un modèle de machine à laver peut avoir un numéro de modèle tel que "WA2300AH3000". Dans ce cas, définissez l'attribut sur model_name et la configuration de la correspondance exacte sur true. Ainsi, lorsque la requête de recherche correspond à la chaîne d'attribut model_name, seul ce produit est renvoyé dans les résultats de recherche.

Attention : n'utilisez pas de mots ou de marques courants dans les attributs et définissez la correspondance exacte sur "true". Cela limite fortement les résultats de recherche lorsque ces mots courants figurent dans la requête de recherche, ce qui entraîne un faible rappel de produits pour les requêtes de recherche courantes et a un impact négatif sur les métriques CTR / CVR.

Vertex AI Search for Commerce est un service de classement uniquement

La proposition de valeur du service Vertex AI Search for Commerce est qu'il est utilisé pour découvrir les produits de votre catalogue en fonction de la pertinence des requêtes et les classer de manière à optimiser les revenus (avec des fonctionnalités auxiliaires telles que "Booster", "Enfouir", "Filtrer", etc.).

En substance, le service Vertex AI Search for Commerce renvoie une liste classée de produits optimisée en termes de revenus et de pertinence, qui doit être présentée à l'utilisateur final. Vertex AI Search for Commerce ne remplace pas la base de données du catalogue.

Si nécessaire, les API GET et LIST du produit peuvent être utilisées pour obtenir les informations complètes sur le produit dans la couche d'enrichissement.

Contrôles de diffusion disponibles

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 uniquement pour la recherche. 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 où un contrôle de diffusion exécute une action.

Les champs de condition de contrôle peuvent être des termes de requête, des périodes ou les deux. Certains types de contrôles autorisent plusieurs champs de condition, ou 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 est 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, le contrôle 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 contrôles "Booster/Enterrer" 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'exclusion pour la recherche ou les recommandations. La fonctionnalité "Booster/enterrer" pour les recommandations est disponible en version Preview publique.

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

Pour les filtres de recherche, utilisez la syntaxe d'expression de filtre décrite dans Filtrer et trier les résultats.
Pour les filtres de recommandations, utilisez la syntaxe d'expression de filtre décrite dans Filtrer les recommandations.

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 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 filtre vous permettent d'ajouter des filtres prédéfinis en fonction d'une requête spécifique.

Vous pouvez utiliser des expressions de filtre basées sur les champs Product. Consultez 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 un 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 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 une commande de redirection pour rediriger les acheteurs vers différentes pages en fonction de leur intention, au lieu d'afficher 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 une règle 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. Un autre cas d'utilisation des contrôles de redirection consiste à rediriger les acheteurs vers une page spécifique s'ils recherchent un terme qui n'est pas pertinent pour votre site. Par exemple, si un utilisateur recherche FAQ, il sera redirigé vers la page des questions fréquentes de votre site au lieu d'afficher les résultats de recherche.

Pour créer un contrôle de redirection, consultez 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 contrôles d'épinglage vous permettent de spécifier la position exacte dans les résultats où vous souhaitez qu'un certain produit apparaisse. Vous pouvez créer un contrôle d'épinglage pour la recherche ou la navigation. Elle 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 recherche ou parcourez Condition, qui sera le champ d'action pin_action..

Vous pouvez ensuite appliquer une valeur pin comprise entre 1 et 120 pour indiquer la position fixe à laquelle épingler les résultats correspondant aux conditions données.

Condition de la règle : vous devez spécifier une valeur [Condition.query_terms][] (pour la recherche uniquement) ou [Condition.page_categories][] (pour la navigation uniquement) non vide, 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 est le nombre de paires autorisées dans la carte des codes secrets.
Résultat de l'action : épingle 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.

La règle d'épinglage accepte n'importe quel ID produit (principal, variante ou collection), mais l'effet d'épinglage est atténué pour tout élément dont l'ID produit n'est pas principal.

Cela signifie que si vous souhaitez qu'une variante ou une collection exacte soit visiblement épinglée en haut de l'interface utilisateur :

Créez la règle d'épinglage en fonction de l'ID produit principal de l'article.
Ensuite, vous devez effectuer l'une des opérations suivantes :
- Ajoutez une règle de boost supplémentaire et boostez les ID de variantes (à l'aide d'une condition de boost, telle que id:ANY(123, 234)).
- Ajoutez une règle de filtrage supplémentaire pour exclure les variantes de produits qui vous intéressent.

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

Lorsqu'un contrôle d'épinglage est activé :

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

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

Les filtres et le tri sont appliqués. Elles empêchent les épingles d'apparaître.
L'ordre de tri (par exemple, trier les résultats de recherche par prix) n'est pas celui par défaut.

Comportement d'épinglage

Si un produit est épinglé, il ignore les boosts ou les enfouissements de la requête ou d'autres contrôles.
Si un produit est épinglé à plusieurs positions, le contrôle mis à jour le plus récemment est prioritaire.
Deux produits ne peuvent pas être épinglés à la même position dans le même contrôle d'épinglage (carte d'épinglage).
- Si plusieurs contrôles correspondent à la même requête et que chacun d'eux possède un code différent pour le même ID produit, la paire [pin_pos, p_id] du contrôle mis à jour le plus récemment est prioritaire.

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 contrôles de synonymes ajoutent du contexte à une requête de recherche. Elles ne forcent pas l'inclusion d'un résultat dans les résultats de recherche, mais elles peuvent aider le système à inclure des produits supplémentaires dans les résultats de recherche, ce qui augmente la probabilité qu'un résultat donné soit inclus. En d'autres termes, les contrôles de synonymes peuvent encourager le résultat de recherche à prendre en compte davantage d'options, mais en fin de compte, le résultat de recherche dépend de la notation.

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 linguistique de synonymes. La condition est que chaussures de course soit saisi comme terme de recherche. 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 à la règle linguistique que vous avez créée et l'étend à chaussures de sport lorsqu'elle renvoie un résultat de recherche au client.

Pour créer un contrôle de synonymes, consultez 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 torchon de cuisine.

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

Les synonymes ne modifient pas la requête d'origine. Par exemple, si les requêtes A et B sont des synonymes bidirectionnels, voici l'effet attendu :

Résultats de la requête A renvoyés : ensemble A (sans règle de synonymes appliquée) et une partie de l'ensemble B. Toutefois, les résultats peuvent être inférieurs à la combinaison de A et B.
Résultats de la requête B renvoyés : ensemble B et une partie de l'ensemble A, mais peut-être moins que la somme des ensembles de résultats A et B.

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

Contrôles de synonymes unidirectionnels

Les contrôles de synonymes unidirectionnels étendent les termes de requête pour associer les termes 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 Créer un contrôle de diffusion.

Notez que, comme pour les synonymes bidirectionnels, la requête d'origine est exécutée et les synonymes sont fournis comme des indices pour cette requête. Les synonymes de mots complètement différents peuvent n'entraîner l'inclusion que d'un petit nombre de termes synonymes dans les résultats. L'exemple précédent renvoie des articles roses en mettant l'accent sur les roses roses, mais une règle de synonymes qui élargit les recherches du terme chien pour inclure chat renvoie principalement des articles avec des chiens, ainsi que certains avec des chats.

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 sacs pour ordinateur portable et bagages comme synonymes bidirectionnels, 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 les bagages, les valises et les housses pour ordinateur portable. Toutefois, lorsque vous recherchez sacs pour ordinateurs portables, Vertex AI Search pour le commerce n'ajoute que bagages aux synonymes. Il est donc possible que les résultats ne contiennent pas le mot valise.

Contrôles Ignorer

Les contrôles Ignorer empêchent la recherche d'utiliser certains termes de requête lors des recherches. Ils marquent les termes ignorés dans une requête comme non importants, mais ne les excluent pas complètement de la requête.

Pour supprimer complètement un terme de recherche d'une requête, utilisez un contrôle de remplacement. Alors qu'un contrôle de filtre affecte les résultats affichés, un contrôle de remplacement est un moyen plus efficace d'empêcher Vertex AI Search for Commerce de renvoyer des résultats pour un terme spécifique.

Un contrôle Ignorer ne garantit pas que les résultats pour le terme ignoré ne seront pas renvoyés dans les résultats Vertex AI Search pour le commerce. Par exemple, un contrôle d'ignorance pour le mot huile peut toujours renvoyer des peintures à l'huile pour une requête peintures à l'huile. La requête est transmise sous la forme peintures. Il peut y avoir de nombreuses peintures à l'huile correspondantes,mais l'ensemble de résultats est plus volumineux, car la recherche porte sur peintures. Ce type de contrôle peut être utile si peintures à l'huile est une requête populaire sur votre site et que vous vendez de nombreux types de peintures, mais pas beaucoup de peintures à l'huile.

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 Créer un contrôle de diffusion.

Pour en savoir plus sur les paramètres de contrôle d'ignorance, 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 certains termes de recherche d'être associés à d'autres termes spécifiés. Cela n'aura pas nécessairement d'incidence sur les résultats de recherche, mais cela peut arriver.

Utilisez un terme de requête donné et les périodes applicables pour vos 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.

Exemple : Vous créez un contrôle qui empêche un nom de marque (tel que gShoe) de se regrouper avec bon marché et mauvaise qualité dans une requête. Un acheteur recherche gChaussures bon marché de mauvaise qualité. La recherche supprime les termes de requête bon marché et mauvaise qualité de la requête initiale, le terme de requête résultant étant gChaussures. Toutefois, cela ne garantit pas qu'il sera entièrement supprimé des résultats de recherche.

Si un terme de requête pertinent 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 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 un contrôle 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 Recherche pour le commerce, consultez 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.