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 struttura delle richieste contiene informazioni dettagliate sulla creazione di richieste per creare o gestire 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 del 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 da includere
nel job batch.
Requisiti per CampaignOperation e CampaignAssetOperation
Quando le linee guida per il brand sono attivate per una campagna Performance Max
Campaign (brand_guidelines_enabled
viene impostato su true per impostazione predefinita, a meno che non lo imposti su false o non crei una campagna per gli obiettivi di viaggio), devi collegare le risorse del brand Asset alla campagna utilizzando le risorse CampaignAsset.
Le campagne Performance Max per Servizi locali non supportano le linee guida per il brand e omettono le risorse del brand CampaignAsset (imposta brand_guidelines_enabled su false quando crei la campagna). Le campagne Performance Max per la vendita al dettaglio (con un feed Merchant Center) possono omettere le risorse del brand CampaignAsset nello stesso batch secondario atomico solo quando crei una campagna senza asset e senza risorse AssetGroupAsset personalizzate (diverse dagli asset HTML5 MEDIA_BUNDLE) o quando brand_guidelines_enabled è impostato su false.
In un job batch, crea queste risorse CampaignAsset immediatamente dopo aver creato la risorsa Campaign stessa (fino a 1000 operazioni totali nel sub-batch atomico).
L'operazione create Campaign (resource_name) e le relative operazioni create CampaignAsset consecutive (campaign) devono specificare lo stesso ID temporaneo negativo e tutte le operazioni create AssetOperation prerequisito devono essere posizionate prima della creazione di Campaign. Se le risorse CampaignAsset non vengono create immediatamente dopo la risorsa Campaign (quando le linee guida per il brand sono attivate; consulta la sezione Risoluzione dei problemi), la richiesta non va a buon fine e restituisce 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
Quando crei risorse AssetGroup con risorse Asset associate utilizzando AssetGroupAsset per soddisfare i requisiti minimi degli asset, gli oggetti MutateOperation che creano le risorse AssetGroup e AssetGroupAsset in un job batch devono essere sequenziali senza altre operazioni intermedie a causa del modo in cui queste operazioni sono raggruppate in sub-batch atomici (fino a 1000 operazioni totali per sub-batch). Specifica lo stesso ID temporaneo negativo nell'operazione create AssetGroup (resource_name) e nelle operazioni create AssetGroupAsset consecutive (asset_group) e inserisci le operazioni create AssetOperation prerequisito prima della creazione di AssetGroup. In caso contrario, la richiesta non va a buon fine e viene visualizzato un messaggio 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
Quando crei, aggiorni o rimuovi risorse AssetGroupListingGroupFilter, aggiungi consecutivamente al job batch tutte le operazioni AssetGroupListingGroupFilterOperation che hanno come target lo stesso AssetGroup, in modo che vengano raggruppate in un sub-batch atomico durante la suddivisione del batch. Per maggiori dettagli sulla suddivisione dei 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 modifica del passaggio 2 a un elenco e chiama il metodo AddBatchJobOperations per aggiungere l'elenco di modifiche 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
Inizia a eseguire le operazioni caricate chiamando il metodo RunBatchJob. Per un esempio, consulta il passaggio Esegui il job batch nella guida generale all'elaborazione batch.
Esegui il polling dello stato del job e recupera i risultati
I job batch vengono eseguiti come operazioni a lunga esecuzione e di solito richiedono tempo per essere completati. Dopo aver avviato il job, utilizza il metodo Operations.GetOperation sul servizio google.longrunning.Operations (o esegui una query su batch_job.status con GoogleAdsService) per eseguire il polling dello stato del job fino al completamento.
Al termine del job batch, chiama il metodo ListBatchJobResults per recuperare lo stato e la risposta per ogni operazione del job. Per un esempio, consulta
Elenca tutti i risultati dei job batch.