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

Gérer les configurations de diffusion

Cette page explique comment supprimer, modifier et répertorier des configurations de diffusion ainsi que des statistiques d'examen pour chaque configuration.

Pour savoir comment créer une configuration de diffusion, consultez Créer des configurations de diffusion.

Si vous disposez d'emplacements ou créez des emplacements, l'API Retail crée automatiquement une configuration de diffusion associée à chaque emplacement. La création d'une configuration de diffusion ne crée pas un emplacement correspondant. La suppression d'une configuration de diffusion entraîne la suppression de l'emplacement correspondant et de la suppression de la configuration de diffusion correspondante.

Modifier la configuration de diffusion

Vous pouvez modifier les configurations de diffusion à l'aide de la console Retail ou de l'API Retail.

Modifier les configurations de diffusion dans la console

Vous pouvez consulter et modifier les contrôles associés à chaque configuration de diffusion sur la page Configurations de diffusion. Cliquez sur une configuration de diffusion pour afficher sa page Détails qui répertorie toutes les commandes de diffusion et l'ensemble du site pour cette configuration.

Sur cette page, vous pouvez modifier des contrôles, créer des contrôles ou appliquer des contrôles existants à la configuration.

Quelques minutes peuvent être nécessaires pour que les configurations de diffusion nouvellement créées ou mises à jour soient prêtes à diffuser le trafic en temps réel. Vous pouvez tester les modifications immédiatement sur la page Évaluer.

Modifier les configurations de diffusion de façon intégrée

Vous pouvez mettre à jour les champs de configuration de diffusion, ajouter des contrôles de diffusion et supprimer des contrôles de diffusion intégrés à l'aide des méthodes de l'API Retail.

Appliquer des correctifs aux configurations de diffusion

Pour mettre à jour les champs d'une configuration de diffusion, utilisez ServingConfig.patch et incluez une instance de ServingConfig 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 ServingConfig.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/servingConfigs/SERVING_CONFIG_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/servingConfigs/SERVING_CONFIG_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. La commande est ajoutée à la dernière position de la liste de commandes à laquelle elle appartient. Par exemple, une commande facetSpec est appliquée à la dernière position de servingConfig.facetSpecIds.

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

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

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

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

Afficher les configurations de diffusion

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

Afficher les configurations de diffusion dans la console

Vous pouvez afficher toutes vos configurations de diffusion sur la page Configurations de diffusion.

Afficher les configurations de diffusion intégrées

Pour afficher une seule configuration de diffusion intégrée, utilisez ServingConfig.get.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API ServingConfig.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/servingConfigs/SERVING_CONFIG_ID'

Pour répertorier toutes les configurations de diffusion de façon intégrée, utilisez ServingConfig.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 en savoir plus sur cette méthode, consultez la documentation de référence de l'API ServingConfig.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/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Supprimer une configuration de diffusion

Vous pouvez supprimer les configurations de diffusion à l'aide de la console Retail ou de l'API Retail.

Supprimer des configurations de diffusion dans la console

Pour supprimer une configuration de diffusion dans la console, procédez comme suit:

  1. Accédez à la page "Configurations de diffusion" de Google Cloud Console.

    Accéder à la page "Configurations de diffusion"

  2. Cliquez sur la configuration de diffusion que vous souhaitez supprimer pour ouvrir la page d'informations associée.

  3. Cliquez sur Arrêter dans la barre de boutons située en haut de la page.

  4. Si la configuration de diffusion est considérée comme active, vous devez ressaisir son ID et cliquer sur Confirmer pour terminer la suppression.

Supprimer une configuration de diffusion intégrée

Pour supprimer une seule configuration de diffusion de façon intégrée, utilisez ServingConfig.delete.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API ServingConfig.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/servingConfigs/SERVING_CONFIG_ID'

Examiner les statistiques de configuration de diffusion

Vous pouvez consulter les détails de chaque configuration de diffusion sur la page Configurations de diffusion. Pour n'importe quelle configuration du tableau, cliquez sur Afficher les analyses pour afficher ses statistiques.

Le taux de clics indique le nombre de clics par recherche pour la configuration de diffusion. Le taux de conversion indique les achats par recherche pour la configuration.