"Retail" devient Vertex AI Search pour le commerce. Nous sommes en train de mettre à jour le contenu pour refléter le nouveau branding.

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

Créer des commandes de diffusion

Cette page explique comment créer des commandes de diffusion.

Les commandes de diffusion sont des règles que vous définissez et appliquez des configurations de diffusion. Pour en savoir plus sur les configurations de diffusion, consultez la page À propos des configurations de diffusion.

Les commandes de diffusion vous permettent de créer des règles qui personnalisent la façon dont de configuration fournissent des résultats.

Vous pouvez créer une commande de diffusion dans la console Search for Retail une condition qui déclenche la commande et une action 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 plusieurs commandes à une configuration de diffusion, et une seule commande peut être associées à plusieurs configurations de diffusion.

Lorsque vous créez des commandes et des configurations de diffusion, vous sélectionnez produit (recommandations ou recherche) à utiliser. 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 sont prises en compte au moment de l'inférence. Par exemple, supposons que vous ayez créé deux contrôles : un contrôle appelé "Promo gShoe" qui améliore les résultats pour la marque gShoe lorsque la recherche "chaussures" est effectuée et un contrôle appelé "Plus de chaussures" qui développe les requêtes utilisant le terme "chaussures de course" pour inclure "chaussures de sport". Si vous n'associez que le contrôle "Promo 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 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ôle sur la diffusion, demander un quota supplémentaire. Pour savoir comment demander un quota supplémentaire, consultez Augmentez vos quotas. Une configuration de diffusion peut comporter 100 commandes de diffusion de n'importe quel type en plus des commandes de redirection, dont la limite est de 1 000 par configuration de diffusion.

Les contrôles de diffusion sont disponibles pour les éléments suivants :

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 pour les recherches uniquement.
Rediriger : redirige vos utilisateurs vers une page spécifique en fonction de la requête de recherche. Disponible uniquement pour la recherche.
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.

Pour obtenir des exemples de ces commandes, consultez À propos des commandes de diffusion

Utiliser la commande de redirection

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 :

Visite guidée

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éder à la page de création pour le type de contrôle que vous prévoyez de créer:

Créer un contrôle de boosting/rétrogradation
Créer une commande de filtrage
Créer une commande de redirection
Créer une commande de synonymes bidirectionnels
Créer une commande de synonymes à sens unique
Créer une commande de ne pas associer
Créer une commande "Ignorer"
Créer une commande de remplacement

Créer un contrôle de boosting/rétrogradation

Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles "Remonter/redescendre".

Ce type de commande est disponible pour la recherche recommandations.

Créer une commande d'amélioration/d'enterrement de la recherche
Créer un boosting/rétrogradation des recommandations

Créer un contrôle d'optimisation/rétrogradation de la recherche

Pour créer un contrôle d'amélioration/d'enterrement dans les résultats de recherche :

Console

Accédez à la page Paramètres de la console Search for Retail.

Accéder à la page "Commandes"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

Le volet Créer une commande s'ouvre.

Dans la section Préférences :

Dans le champ Nom de la commande, saisissez le nom de la nouvelle commande.
Facultatif: Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier et saisissez un nouvel ID de commande.
Dans la section Sélection de produits, sélectionnez Rechercher.
Sélectionnez le type de commande Commandes de boosting/rétrogradation.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

Dans la section Déclencheurs, définissez les conditions qui déclenchent la commande:

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.query est vide).
- Recherche : la règle est déclenchée lorsqu'un utilisateur effectue une recherche sur votre site (search.request.query n'est pas vide).
Vous pouvez définir des catégories ou des requêtes spécifiques pouvant déclencher ce contrôle à l'étape suivante. Pour définir cette commande de sorte qu'elle se déclenche lorsqu'une catégorie ou qu'une requête est recherchée, ignorez l'étape suivante.
Facultatif: définissez une condition de contrôle qui déclenche la règle si une une catégorie spécifique est parcouru ou une requête spécifique est recherchée.

Pour configurer cette commande pour qu'elle se déclenche sur n'importe quelle catégorie ou n'importe quelle requête, ignorez cette étape.

