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 que les opérations se terminent. 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 de création de job de traitement par lot général 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 des assets de marque à la campagne à l'aide de ressources CampaignAsset. De plus, dans un job par lot, la création de ces ressources CampaignAsset doit se faire 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 Dépannage), la requête échoue et renvoie une erreur CampaignError indiquant que des composants sont manquants.
L'inclusion des 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 autres opérations entre elles, en raison de la manière 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.
Bonnes pratiques concernant AssetGroupListingGroupFilterOperation
Lorsque vous utilisez des filtres de groupe de fiches dans le contexte d'un AssetGroupListingGroupFilter, nous vous recommandons d'ajouter consécutivement des opérations AssetGroupListingGroupFilterOperation ciblant le même AssetGroup à un job par lot, afin que l'ensemble des opérations soit traité de manière atomique lors de la division du lot. Pour en savoir plus sur la division par lot et les autres facteurs ayant une incidence sur 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 de 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.
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 afficher 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.