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_criterionad_groupcampaigncustomer
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_viewegender_view. - Campagne > Località: restituisce dati equivalenti a
location_view.