L'API Google Ads offre diverse visualizzazioni per analizzare dove sono stati pubblicati i tuoi annunci e il loro rendimento:
managed_placement_view,
group_placement_view,
detail_placement_view e
performance_max_placement_view. Ogni visualizzazione offre una prospettiva diversa sui dati dei posizionamenti.
Visualizzazione dei posizionamenti gestiti
- Cosa mostra: la risorsa
managed_placement_viewfornisce dati sul rendimento aggregati in base ai posizionamenti che hai scelto esplicitamente come target (posizionamenti gestiti). Riflette il rendimento dei criteriPlacement. - Equivalente nell'interfaccia utente: Contenuti > Posizionamenti
- Query Builder: Esplora in Query Builder
Query di esempio
Per recuperare le metriche sul rendimento dei posizionamenti gestiti negli ultimi 30 giorni:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.placement.url,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
Visualizzazione del posizionamento del gruppo
- Cosa mostra: la risorsa
group_placement_viewmostra dove sono stati effettivamente pubblicati i tuoi annunci sulla Rete Display e su YouTube, indipendentemente dal fatto che i posizionamenti siano stati scelti esplicitamente come target o rilevati automaticamente dal sistema di Google. Questi possono includere siti web, canali o video di YouTube e app. - Equivalente nell'interfaccia utente: Contenuti > Dove sono stati pubblicati gli annunci
- Query Builder: Esplora in Query Builder
Riga "Totale: altro"
Per velocizzare la generazione dei report, le risorse group_placement_view e detail_placement_view escludono i singoli posizionamenti che non soddisfano una soglia minima di attività di impressioni o interazioni.
- Nella UI di Google Ads: la UI aggrega i posizionamenti che non soddisfano questa soglia di attività in una riga di riepilogo denominata Totale: altro.
- Nell'API Google Ads: l'API omette dai risultati dei report i posizionamenti che non soddisfano la soglia di attività e non restituisce una riga di riepilogo in cui il campo
group_placement_view.placementodetail_placement_view.placementha il valore"Other".
Di conseguenza, la somma delle singole righe dei posizionamenti nelle risorse group_placement_view e detail_placement_view potrebbe essere inferiore alle metriche totali del gruppo di annunci o della campagna. Per saperne di più, consulta Informazioni sul report "Dove sono stati pubblicati gli annunci". Per
maggiori dettagli su come le soglie e i metadati mancanti influiscono sui confronti tra visualizzazioni,
consulta Differenze delle metriche tra le visualizzazioni dei posizionamenti e Righe
con dettagli dei posizionamenti non disponibili.
Opzioni di TargetingSetting
Il comportamento e l'utilità di
group_placement_view sono influenzati da
TargetingSetting per la dimensione PLACEMENT
a livello di gruppo di annunci. Questa impostazione contiene un elenco di target_restrictions, ciascuno con un campo booleano bid_only che determina se gli annunci vengono pubblicati solo nei posizionamenti target o anche in altri posizionamenti. Consulta l'articolo Informazioni sulle impostazioni "Targeting" e "Osservazione".
bid_only = false: Questo valore corrisponde a Targeting nell'interfaccia utente di Google Ads per i posizionamenti. Se il gruppo di annunci è impostato su "Targeting", gli annunci vengono pubblicati solo nei posizionamenti che hai aggiunto esplicitamente come criteri. Puoi scegliere di applicare aggiustamenti delle offerte a questi posizionamenti. In questo scenario,group_placement_viewrispecchia ampiamentemanaged_placement_view, ma è comunque soggetto a soglie minime di attività.bid_only = true: questo valore corrisponde a Osservazione nell'interfaccia utente di Google Ads per i posizionamenti. Se il gruppo di annunci è impostato su "Osservazione", i tuoi annunci possono essere pubblicati in qualsiasi posizionamento idoneo sulla Rete Display e su YouTube. Puoi anche applicare aggiustamenti delle offerte ai posizionamenti che hai scelto come target. In questo caso,group_placement_viewè fondamentale per scoprire nuovi posizionamenti in cui vengono pubblicati i tuoi annunci, che potresti poi scegliere di aggiungere come posizionamenti gestiti o esclusioni.
Visualizzazione dettagliata del posizionamento
- Cosa mostra: la risorsa
detail_placement_viewfornisce una suddivisione più granulare dei posizionamenti, offrendo dettagli che vanno oltre il livello di dominio o canale. Ad esempio, può mostrare URL specifici o ID video di YouTube in cui sono stati pubblicati i tuoi annunci. - Equivalente nell'interfaccia utente: equivale a selezionare le righe in Contenuti > Dove sono stati pubblicati gli annunci e poi a fare clic su Visualizza dettagli.
- Query Builder: Esplora in Query Builder
- Considerazioni importanti: analogamente alla risorsa
group_placement_view, questa visualizzazione omette i posizionamenti con attività ridotta che non soddisfano le soglie minime di attività (consulta la sezione Riga "Totale: altro").
Differenze delle metriche tra le visualizzazioni dei posizionamenti
La soglia minima di attività viene valutata in modo indipendente a ogni livello di granularità:
- La risorsa
group_placement_viewvaluta la soglia nel dominio, nell'app mobile o nel canale YouTube aggregati. - La risorsa
detail_placement_viewvaluta la soglia separatamente per ogni singolo URL di pagina o video di YouTube.
La risorsa detail_placement_view omette gli URL delle singole pagine o i video di YouTube che non soddisfano la soglia. Di conseguenza, la somma delle righe detail_placement_view per un dominio o un canale YouTube (filtrate in base al campo detail_placement_view.group_placement_target_url) può restituire meno impressioni rispetto alla riga group_placement_view corrispondente.
Righe con dettagli dei posizionamenti non disponibili
Una query sulla risorsa group_placement_view o detail_placement_view può restituire più righe nello stesso gruppo di annunci con i campi placement, display_name e target_url non impostati e un valore resource_name identico (ad esempio, che termina con ~MTRf).
Questo comportamento si verifica per i seguenti motivi:
- Raggruppamento dei posizionamenti interni: entrambe le visualizzazioni raggruppano le metriche sul rendimento in base a un identificatore univoco del posizionamento interno anziché in base ai campi stringa
resource_nameoplacement. - Metadati dei posizionamenti non disponibili: nell'interfaccia utente di Google Ads, i posizionamenti senza metadati nelle tabelle di ricerca di backend vengono visualizzati come Sconosciuto, Canale non più disponibile o Video non più disponibile. Nell'API, ogni identificatore di posizionamento distinto restituisce comunque una riga di metriche, con i campi
placement,display_nameetarget_urlnon impostati. - Nomi delle risorse sintetizzati: il suffisso
{base64_placement}nel camporesource_nameè codificato in Base64 da{type_id}_{placement}, dove{type_id}è un identificatore interno del tipo di posizionamento anziché il numero dell'enumPlacementType. Quando il campoplacement_typeèWEBSITE(ID interno14) e il campoplacementnon è impostato, la stringa"14_"viene codificata inMTRf(analogamente,MOBILE_APPLICATIONcodifica"55_"inNTVf,YOUTUBE_VIDEOcodifica"89_"inODlfeYOUTUBE_CHANNELcodifica"90_"inOTBf). Più posizionamenti dello stesso tipo con metadati non disponibili nello stesso gruppo di annunci condividono quindi lo stesso valoreresource_name, mentre generano report su righe di metriche separate.
Quando elabori i risultati di group_placement_view o detail_placement_view nel codice client, non deduplicare le righe solo in base al campo resource_name, perché questa operazione può sovrascrivere le metriche in posizionamenti distinti con metadati non disponibili.
Per escludere le righe con metadati non disponibili in Google Ads Query Language, applica un filtro al campo target_url o display_name (ad esempio WHERE
detail_placement_view.target_url IS NOT NULL), perché i campi placement e resource_name non sono filtrabili.
Visualizzazione dei posizionamenti Performance Max
- Cosa mostra: la risorsa
performance_max_placement_viewfornisce i dati sulle impressioni (metrics.impressions) per i posizionamenti in cui sono stati pubblicati gli annunci Performance Max. Nella versione 24 e successive, puoi segmentareperformance_max_placement_viewpersegments.ad_network_type(non supportato nella versione 23). - Query Builder: Esplora in Query Builder
Quale vista utilizzare?
- Utilizza
managed_placement_viewper valutare il rendimento dei posizionamenti che stai scegliendo come target e per cui stai facendo offerte. - Utilizza
group_placement_viewper comprendere l'ambito completo di dove vengono pubblicati i tuoi annunci, soprattutto quando utilizzi l'impostazione "Osservazione", per scoprire nuove opportunità di targeting o esclusioni. - Utilizza
detail_placement_viewper ottenere i dettagli più granulari su URL o video specifici in cui sono stati pubblicati i tuoi annunci, spesso utilizzati dopo aver identificato un dominio o un canale di interesse ingroup_placement_view. - Utilizza
performance_max_placement_viewper esaminare le impressioni dei posizionamenti per le campagne Performance Max.