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 per i criteri.
Ogni visualizzazione viene unita alla risorsa criterio che corrisponde al suo livello di targeting (ad esempio, keyword_view viene unita a ad_group_criterion, mentre location_view viene unita a campaign_criterion). Ciò consente ai client dell'API Google Ads di richiedere i campi ad_group_criterion o campaign_criterion e la risorsa *_view nella stessa richiesta al metodo GoogleAdsService.SearchStream.
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 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 delle risorse principali fino a customer da una
visualizzazione dei criteri. Ad esempio, quando selezioni FROM keyword_view, puoi
richiedere campi da 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 attribuite della relativa pagina di riferimento. Ad
esempio, per keyword_view, puoi trovare le risorse nella relativa
pagina di riferimento.
Mappatura all'interfaccia utente
Ogni report sui criteri corrisponde a una visualizzazione specifica nell'interfaccia utente di Google Ads. La mappatura può aiutarti a riconciliare i dati dell'API con quelli visualizzati nell'interfaccia. Per un elenco più ampio di mappature, consulta Report nella UI.
Di seguito sono riportati alcuni report basati su criteri comuni e le relative posizioni tipiche dell'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.