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 obtenir de l'aide concernant la création d'une configuration de diffusion, consultez 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 l'emplacement correspondant. La suppression d'une configuration de diffusion supprime ses l'emplacement correspondant, et la suppression d'un emplacement entraîne la suppression la configuration de diffusion.

Modifier les configurations de diffusion

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

Remarque :Si vous apportez des modifications importantes à une configuration de diffusion contenant un modèle d'optimisation au niveau de la page, il risque de ne pas donner les meilleurs résultats à nouveau. Comme le réentraînement du modèle d'optimisation au niveau de la page peut prendre beaucoup de temps, envisagez de recréer le modèle d'optimisation au niveau de la page et la configuration de diffusion associée.

Modifier les configurations de diffusion dans la console

Vous pouvez afficher et modifier les commandes de chaque configuration de diffusion sur la Page "Configurations de diffusion" Cliquez sur un configuration de diffusion pour voir sa page Détails, qui répertorie toutes les ressources de diffusion et des contrôles à 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 façon intégrée

Vous pouvez mettre à jour les champs de configuration de diffusion, ajouter des commandes de diffusion et supprimer des commandes de diffusion intégrées à l'aide de méthodes d'API.

Intégrer des configurations de diffusion de correctifs

Pour mettre à jour les champs d'une configuration de diffusion, utilisez ServingConfig.patch et inclure 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 intégrées aux configurations de diffusion

Pour ajouter une commande à une configuration de diffusion, utilisez ServingConfig.addControl. La commande est ajoutée à la dernière position de la liste à laquelle elle appartient. Par exemple, une commande facetSpec est appliquée en dernière position de servingConfig.facetSpecIds

Pour en savoir plus sur cette méthode, consultez les 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'

Suppression intégrée des commandes des configurations de diffusion

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 Search for Retail ou de l'API.

Afficher les configurations de diffusion dans la console

Vous pouvez voir 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 intégrée, utilisez ServingConfig.get.

Pour en savoir plus sur cette méthode, consultez les 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 davantage de résultats sont disponibles, la réponse list inclut une jeton de page. Vous pouvez transmettre un jeton de page dans le paramètre pageToken d'une list. pour récupérer la page suivante des résultats.

Pour en savoir plus sur cette méthode, consultez les 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.

Remarque :Si vous supprimez une configuration de diffusion utilisée par un modèle d'optimisation au niveau de la page, supprimer et recréer le modèle d'optimisation au niveau de la page. Sinon, le modèle d'optimisation au niveau de la page renverra la configuration de diffusion supprimée.

Supprimer des configurations de diffusion dans la console

Pour supprimer une configuration de diffusion dans la console :

1. Accédez à la page Configurations de diffusion de la console Search for Retail.
   
   Accéder à la page "Configurations de diffusion"

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

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 de manière 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.

Remarque : Les périodes statistiques correspondent au fuseau horaire du Pacifique. Par exemple, les statistiques quotidiennes représentent les données d'hier, à minuit (heure du Pacifique), jusqu'à aujourd'hui, à minuit (heure du Pacifique).