Richieste di struttura

Questa guida descrive in dettaglio molte delle complessità della struttura delle richieste che creano e aggiornano le campagne Performance Max. Può essere una risorsa utile per progettare l'integrazione. Questa guida spiega come vengono elaborate le richieste che modificano le campagne Performance Max e può essere una risorsa complementare alla guida alla risoluzione dei problemi di Performance Max.

Creare campagne Performance Max

Nell'API Google Ads, le entità delle campagne Performance Max sono rappresentate come una combinazione di diverse risorse uniche.

Campagne Performance Max standard

Le campagne Performance Max standard richiedono un insieme minimo di risorse per essere pubblicate.

• Budget della campagna
• Campagna
• Gruppi di asset
• Asset gruppo di asset
• Asset

È importante notare che le operazioni per creare le entità AssetGroup e AssetGroupAsset devono essere incluse in una singola richiesta e le risorse AssetGroupAsset devono combinarsi per soddisfare tutti i requisiti minimi degli asset e le specifiche. Scopri le differenze per le campagne per la vendita al dettaglio. Le richieste per creare una AssetGroup senza tutte le entità AssetGroupAsset richieste generano un errore; consulta Confronto tra stato non valido e richieste non valide per saperne di più.

Esistono diverse opzioni per strutturare le richieste che creano campagne Performance Max. La decisione su come raggruppare le operazioni e strutturare le richieste dipende in gran parte dagli obiettivi e dall'infrastruttura.

• Crea le risorse CampaignBudget, Campaign e Asset in richieste separate prima di creare le risorse AssetGroup e AssetGroupAsset.
• Includi tutte queste risorse in un'unica richiesta di modifica.

Sebbene sia possibile creare correttamente le risorse CampaignBudget, Campaign e Asset in richieste precedenti separate, la campagna Performance Max non sarà idonea alla pubblicazione fino a quando non verranno create anche le risorse AssetGroup e AssetGroupAsset.

Requisiti minimi per una campagna Performance Max valida per la pubblicazione

Puoi personalizzare ulteriormente le campagne Performance Max creando risorse aggiuntive come mostrato nel diagramma.

• Indicatori dei gruppi di asset
• Obiettivi di conversione della campagna
• Criteri della campagna

Puoi includere operazioni per creare risorse AssetGroupSignal nella stessa richiesta che crea le risorse AssetGroup e AssetGroupAsset. In alternativa, puoi creare entità AssetGroupSignal in una richiesta separata dopo la creazione di AssetGroup.

Campagna Performance Max con opzioni aggiuntive

Campagne Performance Max per la vendita al dettaglio

Le campagne per la vendita al dettaglio sono uniche in quanto esistono due modi distinti per creare gruppi di asset che generano una campagna per la pubblicazione valida:

• Gruppi di asset senza asset
• Gruppi di asset che contengono TUTTI gli asset obbligatori (opzione preferita)

Quando scegli di escludere asset dai gruppi di asset, Google utilizza automaticamente gli asset forniti nel tuo account Merchant Center collegato per creare gli annunci. Tuttavia, ti consigliamo di fornire asset da raggiungere in tutto l'inventario. Per essere pubblicate, le campagne Performance Max per la vendita al dettaglio richiedono il seguente insieme minimo di risorse.

• CampaignBudget
• Campaign (con ShoppingSettings completato)
• AssetGroup
• AssetGroupListingGroupFilter

È importante notare che il campo Campaign.shopping_settings deve essere compilato nelle campagne per la vendita al dettaglio. Inoltre, l'attributo final_urls elencato in ogni AssetGroup deve corrispondere agli URL associati all'ID account Merchant Center specificato in Campaign.shopping_settings. Infine, a ogni AssetGroup deve essere associata una struttura di gruppi di schede di prodotto valida composta da una o più risorse AssetGroupListingGroupFilter. Come minimo, devi creare una struttura ad albero di nodi singolo per tenere conto di tutti i prodotti nel feed di Merchant Center specificato.

Ognuna di queste risorse può essere creata separatamente o in una singola richiesta. Tuttavia, la campagna non sarà idonea alla pubblicazione finché tutte queste risorse non saranno state create correttamente.

Requisiti minimi per una campagna Performance Max valida per la vendita al dettaglio

Le campagne per la vendita al dettaglio possono utilizzare tutte le opzioni disponibili per le campagne Performance Max standard, tra cui la creazione di indicatori sui gruppi di asset, gli obiettivi di conversione della campagna e i criteri delle campagne. Se scegli di aggiungere asset a un elemento AssetGroup durante la creazione della risorsa AssetGroup, l'elemento AssetGroup è soggetto ai requisiti minimi per gli asset. In altre parole, puoi non includere asset o tutti gli asset obbligatori.

