Richieste di struttura

Questa guida illustra nel dettaglio molte delle complessità della strutturazione delle richieste che creano e aggiornano le campagne Performance Max. Può essere una risorsa utile durante la progettazione dell'integrazione. Questa guida spiega come vengono elaborate le richieste che cambiano le campagne Performance Max e possono essere una risorsa complementare alla guida alla risoluzione dei problemi di Performance Max e alla guida all'elaborazione batch di Performance Max.

Crea 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 poter essere pubblicate.

• Budget della campagna
• Campagna
• Gruppi di asset
• Asset dei gruppi di asset
• Assets

È importante notare che le operazioni per creare entità AssetGroup e AssetGroupAsset devono essere incluse in un'unica richiesta e che 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 di creazione di un elemento AssetGroup senza tutte le entità AssetGroupAsset obbligatorie generano un errore. Per ulteriori informazioni, consulta la sezione Stato non valido e richieste non valide.

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.

Anche se puoi creare correttamente le risorse CampaignBudget, Campaign e Asset in richieste precedenti separate, la campagna Performance Max non sarà idonea alla pubblicazione finché 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 daranno luogo a una campagna di pubblicazione valida:

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

Se scegli di escludere gli 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 in modo da coprire tutto l'inventario. Per poter essere pubblicate, le campagne Performance Max per la vendita al dettaglio richiedono il seguente insieme minimo di risorse.

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

È importante notare che il campo Campaign.shopping_settings deve essere compilato nelle campagne per la vendita al dettaglio. Inoltre, i valori final_urls elencati in ogni AssetGroup devono corrispondere agli URL associati all'ID account Merchant Center specificato in Campaign.shopping_settings. Infine, ogni AssetGroup deve avere associato una struttura di gruppo di schede di prodotto valida composta da una o più AssetGroupListingGroupFilter risorse. Come minimo, devi creare una struttura ad albero a singolo nodo 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 per la vendita al dettaglio valida pubblicata

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

Campagna Performance Max per la vendita al dettaglio con opzioni aggiuntive

Stato non valido e richieste non valide

Quando lavori con campagne Performance Max nell'API Google Ads, esiste una importante differenza 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. Sebbene la richiesta di creazione della campagna vada a buon fine, la campagna non è idonea alla pubblicazione finché non ne aggiungi almeno un AssetGroup. 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 in dettaglio nella guida alla risoluzione dei problemi.

richiesta non valida

Una richiesta che non ha avuto esito positivo perché metterebbe la campagna o la risorsa in uno stato non valido. Ad esempio, l'API Google Ads genera un errore se provi a creare un AssetGroup per una campagna non di vendita al dettaglio senza includere gli asset minimi richiesti. Questo è il motivo per cui devi includere un elemento AssetGroup e le sue risorse AssetGroupAsset nella stessa richiesta. Ciò significa anche che tutte le risorse AssetGroupAsset devono soddisfare le specifiche corrette per un determinato field_type, al fine di 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 hai la possibilità di creare queste risorse separate in richieste uniche o in un'unica richiesta di modifica collettiva. Tuttavia, AssetGroups e AssetGroupAssets associati nelle campagne Performance Max standard devono essere creati in un'unica richiesta atomica, come già indicato.

La campagna non sarà idonea alla pubblicazione finché non avrai creato correttamente 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 mutazione collettiva contenenti più operazioni, utilizza i nomi delle risorse creati con l'utilizzo 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 creazione. Nel caso di richieste di mutazione collettiva, ciò significa ordinare le operazioni in modo tale che le risorse di riferimento siano elencate prima di quelle che le 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 gli elementi AssetOperations devono precedere tutti gli elementi AssetGroupAssetOperations, come mostrato nel diagramma.

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

Aggiorna i gruppi di asset

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

Ciò è particolarmente importante nel caso di gruppi di asset nelle campagne di vendita al dettaglio creati senza asset associati. Le successive richieste di aggiunta di asset a AssetGroup tramite la creazione di risorse AssetGroupAsset avranno esito positivo solo se la richiesta ha soddisfatto tutti i requisiti degli asset. In altre parole, non puoi aggiungere asset a questi gruppi di asset in modo incrementale.