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. Per le query Google Ads Query Language (GAQL) e curl pronte per l'esecuzione che replicano le schermate dei posizionamenti nell'interfaccia utente di Google Ads, consulta il Ricettario delle query.
Visualizzazione dei posizionamenti gestiti
- Cosa mostra: la risorsa
managed_placement_viewfornisce i dati sul rendimento aggregati in base ai criteri di posizionamento positivi che scegli come target nei gruppi di annunci. Questa visualizzazione include tutti e cinque i tipi di criteri gestiti in Contenuti > Posizionamenti nell'interfaccia utente di Google Ads: siti web, canali YouTube, video di YouTube, app mobile e categorie di app mobile. - Equivalente nell'interfaccia utente: Contenuti > Posizionamenti
- Query Builder: Esplora in Query Builder
Tipi di criteri di posizionamento target
Ogni riga della risorsa managed_placement_view compila il campo AdGroupCriterion che corrisponde al relativo valore ad_group_criterion.type e lascia non impostati gli altri campi del posizionamento:
| Tipo di posizionamento nell'UI | Valore ad_group_criterion.type |
Campi dei dettagli dei criteri | Note |
|---|---|---|---|
| Siti web | PLACEMENT |
ad_group_criterion.placement.url |
URL del sito web o del dominio di destinazione. |
| Canali YouTube | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
ID canale YouTube. Il campo ad_group_criterion.display_name restituisce il nome del canale. |
| Video di YouTube | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
ID video di YouTube. Il campo ad_group_criterion.display_name restituisce il titolo del video. |
| App | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name |
ID app nel formato {platform}-{platform_native_id} (1- per iOS, 2- per Android) e nome dell'app. |
| Categorie di app | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
Nome della risorsa nel formato mobileAppCategoryConstants/{mobile_app_category_id}. Consulta Nomi e gerarchia delle categorie di app mobile. |
Query di esempio
Per recuperare le metriche sul rendimento per tutti i tipi di posizionamento target negli ultimi 30 giorni, seleziona il campo ad_group_criterion.type insieme ai campi specifici per il tipo:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
Nomi e gerarchia delle categorie di app mobile
Nell'interfaccia utente di Google Ads, le categorie di app mobile targetizzate mostrano il percorso completo dello store, ad esempio Categorie di app > Apple App Store > Istruzione. Quando esegui query sull'API Google Ads, tieni presente i seguenti comportamenti:
- Costanti delle categorie di app mobile attribuite: la risorsa
mobile_app_category_constantnon è una risorsa attribuita della risorsamanaged_placement_view. Seleziona invece il campoad_group_criterion.mobile_app_category.mobile_app_category_constant(ad esempiomobileAppCategoryConstants/60503) o esegui una query sulla risorsaad_group_criterionquando non hai bisogno di metriche. - Nomi visualizzati solo per le categorie foglia: i campi
ad_group_criterion.display_nameemobile_app_category_constant.namerestituiscono solo il nome della categoria foglia, ad esempio"Education"o"Games". Nessuno dei due campi include il percorso dello store principale. - Risoluzione del percorso dello store: Google Play e l'App Store di Apple condividono i nomi delle categorie foglia tra ID criterio distinti. Ad esempio, gli ID criterio
60005(/All Apps/Google Play/Education),60060(/All Apps/Google Play/Family/Education) e60503(/All Apps/Apple App Store/Education) restituiscono tutti"Education"nei campinameedisplay_name. Estrai il suffisso{mobile_app_category_id}dal nome della risorsa e cerca il percorso completo della gerarchia nella tabella o nel file CSV Categorie di app mobile.
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
Query di esempio
La seguente query recupera le metriche sul rendimento per domini, app mobile e canali YouTube in cui sono stati pubblicati annunci negli ultimi 30 giorni:
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
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.
Impostazioni del targeting per posizionamento
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'UI 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").
Query di esempio
Per limitare il volume dei risultati, la seguente query recupera le metriche dei posizionamenti a livello di URL e di video in un periodo di 7 giorni. Per gli account di grandi dimensioni, filtra ulteriormente in base al campo campaign.id o ad_group.id:
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
Per escludere le righe in cui i metadati dei posizionamenti non sono disponibili, aggiungi AND
detail_placement_view.target_url IS NOT NULL (consulta Righe con dettagli dei posizionamenti non disponibili). Quando non hai bisogno dei campi resource_name restituiti, aggiungi la clausola PARAMETERS
omit_unselected_resource_names = true.
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 GAQL, filtra in base al campo target_url o display_name, perché i campi placement e resource_name non sono filtrabili. Ad esempio, utilizza WHERE group_placement_view.target_url IS
NOT NULL o WHERE detail_placement_view.target_url IS NOT NULL.
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). - Equivalente nell'UI: Insight e report > Editor di report > Posizionamento campagne Performance Max
- Query Builder: Esplora in Query Builder
Query di esempio
La seguente query recupera le impressioni dei posizionamenti segmentate per tipo di rete pubblicitaria per le campagne Performance Max negli ultimi 30 giorni:
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
Scegli una visualizzazione dei posizionamenti
- 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.