Ce document concerne Recommendations AI, Retail Search et la nouvelle console Retail.

Créer et gérer des commandes

Cette page explique comment ajouter, afficher, modifier et supprimer des contrôles.

  • Les contrôles de diffusion sont des règles que vous définissez et appliquez à des configurations de diffusion Retail Search individuelles. Pour en savoir plus sur les configurations de diffusion, consultez la section Configurations de diffusion.
  • Les contrôles sur l'ensemble du site s'appliquent à tous vos résultats Retail Search.

Contrôles de diffusion

Les contrôles de diffusion vous permettent de créer des règles qui personnalisent la manière dont vos configurations de diffusion diffusent les résultats de recherche.

Vous pouvez créer une commande de diffusion dans Cloud Console composée d'une condition, qui déclenche la commande, et d'une action qui se produit lorsque la condition est déclenchée. Vous pouvez ensuite associer le nouveau contrôle de diffusion à n'importe laquelle des configurations de diffusion Retail Search que vous avez créées.

Les configurations de diffusion Retail Search ont une relation multi-relationnelle avec les contrôles. Vous pouvez ajouter plusieurs contrôles à une configuration de diffusion, et un même contrôle peut être associé à plusieurs configurations de diffusion.

Les configurations de diffusion déterminent quelles commandes peuvent être appliquées. Seuls les contrôles de la configuration de diffusion active d'une requête sont pris en compte au moment de la diffusion.

Vous pouvez créer des contrôles, puis les ajouter ou les échanger dans une configuration de diffusion Retail Search active.

Créez ou modifiez des commandes de diffusion à tout moment sur la page Contrôles ou intégrées à 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'à 1 000 contrôles de diffusion. Une configuration de diffusion peut comporter jusqu'à 100 contrôles de n'importe quel type, en plus des contrôles 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.
  • Filtrer : supprime les résultats qui ne respectent pas le filtre de la liste des résultats renvoyés.
  • Rediriger : redirige vos utilisateurs vers une page spécifique en fonction de la requête de recherche.
  • Linguistique : personnalise la linguistique des requêtes de recherche. 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 la section Commandes de diffusion.

Utiliser la commande de redirection

Ce tutoriel vous explique comment utiliser la commande de redirection.


Pour obtenir des conseils détaillés sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :

Visite guidée


La procédure décrite dans les sections suivantes, est la même que si vous cliquez sur Visite guidée.

Créer un contrôle de diffusion

Créez une commande de diffusion sur la page Contrôles de Google Cloud Console ou directement à l'aide de la méthode Controls.create.

Les commandes peuvent avoir des exigences différentes selon leur type. Accédez à la procédure de création correspondant au type de contrôle que vous prévoyez de créer:

Créer une commande de rehaussement/bury

Pour en savoir plus sur ce type de commande, consultez la section Commandes de type "Boost/bury".

Console

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

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

    Le volet Create control (Créer une commande) s'ouvre.

