Report nell'interfaccia utente di Google Ads

L'interfaccia utente di Google Ads fornisce funzionalità di reporting. Per creare un report, accedi al tuo account Google Ads. Fai clic su Campagne a sinistra, quindi su Statistiche e report. Per creare un report da zero, fai clic su Editor report.

Questa guida mappa i concetti di reporting e le convenzioni di denominazione comuni nell'interfaccia utente di Google Ads ai report che puoi generare utilizzando Google Ads Query Language (GAQL) e l'API Google Ads. Puoi anche seguire i prompt nell'interfaccia utente per creare il report più adatto alle tue esigenze.

Strumenti e risorse

Per esempi più dettagliati e assistenza automatizzata nella mappatura delle schermate dell'interfaccia utente all'API, consulta le seguenti risorse:

• Query Cookbook: una raccolta di query GAQL che replicano i dati presenti in molte schermate comuni dell'interfaccia utente di Google Ads.
• Estensione per i report dell'API Google Ads: un'estensione di Chrome che ti aiuta a identificare i nomi dei campi e delle risorse dell'API direttamente nell'interfaccia utente di Google Ads.

Termini comuni dell'interfaccia utente

La seguente tabella 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 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 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'interfaccia utente sono equivalenti all'utilizzo di una clausola SELECT per i campi risorsa, i campi segmento o le metriche in GAQL.

Consulta Informazioni sulle colonne della tabella delle statistiche

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 avere 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.

Consulta Filtro della visualizzazione dei dati sul rendimento.

Segmentazione

Per statistiche più dettagliate, suddividi i dati per segmenti. Supponiamo, ad esempio, 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

Nell'interfaccia utente, puoi navigare tra i report 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.

L'impaginazione dei risultati è disponibile quando recuperi i report con GoogleAdsService.Search tramite next_page_token. Per recuperare l'intero set di risultati senza impaginazione, utilizza GoogleAdsService.SearchStream.

Ordinare i 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 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.

Mappare le visualizzazioni dell'interfaccia utente alle risorse dell'API

Ecco un elenco di visualizzazioni comuni dell'interfaccia utente e dei relativi nomi di risorse GAQL corrispondenti.

Visualizzazioni dell'interfaccia utente	Nome risorsa GAQL (specifica 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
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
Pubblico > Dati demografici > Età	age_range_view
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 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 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 predefinita dell'interfaccia utente, 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'