Creare una query
- Vai alla scheda Query in Ads Data Hub.
- Fai clic su + Crea query. Viene visualizzata la pagina Modelli di query di analisi.
- (Facoltativo) Visualizza l'anteprima del modello SQL facendo clic su Espandi.
- Seleziona il modello che vuoi utilizzare facendo clic su Utilizza modello o facendo clic su Vuoto per iniziare da zero.
- Inserisci un nome per il report.
- Scrivi o modifica la query utilizzando SQL compatibile con BigQuery. Puoi trovare le tabelle e i campi disponibili e inserirli in SQL dalla scheda Tabelle Google.
- (Facoltativo) Configura i parametri.
- (Facoltativo) Configura il riepilogo filtrato delle righe.
- Fai clic su Salva.
Parametri
I parametri rendono le query più flessibili. Ad esempio, potresti eseguire la stessa query in più campagne. Invece di eseguire query duplicate o hardcoded degli ID campagna prima di ogni esecuzione, puoi configurare un parametro in modo da inserire uno o più ID campagna della scheda Esegui quando esegui una query. L'utilizzo dei parametri consente di scrivere il codice correttamente, riduce le possibilità di introdurre errori durante la modifica e consente di riutilizzare la query senza apportare modifiche. I parametri hanno come ambito la query in cui vengono creati, quindi puoi riutilizzarne il nome in un'altra query.
Tipi di parametri
Sono consentiti i seguenti tipi di parametri:
int64float64boolstringdatetimestamparray, uno dei tipi consentiti
Creare un parametro
- Apri una query salvata o creane una nuova.
- Fai clic su Proprietà > Parametri > Aggiungi parametro.
- Inserisci un nome nel campo Nome. Utilizzalo per fare riferimento al parametro nel testo della query.
- Utilizza il menu a discesa per selezionare il tipo di parametro.
- Se selezioni un array, viene visualizzato un menu a discesa aggiuntivo. Seleziona il tipo di array nel menu a discesa.
- (Facoltativo) Ripeti i passaggi 2-4 finché non hai aggiunto tutti i parametri che ti interessano.
- Fai clic su Salva
Utilizzare un parametro
Nel testo della query, utilizza il formato del parametro SQL standard, che precede
il nome del parametro con @. Nel seguente esempio, la query contiene un
parametro chiamato @campaign_ids:
/* Parameters:
* @campaign_ids (ARRAY of INT64): A list of campaign IDs
* to conduct analysis on */
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
Quando esegui la query, la finestra di dialogo Nuovo job contiene un campo Parametri. Inserisci i valori per ogni parametro che hai definito.
Rimuovere un parametro
- Apri la query contenente il parametro da eliminare.
- Apri la scheda Proprietà.
- Nella scheda Parametri, fai clic su Elimina accanto al parametro da eliminare.
- Fai clic su Salva.
Parametri riservati
La seguente tabella elenca i parametri riservati ad Ads Data Hub. Puoi utilizzare questi parametri nelle query, 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 alla query. 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 alla query. 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 del job relativo alla query. 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 per la privacy. 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.
Modificare una query
- Vai alla scheda Query in Ads Data Hub.
- Fai clic sul nome della query da modificare.
- Modifica la query.
- Fai clic su Salva.
Eseguire una query
Prima di eseguire una query, 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.
- Vai alla scheda Query in Ads Data Hub.
- Fai clic sul nome della query da eseguire.
- Fai clic su
Esegui.
- Nella parte superiore della pagina viene visualizzato il numero previsto di byte utilizzati dalla query.
- Seleziona un ID nel menu a discesa Dati pubblicitari da. Deve trattarsi dell'ID 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 menu a discesa Tabella delle corrispondenze da.
- Specifica dove salvare i risultati della query nel campo Tabella di destinazione.
- Inserisci le date di inizio e di fine per determinare l'intervallo di date della query.
- Inserisci un fuso orario. Deve corrispondere al fuso orario del canale di acquisto.
- (Facoltativo) Inserisci i valori dei parametri.
- Fai clic su Esegui.
Visualizzare i risultati
Al termine della query, puoi visualizzare l'anteprima dei risultati nella pagina "Job". 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.