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 il linguaggio di query di Google Ads (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 al 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 sono mappati a una clausola WHERE che filtra su segments.date. |
| Filtri | Una o più condizioni nella clausola WHERE. |
| Campi del segmento | Applica la segmentazione includendo i campi relativi alla segmentazione nella query GAQL. |
| Impaginazione | La creazione di pacchetti suddivide l'insieme di risultati della query in più pagine. |
Colonne
Le colonne nell'interfaccia utente equivalgono a Campi risorse, campi Segmento e Metriche in GAQL.
Applicazione dei filtri
Intervalli di date
Nell'interfaccia utente di Google Ads sono presenti una tabella che mostra le statistiche dell'account e un menu a discesa per controllare l'intervallo di date di queste statistiche.
Per avere lo stesso controllo in GAQL, filtra in base a segments.date nella clausola WHERE di una query GAQL.
Filtri
I filtri nell'interfaccia utente corrispondono a una o più condizioni nella clausola WHERE di GAQL.
Segmentazione
Per statistiche più dettagliate, puoi suddividere i dati per segmenti. Ad esempio, potresti voler vedere il numero di impressioni specifiche della rete di ricerca di Google separatamente da quello della Rete Display di Google. In questo caso, devi segmentare il report in base alla rete. Per informazioni su come includere i campi del segmento nella clausola SELECT, consulta Segmentazione.
Impaginazione
Puoi navigare tra i report nell'interfaccia utente utilizzando i controlli disponibili nella parte inferiore di ogni tabella di dati, che ti consentono di passare da una pagina all'altra e selezionare il numero di risultati da visualizzare da un insieme definito di dimensioni.
È possibile sfogliare i risultati quando si recuperano i report con GoogleAdsService.Search tramite next_page_token. Per 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 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 nel suo output, quindi dovresti eseguire alcune operazioni di post-elaborazione. Guarda un esempio di codice che mostra come implementare la formattazione CSV in un client.
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 nell'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 del relativo nome risorsa GAQL corrispondente.
| Report predefiniti di base | Nome della risorsa GAQL (specifica nella clausola FROM) |
|---|---|
| Account | cliente |
| Campagna, Dettagli 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 seguente GAQL per generare il report sull'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 sull'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"