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.
- Budget della campagna
- Campagna
- Asset della campagna (solo per le campagne con le linee guida per il brand attivate)
- Gruppi di asset
- Asset del gruppo di asset
- Asset
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,AsseteCampaignAssetin richieste separate prima di creare le risorseAssetGroupeAssetGroupAsset. (Per le campagne con linee guida per il brand attivate, le risorseCampaigne le risorseCampaignAssetrichieste 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

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

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:
CampaignBudgetCampaign(conShoppingSettingcompilato)AssetGroupAssetGroupListingGroupFilter
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

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

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
Campaignautonoma con unadvertising_channel_typediPERFORMANCE_MAX. Anche se la richiesta di creazione della campagna va a buon fine, questa non è idonea alla pubblicazione finché non aggiungi almeno unAssetGroupalla campagna. Se le tue richieste vanno a buon fine, ma la tua campagna o i tuoi gruppi di asset non vengono pubblicati, puoi utilizzareCampaignPrimaryStatus,CampaignPrimaryStatusReason,AssetGroupPrimaryStatuseAssetGroupPrimaryStatusReasonper 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
AssetGroupper 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 risorsaAssetGroupe le relative risorseAssetGroupAssetnella stessa richiesta. Ciò significa anche che tutte le risorseAssetGroupAssetdevono soddisfare le specifiche corrette per un determinatofield_typeper 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.

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.