Crea ed esegui i report

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

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.

  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 di tabelle e campi disponibili nella scheda Tabelle Google.
    • Visualizza un elenco delle tabelle proprietarie importate e dei relativi schemi nella scheda Tabelle proprietarie.
    • 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à recenti 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 su 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 sui 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 Google Ads collegato. 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 delle righe filtrate.
    • Scegli il progetto, il set di dati e la tabella BigQuery in cui devono essere salvati 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 ti consentono di specificare la modalità di esecuzione di un determinato report. Quando utilizzi SQL per creare un report (o quando modifichi il codice SQL da un modello di report), i parametri ti consentono di riutilizzare lo stesso codice SQL nei report e di impostare valori di parametro diversi su ogni copia del report. Ad esempio, puoi eseguire due report che condividono la stessa query o lo stesso modello SQL su insiemi diversi 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 nei report senza modificare i valori in SQL stesso.

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

  /* 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 (di 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. In 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. Consulta l'esempio che segue questi passaggi.
  7. Fai clic su Fine e poi su Salva.

Utilizzare un parametro

  1. Apri un report con i 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 i 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.

Riepilogo delle righe filtrate

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 aggiusta 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 le modifiche al report. Ad esempio, modifica il codice SQL, gestisci i valori dei parametri o imposta una pianificazione.
  4. Fai clic su Salva.

Creare un report

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, crealo e poi fai clic su Salva.
  3. Fai clic su + Imposta pianificazione.
  4. Nel riquadro Pianifica, fai clic sul pulsante di attivazione/disattivazione Pianifica l'esecuzione di questo report con i dettagli riportati di seguito in modo che sia attivo.
  5. In Frequenza, seleziona un intervallo e un'ora del giorno, quindi inserisci un fuso orario.
    • Per utilizzare un'espressione CRON, fai clic sul pulsante di attivazione/disattivazione Imposta la pianificazione utilizzando un'espressione CRON in posizione On, quindi inserisci l'espressione nella casella.
  6. Fai clic su Fine.
  7. Fai clic su Salva per applicare le modifiche al report.

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

Visualizza i tuoi risultati

Al termine dell'esecuzione 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.