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 travaillez avec 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, tandis que le guide de structuration 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
Pour créer une ressource BatchJob, suivez la étape de création de tâche de traitement par lot général.
Préparer une liste d'opérations de modification
Les campagnes Performance Max nécessitent des opérations pour créer plusieurs ressources associées, qui sont détaillées dans le guide de structuration des requêtes. Créez un MutateOperation pour chaque ressource à inclure dans le travail par lot.
Configuration requise pour CampaignOperation et CampaignAssetOperation
Lorsque les consignes relatives à la marque sont activées pour une campagne (voir les consignes relatives à la marque), vous devez associer les composants de la marque à la campagne à l'aide de ressources CampaignAsset. De plus, dans un travail par lot, la création de ces ressources CampaignAsset doit se produire 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 aux marques sont activées, consultez la section Dépannage), la requête échoue et renvoie un CampaignError indiquant les éléments manquants.
L'inclusion des opérations de création de CampaignAsset ultérieurement dans la même liste d'opérations n'empêchera pas cette erreur.
Configuration requise pour AssetGroupOperation et AssetGroupAssetOperation
Les opérations de type MutateOperation qui créent des ressources AssetGroup et AssetGroupAsset dans une tâche 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 exception AssetGroupError indiquant que certains composants sont manquants, même si les opérations requises pour remplir les exigences minimales concernant les composants sont incluses plus tard dans la liste des opérations.
Bonnes pratiques AssetGroupListingGroupFilterOperation
Lorsque vous utilisez des filtres de groupe de fiches dans le contexte d'un AssetGroupListingGroupFilter, nous vous recommandons d'ajouter des opérations AssetGroupListingGroupFilterOperation ciblant le même AssetGroup à une tâche 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 sur d'autres facteurs affectant les groupes de fiches, consultez le guide de traitement par lot des groupes de fiches.
Ajouter les opérations de mutation à la tâche
Ajoutez les opérations de modification de l'étape 2 à une liste et appelez AddBatchJobOperations pour ajouter la liste des modifications à la tâche par lot créée à l'étape 1.
Suivez l'étape d'ajout d'opérations dans le guide de traitement par lot général pour ajouter la liste des opérations de modification.
Exécuter la tâche par lot
Autorisez les tâches importées à commencer à s'exécuter en appelant RunBatchJob. Pour obtenir un exemple, consultez l'étape Exécuter la tâche par lot dans le guide général sur le traitement par lot.
Récupérer l'état de la tâche
Les tâches par lot démarrent en tant qu'opérations de longue durée et prennent généralement du temps à se terminer.
Après avoir démarré la tâche, utilisez la méthode GetOperation de l'opération de longue durée pour interroger l'état de la tâche jusqu'à ce qu'elle soit terminée.
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 de traitement par lot général.