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 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 e le convenzioni di denominazione comuni dei report nell'interfaccia utente di Google Ads con i report che puoi generare utilizzando Google Ads Query Language (GAQL) e l'API Google Ads. Puoi anche seguire le istruzioni nella UI per creare il report più adatto alle tue esigenze.

Strumenti e risorse

Per esempi più dettagliati e assistenza automatizzata per il mapping delle schermate 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 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 in 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 dei segmenti nella query GAQL.
Impaginazione	La paginazione 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 Campi risorsa, Campi segmento o Metriche in GAQL.

Consulta la sezione 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 utilizzare 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, dividi i dati in segmenti. Ad esempio, supponiamo di voler 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 la sezione Segmentazione per scoprire come includere i campi segmento nella clausola SELECT.

Impaginazione

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

Lo scorrimento delle pagine 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

Nella UI, 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.

Visualizzazioni dell'UI della mappa per le risorse API

Ecco un elenco di visualizzazioni comuni dell'interfaccia utente e del nome della risorsa GAQL corrispondente.

Visualizzazioni della UI	Nome 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
Organico 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 Risultati organici e a pagamento, devi collegare un account Google Search Console al tuo account Google Ads a livello di cliente.

Come esempio della tabella precedente, puoi utilizzare la seguente query 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 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'