Campagna Performance Max per la vendita al dettaglio con opzioni aggiuntive

Confronto tra stato non valido e richieste non valide

Quando utilizzi le campagne Performance Max nell'API Google Ads, esiste un'importante distinzione tra stati non validi e richieste non valide.

Stato non valido

La campagna non è idonea alla pubblicazione a causa della sua configurazione. Ad esempio, puoi creare una risorsa Campaign autonoma con un advertising_channel_type di PERFORMANCE_MAX. Anche se la richiesta di creazione della campagna ha esito positivo, questa non è idonea alla pubblicazione finché non aggiungi almeno un AssetGroup alla campagna. Se le richieste hanno esito positivo, ma la campagna o i gruppi di asset non vengono pubblicati, puoi utilizzare CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus e AssetGroupPrimaryStatusReason per determinare il motivo, come descritto nella guida alla risoluzione dei problemi.

richiesta non valida

Una richiesta che non andrebbe a buon fine perché metterebbe in uno stato non valido la campagna o la risorsa. Ad esempio, l'API Google Ads genera un errore se cerchi di creare un AssetGroup per una campagna non di vendita al dettaglio senza includere gli asset minimi richiesti. Questo è perché devi includere un elemento AssetGroup e le relative risorse AssetGroupAsset nella stessa richiesta. Ciò significa anche che tutte le risorse AssetGroupAsset devono soddisfare le specifiche corrette per un determinato field_type per evitare che l'intera richiesta non vada a buon fine.

Operazioni di gruppo con richieste di modifica

Le campagne Performance Max sono composte da più risorse e puoi crearle in richieste uniche o in una singola richiesta di modifica collettiva. Tuttavia, AssetGroups e AssetGroupAssets associato nelle campagne Performance Max standard devono essere creati in una singola richiesta atomica, come già indicato.

La campagna non sarà idonea alla pubblicazione finché non avrai creato tutte le risorse richieste indicate in questa guida. Quando invii richieste separate, utilizza i nomi effettivi delle risorse di riferimento nelle richieste successive. Quando invii richieste di modifica collettive contenenti più operazioni, utilizza nomi delle risorse creati con l'uso di ID temporanei.

Ordine delle operazioni

Indipendentemente dal fatto che utilizzi o meno una richiesta di modifica collettiva per creare una campagna Performance Max, devi ordinare le richieste e le operazioni in modo da non fare mai riferimento a una risorsa prima della sua creazione. Nel caso di richieste di modifica collettive, ciò significa ordinare le operazioni in modo tale che le risorse di riferimento siano elencate prima di quelle che fanno riferimento.

Se scegli di creare risorse asset nella stessa richiesta di modifica collettiva che crea un elemento AssetGroup e le relative risorse AssetGroupAsset, tutti AssetOperations devono precedere tutti gli elementi AssetGroupAssetOperations, come mostrato nel diagramma.

Il server di Google Ads raggruppa AssetGroupAssetOperations consecutivi e valuta se un elemento AssetGroup soddisfa i requisiti minimi per gli asset dopo l'ultima operazione in quel gruppo. Se nella richiesta passi da AssetOperations a AssetGroupAssetOperations, il server API valuterà i requisiti minimi degli asset dopo il primo AssetGroupAssetOperation e restituirà un errore senza procedere con il resto delle operazioni nella richiesta. Di conseguenza, nessuno degli asset nella richiesta verrà aggiunto al tuo account Google Ads. Inoltre, non verranno create né le AssetGroup né le risorse AssetGroupAsset associate.

Aggiorna i gruppi di asset

Dopo aver creato un elemento AssetGroup valido, non puoi inviare richieste successive che potrebbero causare uno stato non valido in cui i requisiti minimi per gli asset non sono più soddisfatti. Tali richieste generano un errore. Ad esempio, se crei un elemento AssetGroup con un singolo MARKETING_IMAGE (il requisito minimo), qualsiasi richiesta di rimozione dell'elemento AssetGroupAsset associato a tale MARKETING_IMAGE restituirà un errore.

Questo è particolarmente importante nel caso di gruppi di asset nelle campagne per la vendita al dettaglio create senza asset associati. Le richieste successive di aggiungere asset a AssetGroup creando risorse AssetGroupAsset andrebbero a buon fine solo se la richiesta soddisfa tutti i requisiti degli asset. In altre parole, non puoi aggiungere asset a questi gruppi di asset in modo incrementale.