Richieste di struttura

Questa guida descrive in dettaglio molte delle complessità della strutturazione 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 e alla guida all'elaborazione batch di Performance Max.

Creare campagne Performance Max

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

Campagne Performance Max standard

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

Per le campagne con linee guida per il brand attivate, le operazioni per creare Campaign e le risorse CampaignAsset richieste devono essere incluse in un'unica richiesta e le risorse CampaignAsset devono soddisfare i requisiti e le specifiche minime degli asset.

È importante notare che le operazioni per creare entità AssetGroup e AssetGroupAsset devono essere incluse insieme in un'unica richiesta e le risorse AssetGroupAsset devono combinarsi per soddisfare tutti i requisiti minimi delle risorse e le specifiche; scopri in che modo questo è diverso per le campagne retail. Le richieste di creazione di un AssetGroup senza tutte le entità AssetGroupAsset richieste generano un errore. Per ulteriori informazioni, consulta 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 dai tuoi obiettivi e dalla tua infrastruttura.

  • Crea le risorse CampaignBudget, Campaign, Asset e CampaignAsset in richieste separate prima di creare le risorse AssetGroup e AssetGroupAsset. (Per le campagne con le linee guida per il brand attive, Campaign e le risorse CampaignAsset obbligatorie devono essere incluse insieme in una singola richiesta)
  • Includi tutte queste risorse in un'unica richiesta di modifica.

Anche se puoi creare correttamente le risorse CampaignBudget, Campaign, Asset e CampaignAsset 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

immagine

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

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

immagine

Campagne Performance Max per la vendita al dettaglio

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

  • Gruppi di asset senza asset
  • Gruppi di asset che contengono TUTTI gli asset richiesti (preferito)

Quando 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 per raggiungere 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 compilato)
  • AssetGroup
  • AssetGroupListingGroupFilter

È importante notare che il campo Campaign.shopping_settings deve essere compilato nelle campagne retail. Inoltre, l'final_urls elencato in ogni AssetGroup deve corrispondere agli URL associati all'ID account Merchant Center specificato in Campaign.shopping_settings. Infine, ogni AssetGroup deve avere un albero di gruppi di schede di prodotto valido e associato composto da una o più risorse AssetGroupListingGroupFilter. Come minimo, devi creare una singola struttura ad albero di nodi per tenere conto di tutti i prodotti nel feed Merchant Center specificato.

Ciascuna di queste risorse può essere creata separatamente o in un'unica 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

immagine

Le campagne retail possono utilizzare tutte le opzioni disponibili per le campagne Performance Max standard, tra cui la creazione di indicatori del gruppo di asset, gli obiettivi di conversione della campagna e i criteri della campagna. Se scegli di aggiungere asset a un AssetGroup durante la creazione della risorsa AssetGroup, il tuo AssetGroup è soggetto ai requisiti minimi per gli asset. In altre parole, puoi includere nessun asset o tutti gli asset richiesti.

Campagna Performance Max per la vendita al dettaglio con opzioni aggiuntive

immagine

Stato non valido e richieste non valide

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

Provincia non valida
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, questa non è idonea alla pubblicazione finché non aggiungi almeno un AssetGroup alla campagna. Se le tue richieste vanno a buon fine, ma le tue campagne o i tuoi 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é la campagna o la risorsa si troverebbe in uno stato non valido. Ad esempio, l'API Google Ads genera un errore se tenti di creare un AssetGroup per una campagna non retail senza includere gli asset minimi richiesti. Per questo motivo, devi includere un AssetGroup e le relative risorse AssetGroupAsset nella stessa richiesta. Ciò significa anche che tutte le tue 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 mutazione

Le campagne Performance Max sono composte da più risorse e hai la possibilità di creare queste risorse separate in richieste uniche o in una singola 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 tua campagna non è idonea alla pubblicazione finché non avrai creato tutte le risorse richieste indicate in questa guida. Quando invii richieste separate, utilizza i nomi risorsa effettivi delle risorse a cui viene fatto riferimento nelle richieste successive. Quando emetti richieste di modifica collettiva contenenti più operazioni, utilizza nomi delle risorse formati con l'utilizzo di ID temporanei.

Ordine delle operazioni

Indipendentemente dal fatto che utilizzi 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 che venga creata. Nel caso di richieste di modifica collettiva, ciò significa ordinare le operazioni in modo che le risorse a cui viene fatto riferimento siano elencate prima delle risorse che le fanno riferimento.

Se scegli di creare risorse Asset nella stessa richiesta di mutazione collettiva che crea un AssetGroup e le relative risorse AssetGroupAsset, tutti i AssetOperations devono precedere tutti i AssetGroupAssetOperations, come illustrato nel diagramma.

immagine

Il server Google Ads raggruppa le AssetGroupAssetOperations consecutive e valuta se un AssetGroup soddisfa i requisiti minimi degli asset dopo l'ultima operazione del gruppo. Se alterni AssetOperations e AssetGroupAssetOperations nella richiesta, il server API valuterà i requisiti minimi delle risorse 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 creati né il AssetGroup né alcuna delle risorse AssetGroupAsset associate.

Aggiorna i gruppi di asset

Dopo aver creato un AssetGroup valido, non puoi inviare richieste successive che comporterebbero uno stato non valido in cui i requisiti minimi delle risorse non sono più soddisfatti. Eventuali richieste di questo tipo generano un errore. Ad esempio, se crei un AssetGroup con un singolo MARKETING_IMAGE (il requisito minimo), qualsiasi richiesta di rimozione del AssetGroupAsset associato a quel MARKETING_IMAGE restituirà un errore.

Ciò è particolarmente importante nel caso di gruppi di asset nelle campagne per la vendita al dettaglio creati senza asset associati. Le richieste successive di aggiunta di asset al AssetGroup tramite la creazione di risorse AssetGroupAsset andranno 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.