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 generica all'elaborazione batch fornisce informazioni generali sull'elaborazione batch, mentre la guida alla strutturazione delle 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, segui questi passaggi:

Crea un nuovo job batch

Segui il passaggio di creazione dei job di elaborazione batch generale per creare una risorsa BatchJob.

Prepara un elenco di operazioni di modifica

Le campagne Performance Max richiedono operazioni per creare diverse risorse correlate, descritte in dettaglio nella guida alla strutturazione 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 aCampaign risorse associateAsset risorse utilizzateCampaignAsset al fine di soddisfare irequisiti relativi agli 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 per il brand sono attive, consulta la sezione Risoluzione dei problemi), la richiesta non andrà a buon fine e verrà restituito un errore CampaignError che indica la mancanza di asset. 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 per gli asset.

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

Best practice di AssetGroupListingGroupFilterOperation

Nota: le risorse AssetGroupListingGroupFilter 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 associate. Per scegliere come target tutti i prodotti, utilizza un singolo albero di nodi.

Quando utilizzi 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 modo consecutivo, in modo che l'insieme di operazioni venga trattato in modo atomico durante la suddivisione in batch. Per saperne di più sulla suddivisione in 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 modifica al job

Aggiungi le operazioni di modifica del passaggio 2 a un elenco e chiama AddBatchJobOperations per aggiungere l'elenco di mutazioni al job batch creato nel passaggio 1. Segui il passaggio per aggiungere operazioni sugli annunci nella guida generale all'elaborazione batch per aggiungere l'elenco delle operazioni di modifica.

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 di solito 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.

Quando tutti i job batch sono terminati, 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.