Gérer les configurations de diffusion

Cette page explique comment supprimer, modifier et répertorier des configurations de diffusion, et consulter des statistiques sur chaque configuration.

Pour obtenir de l'aide concernant la création d'une configuration de diffusion, consultez la page Créer des configurations de diffusion.

Si vous disposez d'emplacements existants ou si vous en créez d'autres, Vertex AI Search for Retail 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 supprime l'emplacement correspondant, et la suppression d'un emplacement supprime 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.

Remarque :Si vous apportez des modifications importantes à une configuration de diffusion qui contient un modèle d'optimisation au niveau de la page, ce modèle peut renvoyer des résultats non optimaux lors du réentraînement. Étant donné que 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 sa 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 une configuration de diffusion pour afficher sa page Détails, qui répertorie tous les contrôles de diffusion et les contrôles à l'échelle du site associés à cette configuration.

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

Les configurations de diffusion nouvellement créées ou mises à jour peuvent prendre quelques minutes pour être 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 diffusion, ajouter des commandes de diffusion et supprimer des commandes de diffusion intégrées à l'aide des méthodes de l'API.

Configurations de diffusion de correctifs intégrées

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 ne le définissez pas pour mettre à jour tous les champs acceptés.

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 en dernière position dans la liste des 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 commandes 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 Search for Retail ou de l'API.

Afficher les configurations de diffusion dans la console

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

Afficher les configurations de diffusion de manière intégrée

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 manière intégrée, 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 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.

Remarque :Si vous supprimez une configuration de diffusion utilisée par un modèle d'optimisation au niveau de la page, supprimez et recréez également 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, procédez comme suit:

1. Accédez à la page Configurations de diffusion dans 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 saisir à nouveau 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 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.

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