Le traitement par lot permet d'envoyer 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 de traitement par lot générique 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 création de tâches de traitement par lot 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
Lorsque les consignes relatives à la marque sont activées pour une campagne (voir Consignes relatives à la marque), vous devez associer les assets de marque à la campagne à l'aide des ressources CampaignAsset. De plus, dans un job par lot, la création de ces ressources CampaignAsset doit avoir lieu immédiatement après la création de la ressource Campaign 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, consultez la section Dépannage), la requête échouera et renverra un 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
Les opérations de type MutateOperation qui créent des ressources AssetGroup et AssetGroupAsset dans un job par lot doivent être séquentielles, sans autre opération 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 erreur AssetGroupError indiquant que certains composants sont manquants, même si les opérations requises pour respecter les exigences minimales concernant les composants sont incluses plus tard dans la liste des opérations.
AssetGroupListingGroupFilterOperation bonnes pratiques
Lorsque vous utilisez des filtres de groupe d'annonces 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 les 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 et appelez AddBatchJobOperations pour ajouter la liste des mutations au job par lot créé à l'étape 1.
Suivez l'étape d'ajout des 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 tâches par lot démarrent en tant qu'opérations de longue durée et prennent généralement du temps.
Après avoir démarré le job, 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 imprimer leurs états et leurs réponses en suivant l'étape Lister tous les résultats des jobs par lot du guide général sur le traitement par lot.