Crea ed esegui i report

Questa guida spiega come creare ed eseguire report, nonché come visualizzare i risultati.

Termine chiave: una query è il testo SQL alla base di un report. Un report è composto da più componenti, tra cui la query, le impostazioni di input e output, la pianificazione e i dettagli di esecuzione.

Creare un report

Gli analisti e i superutenti possono creare e modificare i report. Scopri di più sul controllo dell'accesso in Ads Data Hub.

Importante: per evitare di perdere le modifiche, fai clic su Salva dopo aver apportato aggiornamenti a un report, incluse le pianificazioni.

1. In Ads Data Hub, apri la pagina Report.
2. Fai clic su + Crea report. Viene visualizzata la pagina Creare un nuovo report.
   • Puoi filtrare i modelli cercando, selezionando le icone dei prodotti e scegliendo le opzioni del menu a discesa.
3. Scegli un modello e fai clic su Utilizza modello oppure fai clic su SQL per iniziare da zero.
   • Visualizza l'anteprima dei dettagli del modello e di SQL facendo clic su expand_content Espandi.
4. Per modificare il report, fai clic su Modifica query. Utilizza l'editor di query per:
   • Personalizza il report utilizzando SQL compatibile con BigQuery.
   • Configura i parametri nella scheda Proprietà.
   • Visualizza un elenco delle tabelle e dei campi disponibili nella scheda Tabelle Google.
   • Visualizza un elenco delle tabelle proprietarie importate e dei relativi schemi nella scheda Tabella proprietaria.
   • Esegui la query SQL facendo clic su Esegui. Tieni presente che le esecuzioni avviate dall'editor di query SQL non contribuiscono alla cronologia di esecuzione di un report e non saranno presenti nella sezione Attività recente della pagina Home.
   • Fai clic su Fine per confermare le modifiche alla query e tornare alla pagina di configurazione del report.
5. Inserisci un nome per il report.
6. Se applicabile, imposta i valori dei parametri nella scheda Configurazione.
7. Configura l'input e l'output per i job eseguiti in questo report:
   • Seleziona un'origine dati nel campo Dati pubblicitari da. Deve trattarsi dell'ID account Ads Data Hub associato ai dati pubblicitari su cui vuoi eseguire la query. Se vuoi eseguire query su dati sandbox, seleziona ADH Sandbox Customer.
   • Se utilizzi una tabella delle corrispondenze, selezionala nel campo Account tabella delle corrispondenze.
   • Seleziona un intervallo di date e un fuso orario per il report. Il fuso orario del report deve corrispondere a quello dell'account pubblicitario collegato, ad esempio un account Google Ads. Nota: l'intervallo di date personalizzato per il test delle query è supportato solo quando esegui la query dalla schermata dell'editor SQL.
   • (Facoltativo) Modifica le impostazioni della privacy e configura il riepilogo filtrato delle righe.
   • Scegli il progetto, il set di dati e la tabella BigQuery in cui salvare i risultati del report.
8. (Facoltativo) Imposta il report in modo che venga eseguito in base a una pianificazione.
9. Fai clic su Salva.

---

Parametri

I parametri consentono di specificare come deve essere eseguito un determinato report. Quando utilizzi SQL per creare un report (o quando modifichi SQL da un modello di report), i parametri ti consentono di riutilizzare lo stesso codice SQL in più report e di impostare valori di parametri diversi in ogni copia del report. Ad esempio, puoi eseguire due report che condividono la stessa query o lo stesso modello SQL su diversi insiemi di ID campagna configurando un parametro e impostandone il valore nella sezione Configurazione della pagina dei dettagli del report. L'utilizzo dei parametri consente di scrivere il codice SQL correttamente, riduce le possibilità di introdurre errori durante la modifica e consente di riutilizzare la stessa query SQL in più report senza modificare i valori nell'SQL stesso.

Nel seguente esempio, il report contiene un parametro chiamato campaign_ids, che accetta un array di int64 ID campagna:

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

Tipi di parametri

Sono consentiti i seguenti tipi di parametri:

• int64
• float64
• bool
• string
• date
• timestamp
• array (uno dei tipi consentiti)

Aggiungere un parametro a un report

1. Apri un report salvato o creane uno nuovo.
2. Fai clic su Modifica query.
3. Nella sezione Proprietà, fai clic su Aggiungi parametro.
4. Inserisci un nome nel campo Nome. Utilizzalo per fare riferimento al parametro nel testo del report.
5. Utilizza il menu a discesa per selezionare il tipo di parametro.
   • Se scegli il tipo di array, viene visualizzato un menu a discesa aggiuntivo. Seleziona il tipo di array in questo menu a discesa.
6. Nella query SQL, aggiungi il parametro utilizzando il formato del parametro SQL standard: @PARAMETER_NAME. Vedi l'esempio che segue questi passaggi.
7. Fai clic su Fine e poi su Salva.

Utilizzare un parametro

1. Apri un report con parametri configurati.
2. Nel riquadro Configurazione, inserisci i valori per ogni parametro che hai definito.
3. Fai clic su Salva per conservare i valori dei parametri.

Rimuovere un parametro

1. Apri un report con parametri configurati.
2. Fai clic su Modifica query per aprire l'editor SQL.
3. In Proprietà, fai clic su Elimina Elimina accanto al parametro da eliminare.
4. Fai clic su Fine e poi su Salva.

