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 collettiva per creare e gestire le campagne Performance Max.

Questa guida fornisce dettagli specifici per le campagne Performance Max quando si utilizza l'elaborazione collettiva. La guida all'elaborazione collettiva generica fornisce informazioni generali sull'elaborazione collettiva, mentre la guida alla struttura delle richieste contiene informazioni dettagliate sulla creazione delle richieste per creare o gestire le campagne Performance Max.

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

Creare un nuovo job batch

Segui il passaggio di creazione del job per l'elaborazione collettiva generale per creare una risorsa BatchJob.

Preparare un elenco di operazioni di mutazione

Le campagne Performance Max richiedono operazioni per creare diverse risorse correlate, descritte nella guida alla struttura delle richieste. Crea un MutateOperation per ogni risorsa che deve essere inclusa nel job batch.

Requisiti per CampaignOperation e CampaignAssetOperation

Nota: questo requisito si applica solo alle risorse Campaign con risorse Asset associate che utilizzano CampaignAsset per soddisfare i requisiti degli asset del brand.

Quando le linee guida per il brand sono attivate per una campagna (consulta le 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 stessa. Se le risorse CampaignAsset non vengono create immediatamente dopo la risorsa Campaign (quando le linee guida del brand sono attivate, consulta la risoluzione dei problemi), la richiesta non andrà a buon fine e restituirà un CampaignError che indica gli asset mancanti. L'inclusione delle operazioni di creazione di CampaignAsset in un secondo momento nello stesso elenco di operazioni non impedirà questo errore.

Requisiti per AssetGroupOperation e AssetGroupAssetOperation

Nota: questo requisito si applica solo alle risorse AssetGroup con risorse Asset associate che utilizzano AssetGroupAsset per rispettare i requisiti minimi delle risorse.

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 messaggio AssetGroupError che indica che mancano alcuni asset, anche se le operazioni necessarie per soddisfare i requisiti minimi delle risorse sono incluse più avanti nell'elenco delle operazioni.

AssetGroupListingGroupFilterOperation best practice

Nota: AssetGroupListingGroupFilter le risorse possono essere utilizzate solo con le campagne Performance Max per le vendite online con un feed dei prodotti. Le risorse AssetGroup in queste campagne devono avere un albero dei gruppi di prodotti valido composto da una o più risorse AssetGroupListingGroupFilter. Per scegliere come target tutti i prodotti, utilizza una singola struttura ad albero di nodi.

Quando utilizzi i filtri dei gruppi di schede nel contesto di un AssetGroupListingGroupFilter, consigliamo di aggiungere AssetGroupListingGroupFilterOperation operazioni che hanno come target lo stesso AssetGroup a un job batch consecutivamente, in modo che l'insieme di operazioni venga trattato in modo atomico durante la suddivisione in batch. Per scoprire di più sulla suddivisione in batch e su altri fattori che influiscono sui gruppi di schede, consulta la guida all'elaborazione collettiva 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 all'elaborazione collettiva generale 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.

Recuperare lo stato del job

I job batch iniziano 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 monitorare lo stato del job fino al termine.

Al termine di tutti i job batch, chiama ListBatchJobResults per stamparne gli stati e le risposte seguendo il passaggio elenca tutti i risultati dei job batch nella guida generale all'elaborazione batch.