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.

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 la pubblicazione.

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

È importante notare che le operazioni per creare le entità AssetGroup e AssetGroupAsset devono essere incluse insieme in un'unica richiesta e le risorse AssetGroupAsset devono essere combinate per soddisfare tutti i requisiti minimi degli asset e le specifiche. Scopri in che modo questo è diverso per le campagne per la vendita al dettaglio. 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 linee guida per il brand attivate, le risorse Campaign e le risorse CampaignAsset richieste 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 per la pubblicazione

immagine

Puoi personalizzare ulteriormente le tue 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 per la vendita al dettaglio sono uniche in quanto esistono due modi distinti per creare gruppi di asset che generano una campagna di pubblicazione valida:

  • Gruppi di asset senza asset personalizzati (o con solo asset HTML5 MEDIA_BUNDLE)
  • Gruppi di asset che contengono tutti gli asset richiesti (opzione preferita)

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 l'intero inventario. Per la pubblicazione, le campagne Performance Max per la vendita al dettaglio richiedono il seguente insieme minimo di risorse:

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

Il campo Campaign.shopping_setting deve essere compilato nelle campagne per la vendita al dettaglio. Inoltre, qualsiasi final_urls elencato in un AssetGroup deve corrispondere al dominio del sito web associato all'ID account Merchant Center specificato in Campaign.shopping_setting. Infine, ogni AssetGroup deve avere un albero di gruppi di schede di prodotto valido associato, composto da una o più risorse AssetGroupListingGroupFilter. Come minimo, devi creare un albero con un 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 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 per la vendita al dettaglio Performance Max valida e pubblicata

immagine

Le campagne Performance Max per la vendita al dettaglio possono utilizzare tutte le opzioni disponibili per le campagne Performance Max standard, tra cui la creazione di indicatori dei gruppi di asset, obiettivi di conversione della campagna e criteri della campagna. Se scegli di aggiungere asset personalizzati (diversi dagli asset HTML5 MEDIA_BUNDLE) a un AssetGroup durante la creazione della risorsa AssetGroup, la richiesta deve soddisfare tutti i requisiti minimi degli asset (inclusi gli asset del brand a livello di campagna se le linee guida per il brand sono attivate). In altre parole, non includere asset personalizzati o includi tutti gli asset richiesti.

Campagna Performance Max per la vendita al dettaglio con opzioni aggiuntive

immagine

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.

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. Anche se la richiesta di creazione della campagna va 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 la tua campagna 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é 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 per la vendita al dettaglio (diversa dalle campagne Performance Max per Servizi locali) senza includere gli asset minimi richiesti. Per questo motivo, devi includere una risorsa 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.

Raggruppa le operazioni con le 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 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 correttamente tutte le risorse richieste indicate in questa guida. Quando invii richieste separate, utilizza i nomi delle risorse effettivi delle risorse di riferimento nelle richieste successive. Quando invii richieste di modifica collettiva contenenti più operazioni, utilizza i nomi delle risorse formati con 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 fanno riferimento a loro.

Se scegli di creare risorse Asset nella stessa richiesta di modifica collettiva che crea una risorsa AssetGroup e le relative risorse AssetGroupAsset, tutte le risorse AssetOperations devono precedere tutte le risorse AssetGroupAssetOperations, come mostrato 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 nella richiesta alterni AssetOperations e 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 della richiesta verrà aggiunto al tuo account Google Ads. Inoltre, non verrebbero create né la risorsa AssetGroup né le risorse AssetGroupAsset associate.

Aggiorna i gruppi di asset

Dopo aver creato un AssetGroup valido, non puoi inviare richieste successive che lascerebbero un gruppo di asset al di sotto dei requisiti minimi degli asset. Qualsiasi richiesta di questo tipo genera un errore. Ad esempio, se crei un AssetGroup con un singolo MARKETING_IMAGE (il requisito minimo), una richiesta di rimozione solo di quel MARKETING_IMAGE AssetGroupAsset restituisce un errore. Tuttavia, nelle campagne per la vendita al dettaglio Performance Max, puoi tornare a utilizzare gli asset generati automaticamente da Google Merchant Center restituendo un AssetGroup per rimuovere tutti i link AssetGroupAsset personalizzati in un'unica richiesta.

Per i gruppi di asset nelle campagne Performance Max per la vendita al dettaglio create senza asset personalizzati associati, le richieste successive di collegamento di asset personalizzati (diversi dagli asset HTML5 MEDIA_BUNDLE) devono garantire che sia impostato almeno un final_urls su AssetGroup (compilandolo prima se originariamente omesso) e devono fornire tutti gli asset minimi richiesti (inclusi gli asset del brand a livello di campagna se le linee guida per il brand sono attivate) in un'unica richiesta atomica. Non collegare asset annuncio facoltativi come YOUTUBE_VIDEO da soli o aggiungere asset annuncio in modo incrementale in richieste separate. Il collegamento di soli asset personalizzati facoltativi lascia il gruppo di asset in uno stato non supportato che blocca le modifiche nell'interfaccia utente di Google Ads. Per maggiori dettagli, consulta Collega i gruppi di asset agli asset nelle campagne Performance Max per la vendita al dettaglio.