Richieste di struttura

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

Crea campagne Performance Max

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

Campagne Performance Max standard

Le campagne Performance Max standard richiedono un insieme minimo di risorse al fine di da pubblicare.

È importante notare che le operazioni per creare AssetGroup Le entità AssetGroupAsset devono essere incluse in una singola richiesta e le risorse AssetGroupAsset devono combinarsi per soddisfare tutti gli asset minimi Requisiti e specifiche; scopri le differenze Campagne per la vendita al dettaglio. Richieste di creazione un AssetGroup senza tutte le entità AssetGroupAsset obbligatorie genera un errore; vedi 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 di strutturazione delle richieste dipende in gran parte dagli obiettivi e dall'infrastruttura.

  • Crea le risorse CampaignBudget, Campaign e Asset in file separati prima della creazione delle risorse AssetGroup e AssetGroupAsset.
  • Includi tutte queste risorse in un'unica richiesta di modifica.

Puoi creare correttamente CampaignBudget, Campaign e Asset risorse in richieste precedenti distinte, la campagna Performance Max non idonea alla pubblicazione finché le risorse AssetGroup e AssetGroupAsset non creato anch'esso.

Requisiti minimi per una campagna Performance Max valida per la pubblicazione

immagine

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

Puoi includere operazioni per creare AssetGroupSignal risorse nella stessa che crea le risorse AssetGroup e AssetGroupAsset. In alternativa, puoi creare entità AssetGroupSignal in una richiesta separata in seguito alla 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 due modi discreti per creare gruppi di asset che daranno luogo a una pubblicazione campagna:

  • 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 account Merchant Center collegato per creare annunci. Tuttavia, ti consigliamo di fornire asset in modo da coprire tutto l'inventario. Le campagne Performance Max per la vendita al dettaglio richiedono il seguente insieme minimo di di risorse per operare.

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

È importante notare che il campo Campaign.shopping_settings deve essere inseriti nelle campagne per la vendita al dettaglio. Inoltre, i final_urls elencati in ogni AssetGroup deve corrispondere agli URL associati all'ID account Merchant Center specificato in Campaign.shopping_settings. Infine, ogni AssetGroup deve Abbiano una struttura di gruppo di schede di prodotto valida associata composta da una o più AssetGroupListingGroupFilter risorse. Come minimo, devi creare un singolo struttura ad albero dei nodi 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 fino a quando non tutte queste risorse sono stati creati correttamente.

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

immagine

Le campagne per la vendita al dettaglio possono utilizzare tutte le opzioni disponibili Campagne Performance Max, inclusa la creazione di indicatori dei gruppi di asset, delle campagne obiettivi di conversione e criteri della campagna. Se scegli di aggiungere asset a un AssetGroup durante la creazione della risorsa AssetGroup, il tuo AssetGroup è sono soggette 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

immagine

Stato non valido e richieste non valide

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

Provincia non valida
La campagna non è idonea alla pubblicazione a causa della sua configurazione. Per Ad esempio, puoi creare una risorsa Campaign autonoma con un advertising_channel_type di PERFORMANCE_MAX. Anche se la richiesta di creare la campagna ha esito positivo, non è idonea alla pubblicazione finché non ne aggiungi almeno una AssetGroup alla campagna. Se le tue richieste hanno esito positivo ma la tua campagna gruppi di asset non vengono pubblicati, puoi usare CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus e AssetGroupPrimaryStatusReason per determinare il motivo, come descritto in dettaglio risoluzione dei problemi .
richiesta non valida
Una richiesta che non andrebbe a buon fine perché metterebbe la campagna o in uno stato non valido. Ad esempio, l'API Google Ads genera un errore se prova a creare un AssetGroup per una campagna non di vendita al dettaglio senza includere il asset minimi obbligatori. Questo è perché è necessario includere AssetGroup e le sue AssetGroupAsset risorse nella la stessa richiesta. Ciò significa anche che tutte le AssetGroupAsset risorse devono soddisfare le specifiche corrette per un determinato field_type per evitare che l'intera non va a buon fine.

Operazioni di gruppo con richieste di modifica

Le campagne Performance Max sono composte da più risorse e puoi per creare queste risorse separate in richieste uniche o in un richiesta di modifica collettiva. Tuttavia, AssetGroups e il valore AssetGroupAssets associato nelle campagne Performance Max standard deve essere creato in una singola richiesta atomica, come già osservato.

La campagna non sarà idonea alla pubblicazione finché non hai creato tutti i le risorse richieste indicate in questa guida. Al momento dell'emissione di richieste, utilizzano i nomi effettivi delle risorse di riferimento nelle richieste. Quando si inviano richieste di mutazione collettiva contenenti più operazioni, utilizzano nomi delle risorse creati con l'uso di ID temporanei.

Ordine delle operazioni

A prescindere dal fatto che utilizzi o meno una richiesta di modifica collettiva per creare una richiesta Performance Max campagna, devi ordinare le richieste e le operazioni in modo che fare riferimento a una risorsa prima che venga creata. In caso di mutazione collettiva richieste, ciò significa ordinare le operazioni in modo tale che facciano riferimento le risorse vengono elencate prima di quelle che le fanno riferimento.

Se scegli di creare risorse Asset nella stessa richiesta di modifica collettiva che crea un'istanza AssetGroup e le sue risorse AssetGroupAsset, tutte AssetOperations deve precedere tutti i AssetGroupAssetOperations, come come mostrato nel diagramma.

immagine

Il server Google Ads raggruppa AssetGroupAssetOperations consecutivi insieme e valuta se AssetGroup soddisfa i requisiti minimi degli asset seguendo le istruzioni l'ultima operazione in quel gruppo. Se alterna AssetOperations e AssetGroupAssetOperations nella tua richiesta, il server API valuterà requisiti minimi degli asset dopo i primi AssetGroupAssetOperation e restituiscono un errore senza procedere con le altre operazioni nel richiesta. Di conseguenza, nessuno degli asset nella richiesta verrà aggiunto al tuo account Google Ads. Inoltre, né i AssetGroup né i valori associati Verranno create AssetGroupAsset risorse.

Aggiorna i gruppi di asset

Dopo aver creato un AssetGroup valido, non potrai emettere richieste successive che comporterebbe uno stato non valido in cui i requisiti minimi per gli asset non sono più soddisfatti. Queste richieste generano un errore. Ad esempio, se crea un AssetGroup con un singolo MARKETING_IMAGE (requisito minimo), eventuali richieste di rimozione di AssetGroupAsset associati a quel determinato MARKETING_IMAGE restituirà un errore.

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