Questa guida mappa i concetti e le convenzioni di denominazione dei report nell'interfaccia utente di Google Ads ai report che puoi generare utilizzando il linguaggio di query 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 le relative mappature a Google Ads Query Language (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 corrispondono a una clausola WHERE che filtra in base a segments.date. |
| Filtri | Una o più condizioni nella clausola WHERE. |
| Campi del segmento | Applica la segmentazione includendo i campi dei segmenti nella query GAQL. |
| Impaginazione | L'impaginazione suddivide il set di risultati della query in più pagine. |
Colonne
Le colonne nell'interfaccia utente sono equivalenti a Resource fields, Segment fields e Metrics 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 controllare l'intervallo di date di queste statistiche.
Puoi applicare 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, puoi suddividere i dati per segmenti. Ad esempio, potresti essere interessato a vedere il numero di impressioni specifiche per la Rete di ricerca di Google separatamente dalla Rete Display di Google. In questo caso, segmenta il report per emittente. Consulta la sezione Segmentazione per scoprire come includere i campi dei segmenti nella clausola SELECT.
Impaginazione
Puoi spostarti tra 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.
La visualizzazione 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
Nell'interfaccia utente, 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 dovrai eseguire un po' di post-elaborazione. Consulta un esempio di codice che mostra come implementare la formattazione CSV in un client.
Pianificare e inviare i report per email
La pianificazione e l'invio per email di un report sono disponibili nell'interfaccia utente, ma non nell'API.
Report predefiniti
Puoi creare un elenco di report predefiniti nell'interfaccia utente di Google Ads.
Ecco un elenco dei report di base predefiniti e del relativo Nome risorsa GAQL corrispondente.
| Report predefiniti di base | Nome risorsa GAQL (da specificare nella clausola FROM) |
|---|---|
| Account | cliente |
| Campagna, Dettagli della campagna |
campaign |
| 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 il 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 quelli 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"