Cette page explique comment créer des commandes de diffusion.
Les contrôles de diffusion sont des règles que vous définissez et appliquez à des configurations de diffusion individuelles. Pour en savoir plus sur les configurations de diffusion, consultez la page À propos des configurations de diffusion.
Vous pouvez créer un contrôle de diffusion dans la console Search for Commerce, composé d'une condition qui déclenche le contrôle et d'une action effectuée lorsque la condition se déclenche. Vous pouvez ensuite associer le nouveau contrôle de diffusion à une configuration de diffusion.
Les configurations de diffusion ont une relation multi-relationnelle avec les contrôles. Vous pouvez ajouter plusieurs commandes à une configuration de diffusion, et une même commande peut être associée à plusieurs configurations de diffusion.
Lorsque vous créez des commandes et des configurations de diffusion, vous sélectionnez un produit (recommandations ou recherche) pour lequel elles peuvent être utilisées. Les commandes de diffusion ne peuvent être associées qu'à des configurations de diffusion du même type de produit. Par exemple, une commande de diffusion créée pour les recommandations ne peut pas être associée à une configuration de diffusion créée pour la recherche.
Les configurations de diffusion gèrent les commandes appliquées lors d'une requête de recherche ou de prédiction. Seuls les contrôles de la configuration de diffusion active pour une requête sont pris en compte au moment de la diffusion. Par exemple, supposons que vous ayez créé deux commandes: une commande appelée Promo gShoes qui met en avant les résultats de la marque gShoes lorsque la recherche est effectuée pour chaussures et une commande appelée Plus de chaussures qui étend les requêtes utilisant le terme chaussures de course pour inclure chaussures de sport. Si vous n'associez que le contrôle Vente gShoe à une configuration de diffusion, les requêtes de recherche utilisant cette configuration de diffusion améliorent les résultats gShoe pour les requêtes utilisant le terme chaussures, mais le contrôle Plus de chaussures n'a aucun effet, car il n'est pas associé à la configuration de diffusion que vous utilisez.
Vous pouvez créer des contrôles, puis les ajouter ou les échanger dans une configuration de diffusion active.
Créez ou modifiez des contrôles de diffusion à tout moment sur la page Contrôles ou en ligne à l'aide de la méthode Controls.create. Dans la console, vous pouvez éventuellement créer des commandes pendant le processus de création de la configuration de diffusion.
Vous pouvez créer jusqu'à 100 contrôles de diffusion. Si vous avez besoin de plus de contrôles de diffusion, demandez un quota supplémentaire. Pour savoir comment demander un quota supplémentaire, consultez la section Augmenter vos quotas. Une configuration de diffusion peut comporter jusqu'à 100 contrôles de diffusion de n'importe quel type, à l'exception des commandes de redirection, dont la limite est de 1 000 par configuration de diffusion.
Vidéos et guides de démarrage rapide
- Présentation des contrôles de diffusion: les contrôles de diffusion vous permettent de créer des règles qui personnalisent la façon dont vos configurations de diffusion renvoient les résultats de recherche.
- Remonter/redescendre : 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.
- Filtrer : supprime les résultats qui ne respectent pas le filtre de la liste des résultats renvoyés. Disponible uniquement pour la recherche.
- Rediriger : redirige vos utilisateurs vers une page spécifique en fonction de la requête de recherche. Disponible uniquement pour la recherche.
Ce tutoriel vous explique comment utiliser le contrôle de redirection.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
- Linguistique : personnalise la linguistique des requêtes de recherche. Disponible pour la recherche uniquement.
Plusieurs types de contrôles linguistiques sont disponibles :
- Synonyme : développe les synonymes pris en compte pour une requête de recherche.
- Synonyme unidirectionnel : développe les synonymes pris en compte de manière unidirectionnelle pour des termes spécifiques.
- Ne pas associer : empêche l'utilisation d'un groupe de termes dans la recherche lorsque des termes spécifiques apparaissent.
- Ignorer : empêche l'utilisation d'un terme dans les recherches.
- Remplacement : remplace les termes figurant dans la requête de recherche.
- Épinglage: affecte l'ordre des résultats en plaçant un résultat à une position spécifique (par exemple, à la position 4). Disponible pour la recherche et la navigation.
Pour obtenir des exemples de ces commandes, consultez la section À propos des commandes de diffusion.
Options de la console pour créer des commandes
Vous pouvez choisir l'un des chemins de console suivants pour créer toutes les commandes de diffusion dans Vertex AI Search for commerce.
Utiliser Google Cloud Console
Suivez la procédure de la console de merchandising dans chaque section de contrôle de la diffusion.
Utiliser la console Merchandising
Si vous êtes administrateur de la console Google Cloud, vous pouvez accorder aux marketeurs du site l'accès à la console de merchandising et leur attribuer le rôle de créateur ou d'approbateur.
Accéder à la console Merchandising en tant qu'utilisateur
Si vous avez été autorisé à accéder à la console avec l'URL, vous pouvez utiliser la console Merchandising au lieu de la console Google Cloud standard. Pour créer des commandes à l'aide de la console Merchandising:
Connectez-vous via la connexion externe fournie par votre administrateur.
Suivez les étapes décrites dans la documentation de la console de merchandising dans chaque section de contrôle de la diffusion.
Intégrer les utilisateurs de la console Merchandising
Si vous êtes administrateur de la console Google Cloud, vous pouvez accorder aux marchands l'accès à la console Merchandising:
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Accédez à l'onglet Console de merchandising.
Configurez les paramètres d'identité.
Attribuez aux utilisateurs les rôles Approbateur ou Créateur.
Vous pouvez voir l'URL unique de la console Merchandising associée au projet Google Cloud en cours. Copiez le lien ou ouvrez-le directement dans la console Google Cloud.
Sélectionnez la configuration de diffusion par défaut pour Aperçu dans la console Merchandising.
(Facultatif) Modifiez l'accès à la console Merchandising à l'aide des fonctions suivantes:
Ajouter des utilisateurs: accordez aux utilisateurs l'accès Approbateur ou Créateur à la console de merchandising.
Supprimer des utilisateurs: révoquez l'accès à la console Merchandising en supprimant des approbateurs ou des créateurs.
Accédez à la page Administration IAM dans la console Search for Commerce.
Accéder à la page "Administration IAM"
Étapes supplémentaires pour les approbateurs
Modifiez les paramètres de la console de merchandising en cliquant sur add_boxCréer un contrôle.
Ajoutez des questions à la règle de déclenchement ou supprimez-les sur l'écran Définir des objectifs.
(Facultatif) Une fois que vous avez reçu les demandes de contrôle envoyées par e-mail, modifiez leur état, approuvez-les ou refusez-les dans le tableau de bord, où elles sont listées.
Gérez l'approbation de chaque commande dans la section Examiner et approuver en cliquant sur Approuver, Refuser ou Modifier.
La dernière option vous permet d'accéder à l'écran suivant, où vous pouvez apporter vos modifications et cliquer sur Approuver avec modifications.
Toutes les commandes que vous ajoutez en tant qu'approbateur sont approuvées automatiquement.
Créer un contrôle de diffusion
Créez un contrôle de diffusion sur la page Contrôles de la console Google Cloud ou en ligne à l'aide de la méthode Controls.create.
Les commandes ont des exigences différentes selon leur type. Accédez à la procédure de création du type de commande que vous prévoyez de créer:
- Créer une commande de mise en avant/d'atténuation
- Créer une commande de filtre
- Créer une commande de redirection
- Créer un bouton d'épinglage
- Créer une commande de synonymes bidirectionnelle
- Créer une commande de synonymes unidirectionnelle
- Créer un contrôle "Ne pas associer"
- Créer une commande d'ignorer
- Créer une commande de remplacement
Créer une commande de boosting/rétrogradation
Ce type de commande est disponible pour la recherche et les recommandations.
- Créer une commande d'amélioration/d'enterrement de la recherche
- Créer un contrôle d'accentuation/d'enterrement des recommandations
Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles "Remonter/redescendre".
Créer un contrôle d'amélioration/d'enterrement de la recherche
Pour créer un contrôle d'amélioration/d'enterrement dans les résultats de recherche:
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre commande, sélectionnez le produit Recherche, puis choisissez le type de commande Remonter/redescendre.
Configurez la commande de boosting/rétrogradation:
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche cette commande en indiquant des critères pour une requête de recherche associée, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Définissez les actions "Remonter/redescendre" que vous souhaitez déclencher avec cette commande. Ces actions sont définies par un attribut de catalogue tel que couleurs, un critère tel que contient et une valeur telle que rouge.
Cliquez sur add_boxAjouter un attribut pour ajouter d'autres attributs.
Utilisez le curseur pour définir la valeur de boost/redescendre. Les nombres négatifs sont des valeurs d'enterrement, et les nombres positifs sont des valeurs de boost.
Cliquez sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans la section Préférences, dans le champ Nom du contrôle, saisissez un nom pour votre nouveau contrôle.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Dans la section Sélection de produits, sélectionnez Rechercher.
Sélectionnez Contrôles "Remonter/redescendre" comme type de contrôle. Cliquez sur Continuer.
Dans la section Déclencheurs, sélectionnez le type de comportement utilisateur qui déclenche ce contrôle.
Parcourir les catégories: la règle se déclenche lorsqu'un utilisateur parcourt les catégories de votre site (
search.request.queryest vide).Recherche: la règle est déclenchée lorsqu'un utilisateur effectue une recherche sur votre site (
search.request.queryn'est pas vide). Pour configurer ce contrôle pour qu'il se déclenche lorsqu'une catégorie est consultée ou qu'une requête est effectuée, ignorez l'étape suivante.
Facultatif: définissez des catégories ou des requêtes spécifiques pouvant déclencher ce contrôle en fonction de la catégorie ou de la requête que vous recherchez.
Si vous avez choisi Parcourir les catégories: dans le champ Catégories, indiquez les catégories qui déclencheront cette commande lors de la navigation.
Si vous avez choisi Recherche: cliquez sur le bouton Ajouter une requête pour ajouter des termes de requête (par exemple,
running shoes) à filtrer. Pour chaque terme, sélectionnez Correspondance partielle ou Correspondance exacte.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions.
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 la section Filtrage et ordre. Par exemple, pour spécifier les versions rouge et bleue de "product1" et "product2":
(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))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.
Dans la section Configurations de diffusion, sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez désormais le nouveau contrôle dans l'onglet Contrôles de diffusion de la page Contrôles.
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
Un contrôle de mise en avant/d'oubli peut être déclenché lorsqu'un utilisateur parcourt des catégories sur votre site (search.request.query est vide) ou lorsqu'il effectue une recherche sur votre site (search.request.query n'est pas vide).
L'exemple suivant montre les champs d'un contrôle déclenché par la navigation, où searchSolutionUseCase est défini sur SEARCH_SOLUTION_USE_CASE_BROWSE.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "searchSolutionUseCase": [ "SEARCH_SOLUTION_USE_CASE_BROWSE" ], "rule": { "condition": { "pageCategories": [ "CATEGORY_ABC", "CATEGORY_XYZ" ], "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "boostAction": { "boost": BOOST_NUMBER, "productsFilter": "FILTER_EXPRESSION" } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
L'exemple suivant montre les champs d'un contrôle déclenché par une recherche, où searchSolutionUseCase est défini sur SEARCH_SOLUTION_USE_CASE_SEARCH.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "searchSolutionUseCase": [ "SEARCH_SOLUTION_USE_CASE_SEARCH" ], "rule": { "condition": { "queryTerms": [ { "value": "VALUE_1", "fullMatch": "FULLMATCH_BOOLEAN_1" }, { "value": "VALUE_2", "fullMatch": "FULLMATCH_BOOLEAN_2" } ], "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "boostAction": { "boost": BOOST_NUMBER, "productsFilter": "FILTER_EXPRESSION" } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Créer un paramètre de boosting/rétrogradation des recommandations
Pour créer un contrôle booster/enterrer pour les recommandations:
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre contrôle, sélectionnez le produit Parcourir, puis choisissez le type de contrôle Remonter/redescendre.
Configurez la commande de boosting/rétrogradation:
Sous Déclencheurs, saisissez les catégories de pages qui doivent déclencher le sélecteur. Si aucun attribut de catalogue n'est configuré, cette commande est toujours opérationnelle.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Définissez les actions "Remonter/redescendre" que vous souhaitez déclencher avec cette commande. Ces actions sont définies par un attribut de catalogue tel que couleurs, un critère tel que contient et une valeur telle que rouge.
Cliquez sur add_boxAjouter un attribut pour ajouter d'autres attributs.
Utilisez le curseur pour définir la valeur de boost/redescendre. Les nombres négatifs sont des valeurs d'atténuation, tandis que les nombres positifs sont des valeurs d'accentuation.
Cliquez sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.
(Facultatif) Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier et saisissez un nouvel ID de commande.
Dans la section Sélection de produits, sélectionnez Recommandation.
Sélectionnez Contrôles "Remonter/redescendre" comme type de contrôle.
Cliquez sur Continuer pour accéder à la section Actions.
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 la section Filtrer les recommandations.
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"))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 pour accéder à la section Configurations de diffusion.
Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page Contrôles.
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
Pour créer une expression de filtre, utilisez la syntaxe d'expression de filtre décrite dans la section Recommandations de filtre.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ], "boostAction": { "boost": BOOST_NUMBER, "productsFilter": "FILTER_EXPRESSION" } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Créer un contrôle de filtre
Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles de filtrage.
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre commande, sélectionnez le produit Rechercher ou Parcourir, puis choisissez le type de commande Filtrer.
Configurez le contrôle Filtrer:
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche cette commande en indiquant des critères pour une requête de recherche ou une catégorie de pages associées, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Définissez les actions de filtrage que vous souhaitez déclencher avec cette commande. Ces actions sont définies par un attribut de catalogue tel que couleurs, un critère tel que contient et une valeur telle que rouge.
Cliquez sur add_boxAjouter un attribut pour ajouter d'autres attributs.
Cliquez sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Choisissez Contrôles de filtrage comme type de contrôle.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.
Sélectionnez le type de comportement utilisateur qui déclenche cette commande:
Parcourir les catégories: la règle se déclenche lorsqu'un utilisateur parcourt les catégories de votre site (
search.request.queryest vide).Recherche: la règle est déclenchée lorsqu'un utilisateur effectue une recherche sur votre site (
search.request.queryn'est pas vide).
Facultatif: définissez une condition de contrôle qui déclenche la règle en fonction de la catégorie consultée ou de la requête recherchée. L'option disponible dépend de l'option que vous avez sélectionnée : Parcourir les catégories ou Rechercher :
Si vous avez choisi Parcourir les catégories: dans le champ Catégories, indiquez les catégories qui déclencheront cette commande lors de la navigation.
Si vous avez choisi Recherche: cliquez sur le bouton Ajouter une requête pour ajouter les termes de requête (par exemple,
running shoes) à filtrer, puis sélectionnez l'une des options suivantes pour chaque terme:- Correspondance partielle: cette commande s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
- Correspondance complète: cette commande ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.
Lorsque l'un de ces termes est inclus dans une requête, le contrôle est appliqué.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions.
Ajoutez des filtres pour les attributs des produits dans le champ Action de filtrage.
Utilisez la syntaxe d'expression de filtre décrite dans la section Filtrage et ordre.
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"))Cliquez sur Continuer pour accéder à la section Configurations de diffusion.
Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page Contrôles.
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
Un contrôle de filtre peut être déclenché lorsqu'un utilisateur parcourt des catégories sur votre site (search.request.query est vide) ou lorsqu'il effectue une recherche sur votre site (search.request.query n'est pas vide).
L'exemple suivant montre les champs d'un contrôle déclenché par la navigation, où searchSolutionUseCase est défini sur SEARCH_SOLUTION_USE_CASE_BROWSE.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "searchSolutionUseCase": [ "SEARCH_SOLUTION_USE_CASE_BROWSE" ], "rule": { "condition": { "pageCategories": [ "CATEGORY_ABC", "CATEGORY_XYZ" ], "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "filterAction": { "filter": "FILTER_EXPRESSION" } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
L'exemple suivant montre les champs d'un contrôle déclenché par une recherche, où searchSolutionUseCase est défini sur SEARCH_SOLUTION_USE_CASE_SEARCH.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "searchSolutionUseCase": [ "SEARCH_SOLUTION_USE_CASE_SEARCH" ], "rule": { "condition": { "pageCategories": [ "CATEGORY_ABC", "CATEGORY_XYZ" ], "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "filterAction": { "filter": "FILTER_EXPRESSION" } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Créer un contrôleur de redirection
Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles de redirection.
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Attribuez un nom à votre commande, sélectionnez le produit Recherche, puis choisissez le type de commande Redirection.
Configurez la commande Redirect (Redirection) :
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche ce contrôle en indiquant des critères pour une requête de recherche associée, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Définissez les actions de redirection que vous souhaitez déclencher avec cette commande en saisissant l'URL de redirection.
Cliquez sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Choisissez Contrôles de redirection comme type de contrôle.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.
Créez au moins un déclencheur de terme de requête ou de période. Les commandes de redirection nécessitent au moins un déclencheur:
Sélectionnez le type de comportement utilisateur qui déclenche cette commande:
Parcourir les catégories: la règle se déclenche lorsqu'un utilisateur parcourt les catégories de votre site (
search.request.queryest vide).Recherche: la règle est déclenchée lorsqu'un utilisateur effectue une recherche sur votre site (
search.request.queryn'est pas vide).
Définissez une condition de contrôle qui déclenche la règle en fonction de la catégorie consultée ou de la requête recherchée. L'option disponible dépend de l'option que vous avez sélectionnée : Parcourir les catégories ou Rechercher :
Si vous avez choisi Parcourir les catégories: dans le champ Catégories, indiquez les catégories qui déclencheront cette commande lors de la navigation.
Si vous avez choisi Recherche: cliquez sur le bouton Ajouter une requête pour ajouter les termes de requête (par exemple,
running shoes) à filtrer, puis sélectionnez l'une des options suivantes pour chaque terme:- Correspondance partielle: cette commande s'applique lorsqu'une requête contient une correspondance partielle avec ce terme.
- Correspondance complète: cette commande ne s'applique que lorsqu'une requête contient une correspondance complète avec ce terme de requête.
Lorsque l'un de ces termes est inclus dans une requête, le contrôle est appliqué.
Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette commande peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions.
Saisissez l'URI vers lequel effectuer la redirection lorsque cette commande est déclenchée.
Cliquez sur Continuer pour accéder à la section Configurations de diffusion.
Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page "Contrôles".
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
Un contrôle de redirection peut être déclenché lorsqu'un utilisateur parcourt des catégories sur votre site (search.request.query est vide) ou lorsqu'il effectue une recherche sur votre site (search.request.query n'est pas vide).
L'exemple suivant montre les champs d'un contrôle déclenché par la navigation, où searchSolutionUseCase est défini sur SEARCH_SOLUTION_USE_CASE_BROWSE.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "searchSolutionUseCase": [ "SEARCH_SOLUTION_USE_CASE_BROWSE" ], "rule": { "condition": { "queryTerms": [ { "value": "VALUE_1", "fullMatch": "FULLMATCH_BOOLEAN_1" }, { "value": "VALUE_2", "fullMatch": "FULLMATCH_BOOLEAN_2" } ], "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "redirectAction": { "redirectUri": "REDIRECT_URI", } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
L'exemple suivant montre les champs d'un contrôle déclenché par une recherche, où searchSolutionUseCase est défini sur SEARCH_SOLUTION_USE_CASE_SEARCH.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "searchSolutionUseCase": [ "SEARCH_SOLUTION_USE_CASE_SEARCH" ], "rule": { "condition": { "queryTerms": [ { "value": "VALUE_1", "fullMatch": "FULLMATCH_BOOLEAN_1" }, { "value": "VALUE_2", "fullMatch": "FULLMATCH_BOOLEAN_2" } ], "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "redirectAction": { "redirectUri": "REDIRECT_URI", } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Créer une commande de synonymes bidirectionnelle
Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles des synonymes bidirectionnels.
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre commande, sélectionnez le produit Recherche, puis choisissez le type de commande Synonymes.
Configurez la commande de synonymes bidirectionnels:
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche ce contrôle en indiquant des critères pour une requête de recherche associée, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Définissez le type de synonyme que vous souhaitez déclencher avec cette commande. Sélectionnez Bidirectionnel. Pour en savoir plus sur les types de synonymes, consultez la section Synonymes.
Cliquez sur Envoyer. Vous êtes alors redirigé vers un écran de configuration détaillé des synonymes bidirectionnels.
Saisissez les synonymes dans le champ sous Actions de synonymes à double sens. Cette action lie les termes de manière bidirectionnelle afin qu'ils soient traités de la même manière dans les résultats de recherche. Ainsi, une requête "canapé rouge" renvoie un résultat "canapé rouge bordeaux", mais les requêtes "canapé bordeaux" sont développées pour inclure tous les types de canapés rouges, comme le cramoisi ou le rose.
Envoyer à nouveau pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Dans le champ Nom du contrôle, saisissez un nom pour votre nouveau contrôle.
Le volet Créer un contrôle s'ouvre.
Vous accédez alors à la section Préférences.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Choisissez Commande de synonymes bidirectionnels comme type de contrôle.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions.
Dans le champ Synonymes, saisissez entre deux et 100 termes de requête (par exemple,
shirtettop) qui doivent être des synonymes les uns des autres.Lorsque l'un de ces termes est inclus dans une requête, la recherche considère les autres termes de la requête comme des synonymes du terme inclus.
Cliquez sur Continuer pour accéder à la section Configurations de diffusion.
Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page "Contrôles".
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "rule": { "condition": { "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "twoWaySynonymAction": { "synonyms": [ "SYNONYM_1", "SYNONYM_2" ] } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl. Consultez la section Ajouter des commandes aux configurations de diffusion de manière intégrée.
Créer une commande de synonymes unidirectionnelle
Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles des synonymes unidirectionnels.
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre commande, sélectionnez le produit Recherche, puis choisissez le type de commande Synonymes.
Configurez la commande de synonymes unidirectionnels:
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche ce contrôle en indiquant des critères pour une requête de recherche associée, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Définissez le type de synonyme que vous souhaitez déclencher avec cette commande. Sélectionnez Aller simple. Pour en savoir plus sur les types de synonymes, consultez la section Synonymes.
Cliquez sur Envoyer. Vous êtes alors redirigé vers un écran de configuration détaillé des synonymes à sens unique.
Saisissez vos synonymes dans le champ sous Actions de synonymes à sens unique. Cette action lie les termes de manière unidirectionnelle pour qu'ils soient traités de la même manière dans les résultats de recherche. Ainsi, une requête pour un canapé rouge inclut les canapés bordeaux, mais une requête pour un canapé bordeaux ne renvoie pas d'autres types de canapés rouges, ce qui limite les résultats aux canapés bordeaux.
Cliquez à nouveau sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Choisissez Contrôle des synonymes unidirectionnel comme type de contrôle.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions.
Dans le champ Termes de requête, saisissez les termes (par exemple,
shoes) auxquels des synonymes doivent être associés lorsqu'ils sont inclus dans une requête.Dans le champ Synonymes, saisissez les termes qui doivent être utilisés comme synonymes pour les termes de requête que vous avez spécifiés (par exemple,
sneakersetsandalscomme synonymes unidirectionnels pour le terme de requêteshoes).Cliquez sur Continuer pour accéder à la section Configurations de diffusion.
Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page "Contrôles".
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "rule": { "condition": { "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "oneWaySynonymAction": { "synonyms": [ "queryTerms": [ "QUERY_TERM_1", "QUERY_TERM_2" ], "synonyms": [ "SYNONYM_1", "SYNONYM_2" ] ] } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Créer un contrôle Ne pas associer
Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles "Ne pas associer".
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre commande, sélectionnez le produit Recherche, puis choisissez le type de commande Ne pas associer.
Configurez la commande Ne pas associer:
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche ce contrôle en indiquant des critères pour une requête de recherche associée, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Sous Actions à ne pas associer,spécifiez les termes qui ne doivent pas être associés aux termes de requête que vous avez saisis dans la section Déclencheurs précédente. Saisissez-les respectivement dans les champs "Termes de requête" et "Termes dissociés".
Cliquez sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Sélectionnez Contrôle "Ne pas associer" comme type de contrôle.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions.
Dans le champ Termes de requête, saisissez les termes (par exemple,
gShoe) que vous souhaitez distinguer explicitement des autres.Dans le champ Termes dissociés, saisissez les termes à dissocier des résultats de recherche avec les termes de requête que vous avez spécifiés.
Par exemple, vous pouvez dissocier le terme de requête
gShoedu termecheap.Cliquez sur Continuer pour accéder à la section Configurations de diffusion.
Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page "Contrôles".
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "rule": { "condition": { "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "doNotAssociateAction": { "queryTerms": [ "QUERY_TERM_1", "QUERY_TERM_2" ], "doNotAssociateTerms": [ "DISSOCIATED_TERM_1", "DISSOCIATED_TERM_2" ] ] } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Créer une commande d'ignorer
Pour en savoir plus sur ce type de contrôle, consultez la section contrôles de type "Ignorer".
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre commande, sélectionnez le produit Recherche, puis choisissez le type de commande Ignorer.
Configurez la commande Ignorer:
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche ce contrôle en indiquant des critères pour une requête de recherche associée, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Indiquez les termes que vous souhaitez ignorer sous Ignorer les actions.
Cliquez sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Sélectionnez Contrôle "Ne pas associer" comme type de contrôle.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions.
Dans le champ Ignorer les termes, saisissez les termes (par exemple,
shoddy) que vous souhaitez ignorer dans une recherche lorsqu'ils sont saisis en tant que termes de requête.Cliquez sur Continuer pour accéder à la section Configurations de diffusion.
Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page "Contrôles".
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "rule": { "condition": { "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "ignoreAction": { "ignoreTerms": [ "IGNORE_TERM_1", "IGNORE_TERM_2" ] ] } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Créer un contrôle de remplacement
Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles de type "Remplacer".
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre commande, sélectionnez le produit Recherche, puis choisissez le type de commande Remplacement.
Configurez le contrôle Remplacement:
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche ce contrôle en indiquant des critères pour une requête de recherche associée, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Sous Actions de remplacement, définissez les termes de requête que vous souhaitez remplacer dans le premier champ et leurs substituts dans le second.
Cliquez sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Sélectionnez Contrôle de remplacement comme type de contrôle.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions.
Dans le champ Termes de requête, saisissez les termes de requête (par exemple,
gShoe) que vous souhaitez remplacer par le terme de remplacement.Dans le champ Terme de remplacement, saisissez le terme qui doit remplacer les termes de requête que vous avez spécifiés.
Par exemple, vous pouvez remplacer le terme de requête
gShoepar le terme de remplacementGoogle Shoe.Cliquez sur Continuer pour accéder à la section Configurations de diffusion.
Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.
Envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page "Contrôles".
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "rule": { "condition": { "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2" } ] }, "replacementAction": { "queryTerms": [ "QUERY_TERM_1", "QUERY_TERM_2" ], "replacementTerm": "REPLACEMENT_TERM" } } } }' \ "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Créer un bouton d'épinglage
Pour créer un bouton d'épinglage:
Console Merchandising
Cliquez sur l'URL fournie par l'administrateur. Connectez-vous.
Vous êtes alors redirigé vers la page Commandes de la console de merchandising.
Cliquez sur add_boxCréer un contrôle.
Définissez les objectifs de vos utilisateurs finaux et le calendrier requis. Vous devez répondre à toutes les questions. Cliquez sur Suivant.
Sélectionnez un sélecteur. Saisissez le nom de votre commande, sélectionnez le produit Recherche, puis choisissez le type de commande Épinglage.
Configurez le contrôle d'épinglage:
Sous Déclencheurs, définissez l'attribut de catalogue qui déclenche ce contrôle en indiquant des critères pour une requête de recherche associée, tels que contient ou hors plage. Si aucun attribut de catalogue n'a été configuré, cette commande s'applique toujours.
Définissez une plage temporelle applicable en saisissant une plage de dates. Si l'une des périodes spécifiées correspond, l'attribut de catalogue sera mis en correspondance avec la requête pendant l'une des périodes spécifiées. Ajoutez une période avec add_boxAjouter une période.
Définissez les actions d'épinglage que vous souhaitez déclencher avec cette commande. Ces actions sont définies par l'ID produit et la position de la punaise, de préférence un nombre inférieur à 120 (taille de page typique). Vous pouvez cliquer sur add_boxAjouter un produit et ajouter jusqu'à 10 produits.
Cliquez sur Envoyer pour envoyer votre demande de contrôle à un approbateur. Vous pourrez consulter l'état des demandes envoyées dans la console Merchandising. Si vous changez d'avis, vous pouvez supprimer votre demande de contrôle.
Cloud Console
Accédez à la page Commandes dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.
Le volet Créer un contrôle s'ouvre.
Dans le champ Nom de la commande de la section Préférences, saisissez un nom pour votre nouvelle commande.
Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Dans la section Sélection de produits, sélectionnez Rechercher ou Parcourir.
Choisissez Commande d'épinglage comme type de commande. Cliquez sur Continuer.
Dans la section Déclencheurs, sélectionnez le comportement utilisateur qui déclenche cette commande:
Parcourir les catégories: le champ
page_categoriesdoit être renseigné dans les requêtes de navigation, et le champsearch.request.querydoit être vide.Recherche: les requêtes de recherche ne nécessitent que le champ
search.request.query.Par défaut, toutes les catégories consultées et toutes les requêtes effectuées déclenchent cette commande.
Facultatif: définissez une condition qui déclenche la règle en fonction d'une catégorie consultée ou d'une requête recherchée spécifique:
Parcourir les catégories: dans le champ Categories (Catégories), indiquez les catégories qui déclenchent la commande.
Recherche: pour ajouter des termes de requête à filtrer (par exemple,
running shoes), cliquez sur Ajouter une requête. Pour chaque terme, sélectionnez Correspondance partielle ou Correspondance exacte.
Facultatif: Cliquez sur Ajouter une période ou Ajouter une plage de dates pour ajouter une ou plusieurs périodes auxquelles cette commande peut s'appliquer.
Cliquez sur Continuer pour accéder à la section Actions. Pour Emplacement de l'épingle, utilisez le curseur pour spécifier la position à laquelle les produits doivent être épinglés. Le curseur de valeur de la punaise n'accepte pas les valeurs 0, les nombres négatifs ni les valeurs non entières.
Vertex AI Search pour le commerce autorise 10 épingles dans la carte des épingles de n'importe quel contrôle. La position peut être comprise entre 1 et 120 (taille maximale de la page de requête).
Cliquez sur Continuer pour accéder à la section Configurations de diffusion. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle, puis envoyez vos paramètres de contrôle.
Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.
Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page Contrôles.
curl
Envoyez une requête Control.create avec un ID de contrôle et une instance de Control contenue dans le corps de la requête.
Pour en savoir plus sur les champs, consultez la documentation de référence de l'API Controls et la documentation de référence de l'API Controls.create.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "X-Goog-User-Project: PROJECT_NUMBER" \ --data '{ "displayName": "DisplayName", "solutionTypes": "SOLUTION_TYPE_SEARCH", "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"], "rule": { "condition": { "queryTerms": [ { "value": "Term1", "fullMatch": "boolean: true / false" }, { "value": "Term2", "fullMatch": "boolean: true / false" }, ], "activeTimeRange": [ { "startTime": timestamp1, "endTime": timestamp2 }, { "startTime": timestamp3, "endTime": timestamp4 } ] }, "pinAction": { "pinMap" : { "pin_position1": "product_id", "pin_position2": "product_id>" } } } }' \ "https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"
pin_position doit être un nombre entier compris entre 1 et 10 inclus,et product_id doit exister dans votre catalogue. Le nombre maximal d'éléments autorisés dans la carte des épingles est de 10 par commande.
Associez ensuite la commande d'épinglage à votre configuration de diffusion:
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "X-Goog-User-Project: PROJECT_NUMBER" \ -d '{ "controlId": "CONTROL_ID" }' \ 'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'
Dans ce cas, CONTROL_ID doit correspondre au contrôle d'épinglage id que vous avez créé précédemment.
Pour ajouter un contrôle à une configuration de diffusion, utilisez la méthode ServingConfig.addControl:
Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API
ServingConfig.addControl.Pour obtenir un exemple de cette méthode, consultez la section Gérer les configurations de diffusion.
Enfin, pour tester votre configuration, effectuez une requête de recherche. Pour vous assurer que le contrôle d'épinglage sera appliqué à une requête, utilisez des termes de requête (dans la recherche) ou des catégories de pages (dans la navigation) correspondant aux termes/catégories fournis dans le contrôle que vous avez créé dans les étapes précédentes.
Cloud Console
Accédez à la page Évaluer dans la console Search for Commerce.
Accéder à la page "Évaluer"Accédez à l'onglet Search (Rechercher).
Saisissez une requête de test dans le champ de requête de recherche.
Cliquez sur Aperçu de la recherche.
Consultez les résultats pour vous assurer que les produits de votre choix sont épinglés.
curl
curl -s -X POST -H "Authorization: Bearer" -H "Content-Type: application/json" --data "{'query': '','visitorId': ' \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"'}"
Contraintes de vérification des erreurs
Pour la vérification des erreurs, gardez à l'esprit les contraintes suivantes:
- Vous ne pouvez pas épingler deux produits à la même position. Autrement dit, les produits "a" et "b" ne peuvent pas tous deux occuper la position 2.
- À l'inverse, un produit ne peut pas être épinglé à plusieurs emplacements. Autrement dit, le produit "a" ne peut pas être épinglé aux positions 2 et 3 en même temps pour la même requête.
- L'
product_iddoit exister en tant que produit dans le catalogue, en supposant qu'aucun filtre ni tri ne sont appliqués.