Questa guida mappa i concetti e le convenzioni di denominazione per i report nell'interfaccia utente di Google Ads ai report che puoi generare utilizzando Google Ads Query Language (GAQL) e l'API Google Ads.
Termini comuni dell'interfaccia utente
La seguente tabella riassume alcuni dei termini comuni utilizzati nell'interfaccia utente e le relative mappature in Google Ads Query Language (GAQL).
| UI | GAQL |
|---|---|
| Colonne | Qualsiasi risorsa, campo segmento o metrica nella clausola SELECT di una query GAQL. |
| Intervallo di date | Gli intervalli di date vengono mappati a una clausola WHERE che filtra in base a segments.date. |
| Filtri | Una o più condizioni nella clausola WHERE. |
| Campi di segmento | Applica la segmentazione includendo i campi dei segmenti nella query GAQL. |
| Impaginazione | La paginazione suddivide il set di risultati della query in più pagine. |
Colonne
Le colonne nell'interfaccia utente sono equivalenti a Campi risorsa, Campi segmento e Metriche in GAQL.
Filtri
Puoi filtrare e organizzare i dati nei report.
Intervalli di date
L'interfaccia utente di Google Ads include una tabella che mostra le statistiche dell'account e un menu a discesa per controllare l'intervallo di date di queste statistiche.
Puoi utilizzare lo stesso controllo in GAQL filtrando in base a
segments.date nella clausola WHERE di una query
GAQL.
Filtri
I filtri nell'interfaccia utente sono equivalenti a una o più condizioni nella clausola WHERE di GAQL.
Segmentazione
Per statistiche più dettagliate, dividi i dati in segmenti. Ad esempio, supponiamo di voler visualizzare il numero di impressioni specifico della rete di ricerca di Google separatamente dalla Rete Display di Google. In questo caso, segmenta il report per rete. Consulta la sezione Segmentazione per scoprire come includere i campi segmento nella clausola SELECT.
Impaginazione
Esplora i report nell'interfaccia utente utilizzando i controlli disponibili nella parte inferiore di ogni tabella di dati, che ti consentono di cambiare pagina e selezionare il numero di risultati da visualizzare da un insieme definito di dimensioni.
Lo scorrimento delle pagine dei risultati è disponibile quando recuperi i report con
GoogleAdsService.Search tramite
next_page_token. Per recuperare l'intero set di risultati
senza paginazione, utilizza
GoogleAdsService.SearchStream.
Ordina risultati
Nella UI, puoi ordinare i risultati selezionando una colonna.
In GAQL, puoi utilizzare la clausola ORDER BY e la clausola LIMIT per ordinare il risultato 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 nell'output, quindi devi eseguire alcune operazioni di post-elaborazione. Consulta questo esempio di codice che mostra come implementare la formattazione CSV in un client.
Pianificare e inviare report via email
Puoi pianificare e inviare un report via email dall'interfaccia utente, ma queste funzionalità non sono supportate nell'API.
Report predefiniti
Puoi creare un elenco di report predefiniti nell'interfaccia utente di Google Ads.
Ecco un elenco dei report predefiniti di base e del nome della risorsa GAQL corrispondente.
| Report predefiniti di base | Nome risorsa GAQL (specificare nella clausola FROM) |
|---|---|
| Account | cliente |
| Campaign, Campaign details |
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 |
| A pagamento e organici | paid_organic_search_term_view |
| Pagina di destinazione | landing_page_view |
| Pagina di destinazione espansa | expanded_landing_page_view |
Come esempio della tabella precedente, puoi utilizzare la seguente GAQL per generare il 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 è che l'interfaccia utente filtra implicitamente le entità rimosse, mentre l'API no.
Per replicare una visualizzazione dell'interfaccia utente 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"