L'option disponible dépend de l'option que vous avez choisie : 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 Rechercher: cliquez sur le bouton Ajouter une requête pour ajouter une requête. les termes (par exemple, running shoes) à filtrer, et sélectionnez l'une des options suivantes pour chaque terme:
  - Correspondance partielle: cette commande s'applique lorsqu'une requête contient un une correspondance partielle à ce terme de requête.
  - Correspondance complète: cette commande ne s'applique que lorsqu'une requête contient un une correspondance complète à ce terme de requête.
  Lorsque l'un de ces termes est inclus dans une requête, le contrôle est appliqué.
Si vous spécifiez des conditions de période en plus de ce type de condition, le contrôle ne s'applique que si les deux conditions sont remplies.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs les périodes au cours desquelles ce paramètre peut être appliqué.

Si vous spécifiez une condition de catégorie ou de terme de requête en plus d'une condition de période, le contrôle ne s'applique que si les deux conditions sont remplies.
Cliquez sur Continuer pour accéder à la section Actions.

Dans 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", 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.

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 Évaluation 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 un Instance de Control contenue dans le corps de la requête.

Pour plus d'informations sur les champs, consultez les Documentation de référence de l'API Controls et Documentation de référence de l'API Controls.create

Une commande de boosting/rétrogradation peut être déclenchée lorsqu'un utilisateur parcourt les catégories de votre (search.request.query est vide) ou lorsqu'un utilisateur recherches sur votre site (search.request.query n'est pas vide).

L'exemple suivant montre les champs d'une commande déclenchée 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 Évaluation 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 les 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 d'optimisation/rétrogradation des recommandations

Pour créer un contrôle d'optimisation/rétrogradation des recommandations:

Console

Accédez à la page Commandes dans la console de la recherche pour les marchands.

Accéder à la page "Contrôles"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

Le volet Créer une commande s'ouvre.

Dans la section Préférences :

Dans le champ Nom de la commande, saisissez le nom de la nouvelle commande.
(Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier et saisissez un nouvel ID de commande.
Dans la section Sélection de produits, sélectionnez Recommandation.
Sélectionnez le type de commande Commandes de boosting/rétrogradation.
Cliquez sur Continuer pour accéder à la section Actions.

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

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 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 plus d'informations sur les champs, consultez les Documentation de référence de l'API Controls et 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 Filtrer les recommandations.

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"

Pour ajouter une commande à une configuration de diffusion, utilisez l'ServingConfig.addControl méthode:

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 Gérez 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

Accédez à la page Commandes dans la console de la recherche pour les marchands.

Accéder à la page "Contrôles"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

Le volet Créer une commande s'ouvre.

Dans la section Préférences :

Dans le champ Nom de la commande, saisissez le nom de la nouvelle commande.
Facultatif: Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier et saisissez un nouvel ID de commande.
Sélectionnez le type de commande Commandes de filtrage.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

Dans 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.query est vide).
- Recherche : la règle est déclenchée lorsqu'un utilisateur effectue une recherche sur votre site (search.request.query n'est pas vide).
Facultatif: définissez une condition de contrôle qui déclenche la règle en fonction la catégorie recherchée ou 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, saisissez les catégories qui déclencheront cette commande lors de la navigation.
- Si vous avez choisi Rechercher: cliquez sur le bouton Ajouter une requête pour ajouter une requête. les termes (par exemple, running shoes) à filtrer, et sélectionnez l'une des options suivantes pour chaque terme:
  - Correspondance partielle: cette commande s'applique lorsqu'une requête contient un une correspondance partielle à ce terme de requête.
  - Correspondance complète: cette commande ne s'applique que lorsqu'une requête contient un une correspondance complète à ce terme de requête.
  Lorsque l'un de ces termes est inclus dans une requête, le contrôle est appliqué.
Si vous spécifiez une condition de période en plus de cette condition, le n'est appliqué que si les deux conditions sont remplies.
Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs les périodes au cours desquelles ce paramètre peut être appliqué.

Si vous spécifiez une condition de catégorie ou de terme de requête en plus de cette condition de période, le contrôle ne s'applique que lorsque les deux conditions sont remplies.
Cliquez sur Continuer pour accéder à la section Actions.

Dans la section Actions:

Ajoutez des filtres pour les attributs de produit dans le champ Action de filtre.

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.

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 Évaluation 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.

