Metriche dei criteri

Nell'API Google Ads, ogni report sui criteri è rappresentato da una risorsa separata. Se non diversamente necessario, le risorse *_view contengono solo un campo resource_name.

I client API Google Ads devono specificare i campi ad_group_criterion o campaign_criterion corrispondenti se è necessario recuperare dati specifici dei criteri. Ogni visualizzazione si unisce alla risorsa del criterio che corrisponde al suo livello di targeting (ad esempio, keyword_view si unisce a ad_group_criterion, mentre location_view si unisce a campaign_criterion). In questo modo, i client API Google Ads possono richiedere i campi ad_group_criterion o campaign_criterion e la risorsa *_view nella stessa richiesta al metodo GoogleAdsService.SearchStream.

Nota: le risorse dei criteri *_view riflettono le metriche sul rendimento. I criteri che non hanno ricevuto impressioni durante l'intervallo di date specificato, nonché i criteri esclusi (come le parole chiave escluse o le località escluse), non generano metriche e vengono esclusi da queste visualizzazioni.

Esempio di richiesta di query

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

Per recuperare i dati sul rendimento (metriche) per un tipo di criterio specifico, specifica la risorsa di visualizzazione corrispondente nella clausola FROM. Ad esempio, utilizza keyword_view nella clausola FROM e i campi metrics nella clausola SELECT per recuperare le metriche delle parole chiave.

Puoi selezionare i campi dalle risorse principali fino a customer da una visualizzazione dei criteri. Ad esempio, quando selezioni FROM keyword_view, puoi richiedere i campi di tutte le seguenti risorse:

• ad_group_criterion
• ad_group
• campaign
• customer

Per scoprire le risorse che possono essere richieste in questo modo per una determinata risorsa, consulta la riga Risorse attribuite della relativa pagina di riferimento. Ad esempio, per keyword_view, puoi trovare le risorse nella relativa pagina di riferimento.

Mappatura alla UI

Ogni report sui criteri corrisponde a una visualizzazione specifica nell'interfaccia utente di Google Ads. La mappatura di questi elementi può aiutarti a riconciliare i dati dell'API con ciò che vedi nell'interfaccia. Per un elenco più ampio di mappature, consulta Report nell'interfaccia utente.

Di seguito sono riportati alcuni report comuni basati su criteri e le relative posizioni tipiche nell'interfaccia utente:

• Campagne > Segmenti di pubblico, parole chiave e contenuti > Parole chiave per la rete di ricerca: restituisce dati equivalenti a keyword_view.
• Campagne > Segmenti di pubblico, parole chiave e contenuti > Segmenti di pubblico > Dati demografici: restituisce dati equivalenti a age_range_view e gender_view.
• Campagne > Località: restituisce dati equivalenti a location_view.