Dans la section Préférences:

  1. Dans le champ Nom de la commande, attribuez un nom à votre nouvelle commande.

  2. (Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier sous le champ Nom du contrôle, puis saisissez un nouvel ID.

  3. Choisissez le type de commande Commandes d'optimisation/d'enfouissement.

  4. Cliquez sur "Continuer" pour passer à la section Déclencheurs.

Dans la section Déclencheurs:

  1. (Facultatif) Cliquez sur le bouton Ajouter une requête pour ajouter des termes de requête (par exemple, running shoes) à booster ou enterrer, 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.

      Lorsqu'une requête contient l'un de ces termes, le contrôle est appliqué.

    Si vous spécifiez une condition de plage de temps en plus de cette condition, le contrôle n'est appliqué que si les deux conditions sont remplies.

  2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs plages durant lesquelles cette commande peut être appliquée.

    Si vous spécifiez une condition de terme de requête en plus de cette période, le contrôle ne s'applique que lorsque les deux conditions sont remplies.

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

Dans la section Actions:

  1. Ajoutez des filtres pour les attributs de produit dans le champ Booster/bury_product.

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

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

  3. Cliquez sur Continuer pour passer à la section Configurations de diffusion.

Dans la section Configurations de diffusion:

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

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

Exécutez une requête Control.create avec un ID de contrôle et une instance de Control 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": {
                  "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 une commande à une configuration de diffusion, utilisez la méthode ServingConfig.addControl. Consultez la section Ajouter des commandes intégrées à la configuration de diffusion.

Créer une commande de filtrage

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

Console

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

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

    Le volet Create control (Créer une commande) s'ouvre.

Dans la section Préférences:

  1. Dans le champ Nom de la commande, attribuez un nom à votre nouvelle commande.

  2. (Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier sous le champ Nom du contrôle, puis saisissez un nouvel ID.

  3. Sélectionnez Commandes de filtrage comme type de commande.

  4. Cliquez sur "Continuer" pour passer à la section Déclencheurs.

Dans la section Déclencheurs:

  1. (Facultatif) 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.

    Lorsqu'une requête contient l'un de ces termes, le contrôle est appliqué.

    Si vous spécifiez une condition de plage de temps en plus de cette condition, le contrôle n'est appliqué que si les deux conditions sont remplies.

  2. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs plages durant lesquelles cette commande peut être appliquée.

    Si vous spécifiez une condition de terme de requête en plus de cette période, le contrôle ne s'applique que lorsque les deux conditions sont remplies.

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

Dans la section Actions:

  1. Ajoutez des filtres pour les attributs de produit 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"))

  2. Cliquez sur Continuer pour passer à la section Configurations de diffusion.

Dans la section Configurations de diffusion:

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

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

Exécutez une requête Control.create avec un ID de contrôle et une instance de Control 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.

Cet exemple présente les champs

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": {
                  "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"
                    }
                  ]
                },
                "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 la méthode ServingConfig.addControl. Consultez la section Ajouter des commandes intégrées à la configuration de diffusion.

Créer une commande de redirection

Pour plus d'informations sur ce type de commande, consultez l'article Commandes de redirection.

Console

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

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

    Le volet Create control (Créer une commande) s'ouvre.

