Report nell'interfaccia utente

Questa guida mappa i concetti e le convenzioni di denominazione dei report nell'interfaccia utente di Google Ads ai report che puoi generare con il Linguaggio di query Google Ads (GAQL) e l'API 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 (GAQL)
Colonne	Qualsiasi risorsa, campo o metrica di segmento nella clausola SELECT di una query GAQL.
Intervallo di date	Gli intervalli di date vengono mappati a un filtro WHERE clausola su segments.date.
Filtri	Una o più condizioni nella clausola WHERE.
Campi del segmento	Applica la segmentazione includendo i campi dei segmenti nella query GAQL.
Impaginazione	La pagazione suddivide il set di risultati della query in più pagine.

Colonne

Le colonne nell'interfaccia utente sono equivalenti a campi di risorse, campi di segmento e metriche in GAQL.

Applicazione dei filtri

Intervalli di date

L'interfaccia utente di Google Ads presenta una tabella che mostra le statistiche dell'account e un menu a discesa per controllare l'intervallo di date di queste statistiche.

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

Filtri

I filtri nella UI corrispondono a una o più condizioni nella clausola WHERE di GAQL.

Segmentazione

Per statistiche più dettagliate, puoi suddividere i dati in base ai segmenti. Ad esempio, potresti voler visualizzare il numero di impressioni specifiche per la rete di ricerca di Google separatamente dalla Rete Display di Google. In questo caso, devi segmentare il report in base alla rete. Consulta la pagina relativa alla segmentazione per informazioni su come includere i campi dei segmenti nella clausola SELECT.

Impaginazione

Puoi esplorare i report nell'interfaccia utente utilizzando i controlli disponibili nella parte inferiore di ogni tabella di dati, che ti consentono di passare da una pagina all'altra e di selezionare il numero di risultati da visualizzare provenienti da un insieme definito di dimensioni.

La visualizzazione delle pagine dei risultati è disponibile quando si recuperano i report con GoogleAdsService.Search tramite next_page_token. Per recuperare l'intero set di risultati senza impaginazione, utilizza GoogleAdsService.SearchStream.

Risultati dell'ordine

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.

Scarica formati

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 dovrai eseguire un po' di post-elaborazione. Consulta un esempio di codice che mostra come implementare la formattazione CSV in un client.

Pianificare e inviare via email i report

La pianificazione e l'invio per email di un report sono disponibili nell'interfaccia utente, ma non sono supportate nell'API.

Report predefiniti

Puoi creare un elenco di report predefiniti nell'interfaccia utente di Google Ads.

Ecco un elenco dei report predefiniti di base e del rispettivo nome risorsa GAQL.

Report predefiniti di base	Nome risorsa GAQL (specifica nella clausola FROM)
Account	cliente
Campagna, Dettagli campagna	campagna
Gruppo di annunci, Dettagli del 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
Ricerca a pagamento e organica	paid_organic_search_term_view
Pagina di destinazione	landing_page_view
Pagina di destinazione espansa	expanded_landing_page_view

Come esempio dalla tabella precedente, puoi utilizzare il seguente GAQL per generare il report sull'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 confronti i report dell'interfaccia utente con i report delle 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"