Une commande de filtrage peut être déclenchée lorsqu'un utilisateur parcourt les catégories de votre (search.request.query est vide) ou lorsqu'un utilisateur recherches sur votre site (search.request.query n'est pas vide).

L'exemple suivant montre les champs d'une commande déclenchée 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 une commande à une configuration de diffusion, utilisez l'ServingConfig.addControl méthode:

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 redirection

Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles de redirection.

Console

Accédez à la page Paramètres de la console Search for Retail.

Accéder à la page "Commandes"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

Le volet Créer une commande s'ouvre.

Dans la section Préférences :

Dans le champ Nom de la commande, saisissez le nom de la nouvelle commande.
Facultatif: Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier et saisissez un nouvel ID de commande.
Sélectionnez le type de commande Commandes de redirection.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

Dans la section Déclencheurs, créez au moins un terme de requête ou une période. ou un déclencheur spécifique. 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 est déclenchée lorsqu'un utilisateur consulte catégories sur votre site (search.request.query est vide).
- Recherche : la règle est déclenchée lorsqu'un utilisateur effectue une recherche sur votre site (search.request.query n'est pas vide).
Définissez une condition de contrôle qui déclenche la règle la catégorie recherchée ou la requête recherchée. L'option disponible varie selon que vous avez choisi Parcourir les catégories ou Rechercher:
- Si vous avez choisi Parcourir les catégories: dans le champ Catégories, saisissez les catégories qui déclencheront cette commande lors de la navigation.
- Si vous avez choisi Rechercher: cliquez sur le bouton Ajouter une requête pour ajouter une requête. les termes (par exemple, running shoes) à filtrer, et sélectionnez l'une des options suivantes pour chaque terme:
  - Correspondance partielle: cette commande s'applique lorsqu'une requête contient un une correspondance partielle à ce terme de requête.
  - Correspondance complète: cette commande ne s'applique que lorsqu'une requête contient un une correspondance complète à ce terme de requête.
  Lorsque l'un de ces termes est inclus dans une requête, le contrôle est appliqué.
Si vous spécifiez une condition de période en plus de cette condition, le n'est appliqué que si les deux conditions sont remplies.
Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes au cours auquel cette commande peut être appliquée.

Si vous spécifiez une condition de catégorie ou de terme de requête en plus de cette condition de période, la commande n'est appliquée que lorsque les deux conditions sont remplies.
Cliquez sur Continuer pour accéder à la section Actions.

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

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 Évaluation 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 plus d'informations sur les champs, consultez les Documentation de référence de l'API Controls et Documentation de référence de l'API Controls.create

Une commande de redirection peut être déclenchée lorsqu'un utilisateur parcourt les catégories de votre (search.request.query est vide) ou lorsqu'un utilisateur recherches sur votre site (search.request.query n'est pas vide).

L'exemple suivant montre les champs d'une commande déclenchée 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 une commande à une configuration de diffusion, utilisez l'ServingConfig.addControl méthode:

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

Accédez à la page Commandes dans la console de la recherche pour les marchands.

Accéder à la page "Commandes"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.
Dans le champ Nom de la commande, saisissez le nom de la nouvelle commande.

Le volet Créer un contrôle s'ouvre.

Dans la section Préférences :

Facultatif: Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier et saisissez un nouvel ID de commande.
Sélectionnez le type de commande Commande des synonymes bidirectionnels.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

Dans la section Déclencheurs :

Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs les périodes au cours desquelles ce paramètre peut être appliqué.
Cliquez sur Continuer pour accéder à la section Actions.

Dans la section Actions :

Dans le champ Synonymes, saisissez entre deux et 100 termes de requête (par exemple, shirt et top) qui doivent être synonymes les uns des autres.

Lorsque l'un de ces termes est inclus dans une requête, le champ de 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.

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 Évaluation 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 un 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 une commande à une configuration de diffusion, utilisez la méthode ServingConfig.addControl. Voir Ajoutez des contrôles aux configurations de diffusion de façon 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

Accédez à la page Commandes dans la console de la recherche pour les marchands.

Accéder à la page "Contrôles"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

Le volet Créer une commande s'ouvre.

Dans la section Préférences :

Dans le champ Nom de la commande, saisissez le nom de la 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.

Dans la section Déclencheurs :

Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs les périodes au cours desquelles ce paramètre peut être appliqué.
Cliquez sur Continuer pour accéder à la section Actions.

Dans la section Actions:

Dans le champ Termes de requête, saisissez des termes (par exemple, shoes) qui doivent être associés à des synonymes lorsque l'un d'entre eux est inclus dans une requête.
Dans le champ Synonymes, saisissez les termes à utiliser comme synonymes. pour les termes de requête que vous avez spécifiés (par exemple, sneakers et sandals) comme synonymes unidirectionnels pour le terme de requête shoes).
Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

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 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 un Instance de Control contenue dans le corps de la requête.

