L'elaborazione batch consente di inviare un insieme di operazioni, che possono essere interdipendenti, a più servizi senza attendere in modo sincrono il completamento delle operazioni. Puoi utilizzare l'elaborazione batch per creare e gestire le campagne Performance Max.
Questa guida fornisce dettagli specifici per le campagne Performance Max quando si lavora con l'elaborazione batch. La guida generica all'elaborazione batch fornisce informazioni generali sull'elaborazione batch, mentre la guida Strutturare le richieste contiene informazioni dettagliate sulla creazione di richieste per creare o gestire le campagne Performance Max.
Per creare una campagna Performance Max utilizzando l'elaborazione batch:
Crea un nuovo job batch
Segui il passaggio generale per la creazione di job di elaborazione batch
per creare una risorsa
BatchJob.
Prepara un elenco di operazioni di mutazione
Le campagne Performance Max richiedono operazioni per creare diverse risorse correlate, descritte in dettaglio nella
guida Strutturare le richieste. Crea un
MutateOperation per ogni risorsa da
includere nel job batch.
Requisiti di CampaignOperation e CampaignAssetOperation
Quando le linee guida per il brand sono attivate per una campagna (vedi
linee guida per il brand), devi collegare
gli asset del brand alla campagna utilizzando le risorse CampaignAsset. Inoltre, in un job batch, la creazione di queste CampaignAsset
risorse deve avvenire immediatamente dopo la creazione della Campaign
risorsa stessa. Se le risorse CampaignAsset non vengono create immediatamente
dopo la risetta Campaign (quando le linee guida per il brand sono attivate, vedi
Risoluzione dei problemi),
la richiesta non andrà a buon fine e verrà restituito un CampaignError che indica che mancano asset.
L'inclusione delle operazioni di creazione di CampaignAsset in un secondo momento nello stesso elenco di operazioni non impedisce questo errore.
Requisiti di AssetGroupOperation e AssetGroupAssetOperation
Le operazioni di tipo MutateOperation che
creano risorse AssetGroup e
AssetGroupAsset in un job batch devono
essere sequenziali senza altre operazioni intermedie, a causa del modo in cui queste
operazioni vengono raggruppate durante l'elaborazione. In caso contrario, la richiesta genera un
AssetGroupError che indica che mancano alcuni asset,
anche se le operazioni necessarie per
soddisfare i requisiti minimi degli asset sono incluse in un secondo momento
nell'elenco delle operazioni.
Best practice per AssetGroupListingGroupFilterOperation
Quando lavori con i filtri dei gruppi di schede nel contesto di un
AssetGroupListingGroupFilter, ti
consigliamo di aggiungere le
AssetGroupListingGroupFilterOperation
operazioni che hanno come target lo stesso AssetGroup a un
job batch in modo consecutivo, in modo che l'insieme di operazioni venga trattato in modo atomico
durante la suddivisione batch. Per saperne di più sulla suddivisione batch e su altri fattori
che influiscono sui gruppi di schede, consulta la
guida all'elaborazione batch dei gruppi di schede.
Aggiungi le operazioni di mutazione al job
Aggiungi le operazioni di mutazione del passaggio 2 a un elenco e chiama
AddBatchJobOperations
per aggiungere l'elenco delle mutazioni al job batch creato nel passaggio 1.
Segui il passaggio per aggiungere le operazioni nella guida generale all'elaborazione batch per aggiungere l'elenco delle operazioni di mutazione.
Esegui il job batch
Consenti l'avvio dei job caricati chiamando
RunBatchJob. Per un esempio, consulta il passaggio
Esegui il job batch
nella guida generale all'elaborazione batch.
Recupera lo stato del job
I job batch vengono avviati come operazioni a lunga esecuzione e in genere richiedono tempo per essere completati.
Dopo aver avviato il job, utilizza il metodo GetOperation dell'operazione a lunga esecuzione per eseguire il polling dello stato del job fino al completamento.
Al termine di tutti i job batch, chiama
ListBatchJobResults per
stampare i relativi stati e risposte seguendo il passaggio
Elenca tutti i risultati dei job batch nella
guida generale all'elaborazione batch.