Report nell'interfaccia utente di Google Ads

La UI di Google Ads offre funzionalità di generazione di report. 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 di report.

Questa guida mappa i concetti comuni dei report e le convenzioni di denominazione 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 per la mappatura delle schermate della UI all'API, consulta le seguenti risorse:

• Query Cookbook: una raccolta di query GAQL che replicano i dati presenti in molte schermate comuni della UI 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 della UI

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 di 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 dei segmenti	Applica la segmentazione includendo i campi di segmentazione nella query GAQL.
Impaginazione	La paginazione suddivide il set di risultati della query in più pagine.

Colonne

Le colonne nell'interfaccia utente equivalgono all'utilizzo di una clausola SELECT per i campi risorsa, i campi segmento o le metriche in GAQL.

Per saperne di più, consulta Informazioni sulle colonne della tabella delle statistiche.

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.

In GAQL hai lo stesso controllo filtrando in base a segments.date nella clausola WHERE di una query GAQL.

Filtri

I filtri nell'interfaccia utente equivalgono a una o più condizioni nella clausola WHERE di GAQL.

Per saperne di più, consulta Filtra la visualizzazione dei dati sul rendimento.

Segmentazione

Per statistiche più dettagliate, suddividi i dati in base ai segmenti. Ad esempio, supponiamo che tu voglia visualizzare 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 rete. Consulta Segmentazione per scoprire come includere i campi di segmentazione nella clausola SELECT.

Impaginazione

Naviga nei 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.

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.

Ordina i risultati

Nella UI, puoi ordinare i risultati selezionando una colonna.

In GAQL, puoi utilizzare la clausola ORDER BY e la clausola LIMIT per ordinare e limitare i risultati della query.

Formati di download

Nella 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 per il report sulle campagne in formato CSV per scoprire come implementare la formattazione CSV in un client.

Pianifica e invia report via email

Puoi pianificare e inviare un report via email dall'interfaccia utente, ma queste funzionalità non sono supportate nell'API.

Mappa le visualizzazioni della UI alle risorse API

Di seguito è riportato un elenco delle visualizzazioni UI comuni e del nome della risorsa GAQL corrispondente.

Visualizzazioni UI	Nome della risorsa GAQL (specifica nella clausola FROM)
Account	cliente
Campagna, Dettagli della 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
A pagamento e organiche (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 Risultati 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 degli ultimi 7 giorni (aggiungi segments.date alla clausola SELECT se vuoi che le metriche vengano 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 della UI con quelli dell'API, una delle differenze più comuni è che la UI esclude implicitamente le entità rimosse, mentre l'API no.

Per replicare una visualizzazione predefinita della UI, aggiungi un filtro utilizzando un campo status per escludere le righe rimosse (o includere esplicitamente le entità ENABLED e PAUSED). Ad esempio:

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'