Créer des contrôles de diffusion

Console

1. Accédez à la page Commandes dans la console de la recherche pour les marchands.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.

4. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Dans la section Sélection de produits, sélectionnez Rechercher.

6. Sélectionnez Contrôles "Remonter/redescendre" comme type de contrôle. Cliquez sur Continuer.

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

8. 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 spécifique 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.

9. Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.

10. Cliquez sur Continuer pour accéder à la section Actions.

11. 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"))

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

13. Dans la section Configurations de diffusion, sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les marchands.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.

4. (Facultatif) Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Dans la section Sélection de produits, sélectionnez Recommandation.

6. Choisissez Contrôles "Remonter/redescendre" comme type de contrôle.

7. Cliquez sur Continuer pour accéder à la section Actions.

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

   Utilisez la syntaxe d'expression de filtre décrite dans 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"))

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

10. Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

11. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les établissements commerciaux.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.

4. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Choisissez Contrôles de filtrage comme type de contrôle.

6. Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

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

8. 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 des 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é.

9. Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.

10. Cliquez sur Continuer pour accéder à la section Actions.

11. 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"))

12. Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

13. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les marchands.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.

4. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Choisissez Contrôles de redirection comme type de contrôle.

6. Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

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

8. 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).

9. 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 des 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é.

10. Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles cette commande peut s'appliquer.

11. Cliquez sur Continuer pour accéder à la section Actions.

12. Saisissez l'URI vers lequel effectuer la redirection lorsque cette commande est déclenchée.

13. Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

14. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les établissements commerciaux.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

3. Dans le champ Nom du contrôle, saisissez un nom pour votre nouveau contrôle.

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

4. Vous accédez alors à la section Préférences.

5. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

6. Choisissez Commande de synonymes bidirectionnels comme type de contrôle.

7. Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

8. Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.

9. Cliquez sur Continuer pour accéder à la section Actions.

10. 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, la recherche considère les autres termes de la requête comme des synonymes du terme inclus.

11. Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

12. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les marchands.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.

4. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Choisissez Contrôle des synonymes unidirectionnel comme type de contrôle.

6. Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

7. Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.

8. Cliquez sur Continuer pour accéder à la section Actions.

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

10. 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, sneakers et sandals comme synonymes unidirectionnels pour le terme de requête shoes).

11. Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

12. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les marchands.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.

4. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Sélectionnez Contrôle "Ne pas associer" comme type de contrôle.

6. Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

7. Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.

8. Cliquez sur Continuer pour accéder à la section Actions.

9. Dans le champ Termes de requête, saisissez les termes (par exemple, gShoe) que vous souhaitez distinguer explicitement des autres.

10. 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 gShoe du terme cheap.

11. Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

12. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les établissements commerciaux.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.

4. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Sélectionnez Contrôle "Ne pas associer" comme type de contrôle.

6. Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

7. Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.

8. Cliquez sur Continuer pour accéder à la section Actions.

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

10. Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

11. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les marchands.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans la section Préférences, dans le champ Nom de la commande, saisissez un nom pour votre nouvelle commande.

4. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Sélectionnez Contrôle de remplacement comme type de contrôle.

6. Cliquez sur "Continuer" pour accéder à la section Déclencheurs.

7. Facultatif: Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs périodes auxquelles ce contrôle peut s'appliquer.

8. Cliquez sur Continuer pour accéder à la section Actions.

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

10. 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 gShoe par le terme de remplacement Google Shoe.

11. Cliquez sur Continuer pour accéder à la section Configurations de diffusion.

12. Sélectionnez les configurations de diffusion auxquelles appliquer le contrôle.

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

Console

1. Accédez à la page Commandes dans la console de la recherche pour les marchands.
   
   Accéder à la page "Contrôles"

2. Dans l'onglet Contrôles de diffusion, cliquez sur add_boxCréer un contrôle.

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

3. Dans le champ Nom de la commande de la section Préférences, saisissez un nom pour votre nouvelle commande.

4. Facultatif: Pour modifier l'ID de commande créé automatiquement, cliquez sur Modifier, puis saisissez un nouvel ID de commande.

5. Dans la section Sélection de produits, sélectionnez Rechercher ou Parcourir.

6. Choisissez Commande d'épinglage comme type de commande. Cliquez sur Continuer.

7. Dans la section Déclencheurs, sélectionnez le comportement utilisateur qui déclenche cette commande:

   • Parcourir les catégories: le champ page_categories doit être renseigné dans les requêtes de navigation, et le champ search.request.query doit ê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 recherchées déclenchent cette commande.

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

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

10. 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 broches dans la carte des broches de n'importe quel contrôle. La position peut être comprise entre 1 et 120 (taille maximale de la page de requête).

11. 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 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 être le 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.

Console

1. Accédez à la page Évaluer dans la console de la recherche pour le commerce.
   
   Accéder à la page "Évaluer"

2. Accédez à l'onglet Recherche.

3. Saisissez une requête de test dans le champ de requête de recherche.

4. Cliquez sur Aperçu de la recherche.

5. 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"