Cette page explique comment supprimer, modifier et répertorier des configurations de diffusion ainsi que des statistiques d'examen pour chaque configuration.
Pour obtenir de l'aide concernant la création d'une configuration de diffusion, consultez la section Créer des configurations de diffusion.
Si vous disposez d'emplacements existants ou si vous créez de nouveaux emplacements, Vertex AI Search pour le commerce crée automatiquement une configuration de diffusion associée à chaque emplacement. La création d'une configuration de diffusion ne crée pas d'emplacement correspondant. La suppression d'une configuration de diffusion entraîne la suppression de l'emplacement correspondant, et la suppression d'un emplacement entraîne la suppression de la configuration de diffusion correspondante.
Modifier les configurations de diffusion
Vous pouvez modifier les configurations de diffusion à l'aide de la console Search for Retail ou de l'API.
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 tous les contrôles de diffusion et à l'échelle 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 manière intégrée
Vous pouvez mettre à jour les champs de configuration de la diffusion, ajouter des commandes de diffusion et supprimer des commandes de diffusion intégrées à l'aide de méthodes d'API.
Appliquer des correctifs aux configurations de diffusion de manière intégrée
Pour mettre à jour des champs dans 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-le non défini 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 commandes aux configurations de diffusion de manière intégrée
Pour ajouter un contrôle à une configuration de diffusion, utilisez ServingConfig.addControl.
La commande est ajoutée à la dernière position de la liste des commandes auxquelles elle appartient.
Par exemple, un contrôle facetSpec est appliqué à 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 commandes des configurations de diffusion intégrées
Pour supprimer un contrôle 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 Search for Retail ou de l'API.
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 en ligne
Pour afficher une seule configuration de diffusion en ligne, 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 en ligne, utilisez ServingConfig.list.
Vous pouvez éventuellement utiliser le paramètre pageSize pour définir un nombre maximal de résultats à renvoyer. Si d'autres résultats sont disponibles, la réponse list inclut un jeton de page. 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 des configurations de diffusion à l'aide de la console Search for Retail ou de l'API.
Supprimer des configurations de diffusion dans la console
Pour supprimer une configuration de diffusion dans la console:
Accédez à la page Configurations de diffusion dans la console Search for Retail.
Accéder à la page "Configurations de diffusion"Cliquez sur la configuration de diffusion que vous souhaitez supprimer pour ouvrir sa page d'informations.
Cliquez sur deleteArrêter dans la barre de boutons située en haut de la page.
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 en ligne, 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.