Questa guida illustra i concetti e le convenzioni di denominazione per i report nell'interfaccia utente di Google Ads ai report che puoi generare con il linguaggio di query di Google Ads (GAQL) e l'API Google Ads.
Termini comuni dell'interfaccia utente
La tabella seguente riassume alcuni dei termini comuni utilizzati nell'interfaccia utente e i relativi mappature al Linguaggio di query di Google Ads (GAQL).
| UI | GAQL |
|---|---|
| Colonne | Qualsiasi risorsa, campo del segmento o metrica nella clausola SELECT di una query GAQL. |
| Intervallo di date | Gli intervalli di date sono mappati a WHERE
clausola di filtro in base a segments.date. |
| Filtri | Una o più condizioni nella clausola WHERE. |
| Campi del segmento | Applicare la segmentazione includendo i campi relativi al segmento nella query GAQL. |
| Impaginazione | La suddivisione in pacchetti suddivide l'insieme di risultati la query in più pagine. |
Colonne
Le colonne nell'interfaccia utente equivalgono a Risorsa campi, Segmento campi e Metriche in GAQL.
Filtri
Intervalli di date
L'interfaccia utente di Google Ads contiene una tabella che mostra le statistiche dell'account e un menu a discesa per controllano l'intervallo di date di queste statistiche.
Hai lo stesso controllo in GAQL filtrando in base a
segments.date nella clausola WHERE di un GAQL
query.
Filtri
I filtri nell'interfaccia utente equivalgono a una o più condizioni in WHERE clausola di GAQL.
Segmentazione
Per statistiche più dettagliate, puoi suddividere i dati per segmenti. Ad esempio: potrebbe interessarti vedere il numero di impressioni specifiche per La rete di ricerca di Google è separata dalla Rete Display di Google. In questo caso, devi segmentare il tuo report in base alla rete. Consulta Segmentazione su come includere i campi del segmento nella clausola SELECT.
Impaginazione
Puoi navigare tra i report nell'interfaccia utente utilizzando i controlli disponibili nella in fondo a ogni tabella di dati che ti consente di cambiare pagina e selezionare il numero i risultati da visualizzare in un insieme definito di dimensioni.
È possibile sfogliare i risultati quando si recuperano report con
Da GoogleAdsService.Search a
next_page_token. Recuperare l'intero set di risultati
senza impaginazione, utilizza
GoogleAdsService.SearchStream
Risultati degli ordini
Nell'interfaccia utente puoi ordinare i risultati selezionando una colonna.
In GAQL, puoi utilizzare lo strumento ORDER BY clausola e LIMIT clausola per ordinare i risultati della query.
Formati di download
Nell'interfaccia utente, i report possono essere scaricati in vari formati, ad esempio CSV, TSV o XML.
L'API non supporta direttamente formati diversi nel suo output, quindi richiedono una post-elaborazione. Consulta un di un esempio di codice che mostra come implementare la formattazione CSV in una Google Cloud.
Pianifica e invia i report per email
La pianificazione e l'invio di un report via email sono disponibili nell'interfaccia utente, ma non sono supportate in l'API.
Report predefiniti
Puoi creare un elenco di report predefiniti nell'interfaccia utente di Google Ads.
Di seguito è riportato un elenco dei report predefiniti di base e delle relative risorse GAQL corrispondenti Nome.
| Report predefiniti di base | Nome risorsa GAQL (Specifica nella clausola FROM) |
|---|---|
| Account | cliente |
| Campagna, Dettagli della campagna |
campagna |
| Gruppo di annunci, Dettagli gruppo di annunci |
ad_group |
|
Annuncio, URL finale |
ad_group_ad |
| Parola chiave per la rete di ricerca | keyword_view |
| Termini di ricerca | search_term_view |
| Ricerca a pagamento e organica | paid_organic_search_term_view |
| Pagina di destinazione | landing_page_view |
| Pagina di destinazione espansa | expanded_landing_page_view |
Come esempio dalla tabella precedente, puoi utilizzare il GAQL seguente per generare Nel report Account:
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
Differenze comuni
Quando si confrontano i report dell'interfaccia utente con i report dell'API, una delle differenze più comuni è l'interfaccia utente esclude implicitamente le entità rimosse, mentre l'API no.
Per replicare una visualizzazione UI predefinita, devi aggiungere un filtro, in genere
utilizzando un campo status, per escludere le righe rimosse, ad esempio:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"