Traitement par lot pour Performance Max

Le traitement par lot permet de distribuer un ensemble d'opérations, qui peuvent être interdépendantes, à plusieurs services sans attendre de manière synchrone la fin des opérations. Vous pouvez utiliser le traitement par lot pour créer et gérer des campagnes Performance Max.

Ce guide fournit des informations spécifiques aux campagnes Performance Max lorsque vous utilisez le traitement par lot. Le guide générique sur le traitement par lot fournit des informations générales sur le traitement par lot, et le guide sur la structure des requêtes contient des informations détaillées sur la création de requêtes pour créer ou gérer des campagnes Performance Max.

Pour créer une campagne Performance Max à l'aide du traitement par lot, procédez comme suit :

Créer un job par lot

Suivez l'étape générale de traitement par lot de création de job pour créer une ressource BatchJob.

Préparer une liste d'opérations de mutation

Les campagnes Performance Max nécessitent des opérations pour créer plusieurs ressources associées, qui sont détaillées dans le guide sur la structure des requêtes. Créez un MutateOperation pour chaque ressource à inclure dans le job par lot.

Exigences concernant CampaignOperation et CampaignAssetOperation

**Remarque** : Cette exigence ne s'applique qu'aux ressources Campaign associées à des ressources Asset qui utilisent CampaignAsset pour répondre aux exigences concernant les assets de marque.

Lorsque les consignes relatives à la marque sont activées pour une campagne (voir Consignes relatives à la marque), vous devez associer les composants de la marque à la campagne à l'aide de ressources CampaignAsset. De plus, dans un job par lot, la création de ces CampaignAsset ressources doit avoir lieu immédiatement après la création de la Campaign ressource elle-même. Si les ressources CampaignAsset ne sont pas créées immédiatement après la ressource Campaign (lorsque les consignes relatives à la marque sont activées, voir Dépannage), la requête échoue et renvoie une CampaignError indiquant que des composants sont manquants. Inclure les opérations de création CampaignAsset plus tard dans la même liste d'opérations n'empêchera pas cette erreur.

Exigences concernant AssetGroupOperation et AssetGroupAssetOperation

Remarque : Cette exigence ne s'applique qu'aux ressources AssetGroup associées à des ressources Asset qui utilisent AssetGroupAsset pour respecter les exigences minimales concernant les composants.

Les opérations de type MutateOperation qui créent des ressources AssetGroup et AssetGroupAsset dans un job par lot doivent être séquentielles, sans autres opérations entre elles, en raison de la façon dont ces opérations sont regroupées lors du traitement. Sinon, la requête génère une AssetGroupError indiquant que certains composants sont manquants, même si les opérations requises pour répondre aux exigences minimales concernant les composants sont incluses plus tard dans la liste des opérations.

Bonnes pratiques concernant AssetGroupListingGroupFilterOperation

Remarque AssetGroupListingGroupFilter : Les ressources ne peuvent être utilisées qu'avec les campagnes Performance Max pour les ventes en ligne avec un flux de produits. AssetGroup ressources de ces campagnes doivent comporter une arborescence de groupes de produits valide composée d'une ou de plusieurs AssetGroupListingGroupFilter ressources associées. Pour cibler tous les produits, utilisez une arborescence à un seul nœud.

Lorsque vous utilisez des filtres de groupes de fiches dans le contexte d'un AssetGroupListingGroupFilter, nous vous recommandons d'ajouter des opérations AssetGroupListingGroupFilterOperation ciblant le même AssetGroup à un job par lot de manière consécutive, afin que l'ensemble des opérations soit traité de manière atomique lors de la division par lot. Pour en savoir plus sur la division par lot et d'autres facteurs affectant les groupes de fiches, consultez le guide sur le traitement par lot des groupes de fiches.

Ajouter les opérations de mutation au job

Ajoutez les opérations de mutation de l'étape 2 à une liste, puis appelez AddBatchJobOperations pour ajouter la liste des mutations au job par lot créé à l'étape 1. Suivez l'étape d'ajout d'opérations du guide général sur le traitement par lot pour ajouter la liste des opérations de mutation.

Exécuter le job par lot

Autorisez l'exécution des jobs importés en appelant RunBatchJob. Pour obtenir un exemple, consultez l'étape Exécuter le job par lot du guide général sur le traitement par lot.

Récupérer l'état du job

Les jobs par lot démarrent en tant qu'opérations de longue durée et prennent généralement du temps. Une fois le job démarré, utilisez la méthode GetOperation de l'opération de longue durée pour interroger l'état du job jusqu'à ce qu'il soit terminé.

Une fois tous vos jobs par lot terminés, appelez ListBatchJobResults pour afficher leurs états et leurs réponses en suivant l'étape Répertorier tous les résultats des jobs par lot du guide général sur le traitement par lot.