Dans la section Préférences:

  1. Dans le champ Nom de la commande, attribuez un nom à votre nouvelle commande.

  2. (Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier sous le champ Nom du contrôle, puis saisissez un nouvel ID.

  3. Choisissez le type de commande Commandes de redirection.

  4. Cliquez sur "Continuer" pour passer à la section Déclencheurs.

Dans la section Déclencheurs, créez au moins un terme de requête ou un déclencheur de plage de temps. Les commandes de redirection nécessitent au moins un déclencheur:

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

    Lorsqu'une requête contient l'un de ces termes, le contrôle est appliqué.

    Si vous spécifiez une condition de plage de temps en plus de cette condition, le contrôle n'est appliqué que si les deux conditions sont remplies.

  2. Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs plages de dates pendant lesquelles cette commande peut être appliquée.

    Si vous spécifiez une condition de terme de requête en plus de cette période, le contrôle ne s'applique que lorsque les deux conditions sont remplies.

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

Dans la section Actions:

  1. Saisissez l'URI vers lequel rediriger l'utilisateur lorsque cette commande est déclenchée.

  2. Cliquez sur Continuer pour passer à la section Configurations de diffusion.

Dans la section Configurations de diffusion:

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

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

Exécutez une requête Control.create avec un ID de contrôle et une instance de Control 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": {
                  "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 la méthode ServingConfig.addControl. Consultez la section Ajouter des commandes intégrées à la configuration de diffusion.

Créer une commande de synonyme à double sens

Pour en savoir plus sur ce type de commande, consultez la section Commandes de synonymes bidirectionnels.

Console

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

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

  3. Dans le champ Nom de la commande, attribuez un nom à votre nouvelle commande.

    Le volet Create control (Créer une commande) s'ouvre.

Dans la section Préférences:

  1. (Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier sous le champ Nom du contrôle, puis saisissez un nouvel ID.

  2. Choisissez le type de commande Commande de synonymes bidirectionnel.

  3. Cliquez sur "Continuer" pour passer à la section Déclencheurs.

Dans la section Déclencheurs:

  1. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs plages durant lesquelles cette commande peut être appliquée.

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

Dans la section Actions:

  1. Dans le champ Synonymes, saisissez entre 2 et 100 termes de requête (par exemple, shirt et top) qui doivent être synonymes.

    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.

  2. Cliquez sur Continuer pour passer à la section Configurations de diffusion.

Dans la section Configurations de diffusion:

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

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

Exécutez une requête Control.create avec un ID de contrôle et une instance de Control 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. Consultez la section Ajouter des commandes intégrées à la configuration de diffusion.

Créer un contrôle de synonyme à sens unique

Pour en savoir plus sur ce type de commande, consultez la section Commandes de sens unique.

Console

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

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

    Le volet Create control (Créer une commande) s'ouvre.

Dans la section Préférences:

  1. Dans le champ Nom de la commande, attribuez un nom à votre nouvelle commande.

  2. (Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier sous le champ Nom du contrôle, puis saisissez un nouvel ID.

  3. Choisissez le contrôle des synonymes à sens unique.

  4. Cliquez sur "Continuer" pour passer à la section Déclencheurs.

Dans la section Déclencheurs:

  1. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs plages durant lesquelles cette commande peut être appliquée.

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

Dans la section Actions:

  1. Dans le champ Termes de requête, saisissez les termes (par exemple, shoes) qui doivent être associés à des synonymes lorsqu'ils sont inclus dans une requête.

  2. Dans le champ Synonymes, saisissez les termes à utiliser comme synonymes pour les termes de la requête que vous avez spécifiés (par exemple, sneakers et sandals comme synonymes à sens unique pour le terme de requête shoes).

  3. Cliquez sur Continuer pour passer à la section Configurations de diffusion.

Dans la section Configurations de diffusion:

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

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

Exécutez une requête Control.create avec un ID de contrôle et une instance de Control 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 une commande à une configuration de diffusion, utilisez la méthode ServingConfig.addControl. Consultez la section Ajouter des commandes intégrées à la configuration de diffusion.

Créer une commande "Ne pas associer"

Pour plus d'informations sur ce type de commande, consultez la section Commandes "Ne pas associer".

Console

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

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

    Le volet Create control (Créer une commande) s'ouvre.

Dans la section Préférences:

  1. Dans le champ Nom de la commande, attribuez un nom à votre nouvelle commande.

  2. (Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier sous le champ Nom du contrôle, puis saisissez un nouvel ID.

  3. Sélectionnez le type de commande Ne pas associer la commande.

  4. Cliquez sur "Continuer" pour passer à la section Déclencheurs.

Dans la section Déclencheurs:

  1. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs plages durant lesquelles cette commande peut être appliquée.

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

Dans la section Actions:

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

  2. Dans le champ Termes dissociés, saisissez les termes qui ne doivent pas être associés dans les résultats de recherche aux termes de la requête que vous avez spécifiés.

    Par exemple, vous pouvez dissocier le terme de requête gShoe du terme cheap.

  3. Cliquez sur Continuer pour passer à la section Configurations de diffusion.

Dans la section Configurations de diffusion:

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

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

Exécutez une requête Control.create avec un ID de contrôle et une instance de Control 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 une commande à une configuration de diffusion, utilisez la méthode ServingConfig.addControl. Consultez la section Ajouter des commandes intégrées à la configuration de diffusion.

Créer une commande "Ignorer"

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

Console

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

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

    Le volet Create control (Créer une commande) s'ouvre.

Dans la section Préférences:

  1. Dans le champ Nom de la commande, attribuez un nom à votre nouvelle commande.

  2. (Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier sous le champ Nom du contrôle, puis saisissez un nouvel ID.

  3. Sélectionnez le type de commande Ne pas associer la commande.

  4. Cliquez sur "Continuer" pour passer à la section Déclencheurs.

Dans la section Déclencheurs:

  1. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs plages durant lesquelles cette commande peut être appliquée.

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

Dans la section Actions:

  1. Dans le champ Ignorer les termes, saisissez les termes (par exemple, shoddy) que vous souhaitez ignorer lorsqu'ils sont saisis en tant que termes de requête.

  2. Cliquez sur Continuer pour passer à la section Configurations de diffusion.

Dans la section Configurations de diffusion:

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

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

Exécutez une requête Control.create avec un ID de contrôle et une instance de Control 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 une commande à une configuration de diffusion, utilisez la méthode ServingConfig.addControl. Consultez la section Ajouter des commandes intégrées à la configuration de diffusion.

Créer une commande de remplacement

Consultez la section Commandes de remplacement pour en savoir plus sur ce type de commande.

Console

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

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

    Le volet Create control (Créer une commande) s'ouvre.

Dans la section Préférences:

  1. Dans le champ Nom de la commande, attribuez un nom à votre nouvelle commande.

  2. (Facultatif) Pour modifier l'ID de contrôle créé automatiquement, cliquez sur Modifier sous le champ Nom du contrôle, puis saisissez un nouvel ID.

  3. Sélectionnez le type de commande Commande de remplacement.

  4. Cliquez sur "Continuer" pour passer à la section Déclencheurs.

Dans la section Déclencheurs:

  1. (Facultatif) Cliquez sur le bouton Ajouter une période pour ajouter une ou plusieurs plages durant lesquelles cette commande peut être appliquée.

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

Dans la section Actions:

  1. Dans le champ Termes de requête, saisissez les termes de la requête (par exemple, gShoe) que vous souhaitez remplacer par le terme de remplacement.

  2. Dans le champ Terme de remplacement, saisissez le terme à utiliser pour 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.

  3. Cliquez sur Continuer pour passer à la section Configurations de diffusion.

Dans la section Configurations de diffusion:

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

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

Exécutez une requête Control.create avec un ID de contrôle et une instance de Control 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 une commande à une configuration de diffusion, utilisez la méthode ServingConfig.addControl. Consultez la section Ajouter des commandes intégrées à la configuration de diffusion.

Vous trouverez le nouveau contrôle dans l'onglet Contrôles de diffusion de la page "Contrôles".

Afficher et modifier les commandes de diffusion

Vous pouvez afficher les contrôles de la diffusion à l'aide de la console Retail ou de l'API Retail.

Afficher et modifier les commandes de diffusion dans la console

L'onglet Commandes de diffusion de la page "Commandes" répertorie toutes vos commandes de diffusion et leurs configurations de diffusion associées. Cliquez sur l'icône Modifier la commande pour modifier les paramètres et les configurations de diffusion associées dans le panneau Modifier la commande. Cliquez sur l'icône Supprimer la commande pour supprimer une commande qui la supprimera également de toutes les configurations de diffusion.

Vous pouvez également afficher et modifier les commandes d'une configuration de diffusion spécifique sur la page Configurations de diffusion. Cliquez sur une configuration de diffusion pour afficher la page Détails correspondante, qui répertorie toutes les commandes de diffusion associées à cette configuration. Cliquez sur l'icône Modifier la commande pour mettre à jour ses paramètres dans le panneau Modifier la commande. Cliquez sur l'icône Supprimer la commande pour dissocier la commande de la configuration de diffusion (la commande n'est pas supprimée).

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.

Afficher les commandes de diffusion intégrées

Pour afficher une seule commande de diffusion intégrée, utilisez Control.get.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API Control.get.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID'

Pour répertorier les commandes de diffusion de façon intégrée, utilisez Controls.list.

Vous pouvez éventuellement utiliser le paramètre pageSize pour définir le nombre maximal de résultats à afficher. Si d'autres résultats sont disponibles, la réponse list inclut un jeton. Vous pouvez transmettre un jeton de page dans le paramètre pageToken d'une requête list pour récupérer la page de résultats suivante.

Pour répertorier uniquement les contrôles associés à une configuration de diffusion donnée, utilisez le paramètre de requête filter afin de spécifier l'ID de la configuration de diffusion.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API Control.list.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Commandes de diffusion de correctifs intégrées

Pour mettre à jour les champs d'une commande de diffusion, utilisez Controls.patch et incluez une instance de Control dans le corps de la requête. Spécifiez les champs à mettre à jour avec le paramètre updateMask, ou laissez-les non définis pour mettre à jour tous les champs compatibles.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API Controls.patch.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Ajouter des contrôles aux configurations de diffusion intégrées

Pour ajouter une commande à une configuration de diffusion, utilisez 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érer les configurations de diffusion.

Supprimer les contrôles des configurations de diffusion intégrées

Pour supprimer une commande d'une configuration de diffusion, utilisez ServingConfig.removeControl.

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érer les configurations de diffusion.

Supprimer un contrôle de diffusion

Vous pouvez supprimer une commande de diffusion depuis la console ou de manière intégrée à l'aide de la méthode Controls.delete.

Supprimer une commande de diffusion dans la console

Supprimez une commande de diffusion pour supprimer cette commande de toutes les configurations de diffusion qui l'utilisent.

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

  2. Dans la ligne du tableau correspondant au contrôle que vous souhaitez supprimer, cliquez sur Supprimer.

  3. Dans la fenêtre de confirmation, cliquez sur Supprimer pour terminer la suppression.

Supprimer une commande de diffusion intégrée

Pour supprimer directement les commandes de diffusion, utilisez Controls.delete.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API Controls.delete.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/SERVING_CONTROL_ID'

Contrôles à l'échelle du site

Les contrôles à l'échelle du site vous permettent de gérer les paramètres de façon globale pour toutes les configurations de diffusion.

Contrôles d'attributs

Des commandes d'attributs à l'échelle du site sont disponibles dans Cloud Console pour les attributs de produit de votre catalogue.

Les contrôles d'attributs à l'échelle du site sont les suivants :

  • Indexable : Retail Search peut filtrer les résultats en fonction de cet attribut.
  • Attribut dynamique : Retail Search peut utiliser automatiquement cet attribut en tant qu'attribut dynamique en se basant sur le comportement passé des utilisateurs (clics et vues par exemple). Pour activer l'option d'attribut dynamique pour un attribut, Indexable doit être défini sur "true" pour cet attribut.
  • Inclus dans l'index de recherche : cet attribut peut être trouvé par les requêtes Retail Search, ce qui augmente le nombre de rappels pour cet attribut. Ce contrôle ne s'applique qu'aux attributs de texte.

Vous pouvez activer ou désactiver les contrôles d'attributs à l'échelle du site pour des attributs individuels.

Les attributs dynamiques sont disponibles en tant que contrôle des attributs à l'échelle du site. Par défaut, les attributs dynamiques sont activés pour tous les attributs personnalisés.

En mode de configuration au niveau du catalogue, des contrôles d'attributs à l'échelle du site sont disponibles pour l'indexation et la recherche.

Pour en savoir plus sur les configurations d'attribut et sur leurs paramètres par défaut et autorisés, consultez la page Configurer les attributs.

Définir des contrôles d'attributs à l'échelle du site

Définissez une commande d'attribut sur l'ensemble du site sur la page Contrôles de Google Cloud Console.

La configuration des contrôles d'attributs à l'échelle du site est disponible en mode de configuration au niveau du catalogue par défaut. Auparavant, la configuration au niveau du produit était le mode par défaut. Si vous êtes toujours en mode configuration au niveau du produit et que vous devez changer de mode, contactez l'assistance commerciale.

  1. Accédez à la page "Commandes relatives à la vente au détail" dans Google Cloud Console.

    Accéder à la page "Contrôles"

  2. Accédez à l'onglet Contrôles à l'échelle du site.

    Cet onglet affiche un tableau de tous les attributs de produit pour lesquels vous pouvez définir des contrôles à l'échelle du site.

  3. Cliquez sur Modifier les contrôles.

  4. Activez ou désactivez un contrôle.

    • True : activez un contrôle pour cet attribut. Cette règle remplace toute configuration d'attribut au niveau du produit dans l'API Retail.
    • False : désactive un contrôle pour cet attribut. Cette règle remplace toute configuration d'attribut au niveau du produit dans l'API Retail.

      Notez que vous ne pouvez définir l'attribut dynamique sur "true" que pour les attributs qui sont également définis sur "indexable".

  5. Cliquez sur Enregistrer les contrôles.

    Les modifications apportées aux paramètres de configuration d'attribut pour les propriétés indexables et incluses dans l'index de recherche prennent effet dans un délai de 12 heures, ou immédiatement lors de votre prochaine ingestion de catalogue. Les modifications de configuration de l'option "attribut dynamique" peuvent nécessiter jusqu'à deux jours pour prendre effet. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer, qui les reflétera immédiatement.