Elaborazione batch per Performance Max

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 utilizzi l'elaborazione batch. La guida all'elaborazione batch generica fornisce informazioni generali sull'elaborazione batch, mentre la guida alle richieste di struttura contiene informazioni dettagliate sulla creazione di richieste per creare o gestire campagne Performance Max.

Per creare una campagna Performance Max utilizzando l'elaborazione batch:

Crea un nuovo job batch

Segui il passaggio generale di creazione del 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 nella guida alle richieste di struttura. Crea un MutateOperation per ogni risorsa da includere nel job batch.

Requisiti per 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 risorse CampaignAsset deve avvenire immediatamente dopo la creazione della risorsa Campaign. Se le risorse CampaignAsset non vengono create immediatamente dopo la risorsa Campaign (quando le linee guida per il brand sono attive, vedi risoluzione dei problemi), la richiesta non andrà a buon fine e verrà restituito un CampaignError che indica la mancanza di asset. L'inclusione delle operazioni di creazione di CampaignAsset più avanti nello stesso elenco di operazioni non impedirà questo errore.

Requisiti per 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 operazioni AssetGroupListingGroupFilterOperation che hanno come target lo stesso AssetGroup a un job batch in sequenza, in modo che l'insieme di operazioni venga trattato in modo atomico durante la suddivisione batch. Per saperne di più sulla suddivisione in batch e su altri fattori che influiscono sui gruppi di schede, consulta la Guida all'elaborazione in 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 batch creato nel passaggio 1. Segui il passaggio per aggiungere operazioni nella guida generale all'elaborazione batch per aggiungere l'elenco delle operazioni di mutazione.

Esegui il job batch

Consenti l'esecuzione dei job caricati chiamando RunBatchJob. Per un esempio, consulta Esegui il job batch nella guida generale all'elaborazione batch.

Recuperare 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 controllare lo 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.