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 dell'API Google Ads devono specificare i campi ad_group_criterion o campaign_criterion corrispondenti se è necessario recuperare dati specifici dei criteri. In questo modo, i client dell'API Google Ads possono richiedere ad_group_criterion o campaign_criterion campi e la risorsa *_view nella stessa richiesta al GoogleAdsService.SearchStream metodo.

Richiesta di query di esempio

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 criteri specifico, specifica la risorsa di visualizzazione corrispondente nella clausola FROM. Ad esempio, utilizza keyword_view nella clausola FROM e alcuni campi metrics nella clausola SELECT per recuperare le metriche delle parole chiave.

Puoi selezionare i campi delle risorse principali fino a customer da una visualizzazione dei criteri. Ad esempio, quando selezioni FROM la 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, controlla la riga Risorse degli attributi della relativa pagina di riferimento. Ad esempio, per keyword_view, puoi trovare le relative risorse nella pagina di riferimento.

Mappatura all'interfaccia utente

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 quelli visualizzati nell'interfaccia. Per un elenco più ampio di mappature, consulta Report nell'interfaccia utente.

Di seguito sono riportati alcuni report comuni basati sui 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.