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 pagina di riferimento. Ad
esempio, per keyword_view, puoi trovare le relative risorse nella pagina
di riferimento.
Mappatura all'UI
Ogni report sui criteri corrisponde a una visualizzazione specifica nell'UI 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'UI.
Di seguito sono riportati alcuni report comuni basati sui criteri e le relative posizioni tipiche nell'UI:
- 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.