Report nell'interfaccia utente di Google Ads

L'interfaccia utente di Google Ads fornisce 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 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 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 il mapping delle schermate UI all'API, consulta le seguenti risorse:

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 corrispondono 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 La paginazione suddivide il set di risultati della query in più pagine.

Colonne

Le colonne nella UI sono equivalenti all'utilizzo di una clausola SELECT per Campi risorsa, Campi segmento o Metriche in GAQL.

Per ulteriori informazioni, vedi 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.

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 sono equivalenti a una o più condizioni nella clausola WHERE di GAQL.

Per ulteriori informazioni, vedi Filtrare la visualizzazione dei dati sul rendimento.

Segmentazione

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

Per scorrere i risultati durante il recupero dei report, utilizza GoogleAdsService.Search con 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 e limitare i risultati 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 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.

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 di Maps alle risorse API

Ecco un elenco delle visualizzazioni comuni della UI 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
Organiche 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 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'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, 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'
Indietro
Paging
Avanti
Mappare i parametri ValueTrack con i campi dei report