L'UI di Google Ads offre funzionalità di reporting. Per creare un report, accedi al tuo account Google Ads, fai clic su Campagne nel menu di navigazione a sinistra e poi su Approfondimenti e report. Per creare un report da zero, fai clic su Editor report.
Questa guida associa i concetti di reporting e le convenzioni di denominazione comuni nell'UI di Google Ads ai report che puoi generare utilizzando Google Ads Query Language (GAQL) e l'API Google Ads. Puoi anche seguire le istruzioni nell'UI per creare il report più adatto alle tue esigenze.
Strumenti e risorse
Per esempi più dettagliati e assistenza automatizzata per l'associazione delle schermate dell'UI all'API, consulta le seguenti risorse:
- Query Cookbook: una raccolta di query GAQL che replicano i dati presenti in molte schermate comuni dell'UI di Google Ads.
- Estensione di reporting dell'API Google Ads: un'estensione di Chrome che ti aiuta a identificare i nomi dei campi e delle risorse dell'API direttamente nell' UI di Google Ads.
Termini comuni dell'UI
La tabella seguente riassume alcuni dei termini comuni utilizzati nell'UI e le relative mappature in Google Ads Query Language (GAQL).
| UI | GAQL |
|---|---|
| Colonne | Qualsiasi risorsa, campo segmento o metrica nella SELECT clausola
di una query GAQL. |
| Intervallo di date | Gli intervalli di date vengono mappati in una WHERE clausola
che filtra in base a segments.date. |
| Filtri | Una o più condizioni nella WHERE clausola. |
| Campi segmento | Applica la segmentazione includendo i campi segmento nella query GAQL. |
| Impaginazione | L'impaginazione suddivide il set di risultati della query in più pagine. |
Colonne
Le colonne nell'UI sono equivalenti all'utilizzo di una clausola SELECT per
i campi risorsa,
i campi segmento o
le metriche in GAQL.
Per ulteriori informazioni, consulta Informazioni sulle colonne della tabella delle statistiche.
Intervalli di date
L'UI 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 avere lo stesso controllo in GAQL filtrando in base a
segments.date nella clausola WHERE di una query GAQL.
Filtri
I filtri nell'UI sono equivalenti a una o più condizioni nella
WHERE clausola di GAQL.
Per ulteriori informazioni, consulta Filtrare la visualizzazione dei dati sul rendimento.
Segmentazione
Per statistiche più dettagliate, suddividi i dati per segmenti. Ad esempio, supponiamo che tu voglia 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 Segmentazione per scoprire come
includere i campi segmento nella clausola SELECT.
Impaginazione
Naviga nei report nell'UI 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.
Per scorrere i risultati durante il recupero dei report, utilizza
GoogleAdsService.Search con
next_page_token. Per recuperare l'intero set di risultati
senza impaginazione, utilizza
GoogleAdsService.SearchStream.
Ordinare i risultati
Nell'UI puoi ordinare i risultati selezionando una colonna.
In GAQL, puoi utilizzare le ORDER BY clausole e
LIMIT clausole per ordinare e limitare i risultati della query.
Formati di download
Nell'UI, i report possono essere scaricati in vari formati, ad esempio CSV, TSV o XML.
L'API non formatta direttamente l'output in file come CSV, quindi l'applicazione client deve formattare la risposta. Consulta l'esempio di codice Report sulla campagna in formato CSV sample per scoprire come implementare la formattazione CSV in un client.
Pianificare e inviare report via email
Puoi pianificare e inviare un report via email dall'UI, ma queste funzionalità non sono supportate nell'API.
Mappare le visualizzazioni dell'UI alle risorse dell'API
Ecco un elenco delle visualizzazioni comuni dell'UI e dei relativi nomi di risorse GAQL.
| Visualizzazioni dell'UI | Nome della risorsa GAQL (specifica nella clausola FROM) |
|---|---|
| Account | customer |
| 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 |
| Organici e a pagamento (modello scenario competitivo)* |
paid_organic_search_term_view |
| Pagina di destinazione | landing_page_view |
| Pagina di destinazione espansa | expanded_landing_page_view |
| Contenuti > Posizionamenti | managed_placement_view |
| Contenuti > Dove sono stati pubblicati gli annunci | group_placement_view |
| Contenuti > Dove sono stati pubblicati gli annunci > Visualizza dettagli | detail_placement_view |
| Segmenti di pubblico > Dati demografici > Età | age_range_view |
| Segmenti di pubblico > Dati demografici > Genere | gender_view |
| Località | location_view |
| Contenuti > Argomenti | topic_view |
| Località > Report geografico | geographic_view |
* Per generare il report Organici e a pagamento, devi collegare un account Google Search Console al tuo account Google Ads a livello di cliente.
Ad esempio, dalla tabella precedente puoi utilizzare la seguente query GAQL per generare un report sull'account aggregato negli ultimi 7 giorni (aggiungi segments.date alla clausola SELECT se vuoi che le metriche siano suddivise per giorno):
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'UI con i report dell'API, una delle differenze più comuni è che l'UI filtra implicitamente le entità rimosse, mentre l'API no.
Per replicare una visualizzazione predefinita dell'UI, aggiungi un filtro utilizzando un campo status per escludere le righe rimosse (o includi esplicitamente le entità ENABLED e PAUSED). Ad esempio:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'