Pour plus d'informations sur les champs, consultez les Documentation de référence de l'API Controls et 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 Gérez les configurations de diffusion.

Créer une commande de ne pas associer

Pour en savoir plus, consultez la section Commandes "Ne pas associer". de contrôle d'accès.

Console

Accédez à la page Paramètres de la console Search for Retail.

Accéder à la page "Contrôles"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

Le volet Créer une commande s'ouvre.

Dans la section Préférences :

Dans le champ Nom de la commande, saisissez le nom de la nouvelle commande.
Facultatif: Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier et saisissez un nouvel ID de commande.
Sélectionnez le type de commande Ne pas associer la commande.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

Dans la section Déclencheurs :

Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs les périodes au cours desquelles ce paramètre peut être appliqué.
Cliquez sur Continuer pour accéder à la section Actions.

Dans la section Actions:

Dans le champ Termes de requête, saisissez des termes (par exemple, gShoe). que vous voulez distinguer explicitement des autres.
Dans le champ Termes dissociés, saisissez les termes qui ne doivent pas être associés aux 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 gShoe du terme cheap
Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

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 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 un Instance de Control contenue dans le corps de la requête.

Pour plus d'informations sur les champs, consultez les Documentation de référence de l'API Controls et 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

Accédez à la page Paramètres de la console Search for Retail.

Accéder à la page "Commandes"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

Le volet Créer une commande s'ouvre.

Dans la section Préférences :

Dans le champ Nom de la commande, saisissez le nom de la nouvelle commande.
Facultatif: Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier et saisissez un nouvel ID de commande.
Sélectionnez le type de commande Ne pas associer la commande.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

Dans la section Déclencheurs :

Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs les périodes au cours desquelles ce paramètre peut être appliqué.
Cliquez sur Continuer pour accéder à la section Actions.

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

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 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 plus d'informations sur les champs, consultez les Documentation de référence de l'API Controls et 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 une commande à une configuration de diffusion, utilisez l'ServingConfig.addControl méthode:

Pour en savoir plus sur cette méthode, consultez les Documentation de référence de l'API ServingConfig.addControl
Pour obtenir un exemple de cette méthode, consultez Gérez les configurations de diffusion.

Créer un contrôleur de remplacement

Pour en savoir plus sur ce type de contrôle, consultez la section Contrôles de type "Remplacer".

Console

Accédez à la page Commandes dans la console de la recherche pour les marchands.

Accéder à la page "Contrôles"
Dans l'onglet Contrôles de diffusion, cliquez sur Créer un contrôle.

Le volet Créer une commande s'ouvre.

Dans la section Préférences :

Dans le champ Nom de la commande, saisissez le nom de la nouvelle commande.
Facultatif : Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.
Sélectionnez le type de commande Commande de remplacement.
Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

Dans la section Déclencheurs :

Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs les périodes au cours desquelles ce paramètre peut être appliqué.
Cliquez sur Continuer pour accéder à la section Actions.

Dans la section Actions :

Dans le champ Termes de requête, saisissez les termes de la requête (par exemple, gShoe) que vous souhaitez remplacer par la condition de remplacement.
Dans le champ Terme de remplacement, saisissez le terme qui doit remplacer le que vous avez spécifiés.

Par exemple, vous pouvez remplacer le terme de requête gShoe par le texte de remplacement Google Shoe.
Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

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 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 plus d'informations sur les champs, consultez les Documentation de référence de l'API Controls et 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 les Documentation de référence de l'API ServingConfig.addControl
Pour obtenir un exemple de cette méthode, consultez Gérez les configurations de diffusion.