Parametri riservati

La seguente tabella elenca i parametri riservati ad Ads Data Hub. Puoi utilizzare questi parametri nei report, ma non puoi creare un parametro con lo stesso nome di un parametro riservato.

start_date	date La data di inizio (inclusa) del job relativo al report. Un parametro definito dall'utente con questo nome verrà ignorato e sostituito con i valori impostati nella finestra di dialogo Nuovo job.
end_date	date La data di fine (inclusa) del job relativo al report. Un parametro definito dall'utente con questo nome verrà ignorato e sostituito con i valori impostati nella finestra di dialogo Nuovo job.
time_zone	string Il fuso orario per il job di report. Un parametro definito dall'utente con questo nome verrà ignorato e sostituito con i valori impostati nella finestra di dialogo Nuovo job. Suggerimento: per evitare discrepanze quando utilizzi i fusi orari nel report, ad esempio nelle clausole WHERE, puoi usare time_zone per ottenere lo stesso fuso orario impostato in Nuovo job. Inoltre, è importante utilizzare lo stesso fuso orario dell'origine dati.
params	string Spazio dei nomi per la denominazione delle tabelle esportate. Utilizza il seguente formato per creare un segnaposto nella query, quindi fornisci il nome della tabella quando generi il report: params.TABLE_NAME (non utilizzare la @ iniziale utilizzata da altri parametri). Per ulteriori informazioni ed esempi sull'utilizzo di questo parametro, vedi Esportare più tabelle utilizzando una sola query.

---

Riepilogo delle righe filtrate

Nota: i riepiloghi delle righe filtrate non sono necessari quando utilizzi la modalità di rumore. Scopri i vantaggi dell'utilizzo del rumore anziché dei controlli delle differenze.

I riepiloghi delle righe filtrate contengono i dati filtrati a causa dei controlli delle differenze. I dati delle righe filtrate vengono sommati e aggiunti a una riga catch-all. Sebbene non possano essere ulteriormente analizzati, i dati filtrati forniscono un riepilogo del volume dei dati esclusi dai risultati. Per le query che utilizzano la modalità di privacy dei controlli delle differenze, Ads Data Hub attiva e configura automaticamente un riepilogo delle righe filtrate. Mentre modifichi la query, Ads Data Hub regola automaticamente la configurazione in base alle colonne selezionate. Per scoprire di più sui riepiloghi delle righe filtrate o per configurarne uno manualmente, consulta Riepilogo delle righe filtrate.

---

Modificare un report

1. In Ads Data Hub, apri la pagina Report.
2. Fai clic sul nome del report da modificare.
3. Apporta modifiche al report. Ad esempio, modifica l'SQL, gestisci i valori dei parametri o imposta una pianificazione.
4. Fai clic su Salva.

---

Creare un report

Punto chiave: puoi testare le query SQL utilizzando l'ambiente sandbox prima di eseguirle sui dati reali. Scopri di più sulle best practice per la scrittura di query in Ads Data Hub

Prima di eseguire un report, assicurati di aver concesso all'account di servizio l'autorizzazione dataEditor per il set di dati che conterrà l'output dei join. Scopri di più sul controllo dell'accesso in BigQuery.

1. In Ads Data Hub, apri la pagina Report.
2. Fai clic sul nome del report da eseguire.
3. Fai clic su Esegui.

Eseguire un report in base a una pianificazione

1. In Ads Data Hub, apri la pagina Report.
2. Fai clic sul nome del report per cui vuoi impostare una pianificazione.
   • Per impostare una pianificazione per un nuovo report, crea il report e poi fai clic su Salva.
3. Fai clic su + Imposta pianificazione.
4. Nel riquadro Pianificazione, fai clic sul pulsante di attivazione/disattivazione Pianifica l'esecuzione di questo report con i dettagli riportati di seguito per attivarlo.
5. In Frequenza, seleziona un intervallo e un'ora del giorno, poi inserisci un fuso orario.
   • Per utilizzare un'espressione cron, fai clic sul pulsante di attivazione/disattivazione Imposta la pianificazione utilizzando un'espressione cron per attivarlo, quindi inserisci l'espressione nella casella.
6. Fai clic su Fine.
7. Fai clic su Salva per applicare le modifiche al report.

Per mostrare i job pianificati nella pagina Home, seleziona Chiunque dall'elenco dei filtri Proprietario.

---

Visualizza i tuoi risultati

Al termine del report, puoi visualizzare l'anteprima dei risultati nella pagina dei dettagli del report. Per visualizzare i risultati in un secondo momento, apri il report dalla pagina Home. Puoi anche esplorare i dati in BigQuery, Fogli o Data Studio.

Anteprima

Fai clic su Anteprima nel job completato. I primi 20 risultati verranno visualizzati sotto il job.

BigQuery

I risultati vengono esportati in BigQuery per impostazione predefinita. Fai clic su Visualizza tabella per aprire BigQuery in una nuova finestra.

Fogli e Data Studio

Apri il menu a discesa Esplora e seleziona Esplora con Fogli o Esplora con Data Studio tra le opzioni disponibili. Si aprirà una nuova finestra contenente i dati.