Monitorare il posizionamento e il rendimento degli annunci

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_view fornisce 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_constant non è una risorsa attribuita della risorsa managed_placement_view. Seleziona invece il campo ad_group_criterion.mobile_app_category.mobile_app_category_constant (ad esempio mobileAppCategoryConstants/60503) o esegui una query sulla risorsa ad_group_criterion quando non hai bisogno di metriche.
  • Nomi visualizzati solo per le categorie foglia: i campi ad_group_criterion.display_name e mobile_app_category_constant.name restituiscono 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) e 60503 (/All Apps/Apple App Store/Education) restituiscono tutti "Education" nei campi name e display_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_view mostra 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.placement o detail_placement_view.placement ha 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_view rispecchia ampiamente managed_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_view fornisce 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_view valuta la soglia nel dominio, nell'app mobile o nel canale YouTube aggregati.
  • La risorsa detail_placement_view valuta 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_name o placement.
  • 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_name e target_url non impostati.
  • Nomi delle risorse sintetizzati: il suffisso {base64_placement} nel campo resource_name è codificato in Base64 da {type_id}_{placement}, dove {type_id} è un identificatore interno del tipo di posizionamento anziché il numero dell'enum PlacementType. Quando il campo placement_type è WEBSITE (ID interno 14) e il campo placement non è impostato, la stringa "14_" viene codificata in MTRf (analogamente, MOBILE_APPLICATION codifica "55_" in NTVf, YOUTUBE_VIDEO codifica "89_" in ODlf e YOUTUBE_CHANNEL codifica "90_" in OTBf). Più posizionamenti dello stesso tipo con metadati non disponibili nello stesso gruppo di annunci condividono quindi lo stesso valore resource_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_view fornisce i dati sulle impressioni (metrics.impressions) per i posizionamenti in cui sono stati pubblicati gli annunci Performance Max. Nella versione 24 e successive, puoi segmentare performance_max_placement_view per segments.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_view per valutare il rendimento dei posizionamenti che stai scegliendo come target e per cui stai facendo offerte.
  • Utilizza group_placement_view per 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_view per 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 in group_placement_view.
  • Utilizza performance_max_placement_view per esaminare le impressioni dei posizionamenti per le campagne Performance Max.