Skip to main content
Ogni query che crei nell’Explorer è un’istruzione AftersellQL (AQL). Nella maggior parte dei casi crei le query in modo visuale e non scrivi mai AQL a mano; questa pagina è il riferimento per le metriche e le dimensioni che puoi scegliere, per la forma testuale di AQL e per le regole sui fusi orari.

Metriche disponibili

Queste sono le metriche che puoi scegliere, raggruppate nello stesso modo in cui le raggruppa il selettore delle metriche.

Ricavi e profitto

Conversioni

Interazione

Prestazioni del negozio

Rete Rokt

Dimensioni

Le dimensioni suddividono una metrica in base a un attributo. Non tutte le dimensioni sono compatibili con ogni metrica; l’Explorer impedisce automaticamente le combinazioni incompatibili (ad esempio, Decline rate e Show rate non possono essere suddivise per Currency).

Dimensioni disponibili

Dimensioni non disponibili

Le seguenti sono ancora in fase di sviluppo. Compaiono nel selettore ma risultano ‘Not compatible’ per ogni metrica finché non saranno implementate.

Sintassi delle istruzioni AQL

Un’istruzione AQL è una singola domanda composta da clausole. Solo SELECT e un intervallo di tempo (SINCE) sono obbligatori; tutto il resto è facoltativo. Quando includi clausole facoltative, devono comparire in questo ordine:
Un esempio minimo, ricavi da upsell giornalieri e tasso di accettazione degli ultimi 30 giorni:
Le parole chiave non fanno distinzione tra maiuscole e minuscole (SELECT e select funzionano entrambe) e le istruzioni non terminano con un punto e virgola. I valori stringa sono racchiusi tra virgolette doppie; i numeri e gli elenchi no.

SELECT e GROUP BY

  • SELECT elenca le metriche da misurare, separate da virgole, ad esempio SELECT revenue, impressions, accept_rate.
  • GROUP BY suddivide quelle metriche in base a una o più dimensioni, come date, device, surface o funnel. Senza GROUP BY, ottieni un unico totale per l’intero periodo.

Filtrare con WHERE

WHERE restringe i dati prima che vengano misurati. Combina le condizioni con AND.
impressions, accept_rate e rpv non possono essere filtrate o raggruppate per dispositivo, funnel, placement o prodotto; il loro rollup di origine non ha una colonna di questo tipo. L’aggiunta di WHERE device = "mobile" a una query che seleziona una di esse viene rifiutata con metric "impressions" cannot be filtered by "device".
I confronti supportati sono =, !=, IN, NOT IN, >, <, >= e <=. Usa un elenco con IN per corrispondere a più valori:
experiment non è un campo filtrabile; non ha una fonte di rollup, quindi WHERE experiment IN [...] viene rifiutato con filters on "experiment" are not supported. Il filtro funnel supporta la selezione multipla: is one of (IN) include solo i funnel selezionati, is not one of (NOT IN) li esclude. Quando raggruppi per Funnel e applichi un filtro is one of, il grafico mostra una linea per ogni funnel selezionato, senza raggruppamento in “Other”.

Intervalli di tempo e confronti

Ogni query ha bisogno di un intervallo di tempo, impostato con SINCE: Preimpostazioni disponibili: last_1d, last_7d, last_30d, last_90d, this_month, last_month e this_year.
  • GRAIN imposta la dimensione degli intervalli per le serie temporali: day, week o month. (hour viene interpretato, ma nessun rollup fornisce dati orari, quindi una query di questo tipo viene rifiutata con group_by / time_grain combination is not supported.)
  • COMPARE sovrappone un secondo periodo. Usa previous_period, la finestra di pari durata immediatamente precedente. previous_year è nascosto dal selettore Compare perché il data warehouse non contiene dati precedenti a febbraio 2026; resta digitabile in AQL solo affinché le query salvate in precedenza continuino a essere interpretate.
I dati di reporting partono da febbraio 2026, quindi una finestra precedente a tale data restituisce risultati vuoti per entrambi i periodi.

Scegliere un grafico

  • CHART imposta come viene visualizzato il risultato: scorecard, line_chart, bar_chart, area_chart, funnel_chart o table.
  • TIMEZONE imposta il fuso orario usato per raggruppare le date, come nome IANA tra virgolette, ad esempio TIMEZONE "America/New_York". Il valore predefinito è UTC (vedi Fusi orari).
Il tipo funnel_chart ha requisiti specifici:
  • Modalità placement. Raggruppa per placement e seleziona una metrica. Le fasi sono ordinate secondo la sequenza canonica dei placement (upsell predefinito, poi downsell, poi upsell aggiuntivi). Viene tracciata solo la prima metrica; le metriche aggiuntive sono indicate in una nota a piè di pagina.
  • Modalità metrica. Seleziona due o più metriche senza GROUP BY. Ogni metrica diventa una fase del funnel nell’ordine della query (ad esempio, SELECT impressions, conversions mostra il calo da impressioni a conversioni). Tutte le metriche devono avere la stessa unità.
La modalità placement richiede una metrica che possa essere suddivisa per placement. impressions, accept_rate e rpv non possono esserlo; per queste il grafico a funnel mostra “These metrics can’t be grouped by placement”.

Ordinamento e limitazione

  • ORDER BY ordina i risultati in base a una metrica o dimensione, con ASC o DESC.
  • LIMIT limita il numero di righe restituite, utile per domande del tipo “top N”.

Altri esempi

impressions, accept_rate e rpv non possono essere suddivise per dispositivo; il loro rollup è negozio × superficie × giorno, senza colonna del dispositivo. Usa revenue (o un’altra metrica basata sulle conversioni) per i confronti tra dispositivi.

Fusi orari

Per impostazione predefinita, le query vengono eseguite in UTC. Puoi sostituire il fuso orario in modo che i risultati raggruppati per data riflettano l’ora locale (vedi Impostare un fuso orario per i passaggi nella barra degli strumenti).
Le query che includono Impressions, Accept Rate o Revenue Per Visit raggruppano sempre le date in UTC, indipendentemente dal fuso orario selezionato, perché provengono da un rollup giornaliero riportato in giorni UTC. Se una query combina una di queste con altre metriche, l’intero set di risultati torna a UTC in modo che gli intervalli di date restino allineati.

La clausola TIMEZONE

Specifica un fuso orario direttamente in AQL con la clausola TIMEZONE, che compare tra CHART e ORDER BY:
Quando è presente, la clausola sostituisce la selezione della barra degli strumenti per quella query e viene conservata quando salvi e ricarichi.

Fusi orari disponibili

Il selettore (e la clausola TIMEZONE) accetta un insieme chiuso di dieci fusi. Qualsiasi altro fuso orario IANA viene rifiutato come non supportato.

Account default e come il fuso orario influisce sui risultati

Se Lock reporting timezone è abilitato nelle impostazioni delle analitiche, selezionando Account default viene usato quel fuso orario bloccato (la barra degli strumenti mostra il fuso risolto, ad esempio Timezone: Account default (Paris (CET))). La pagina delle impostazioni delle analitiche accetta l’elenco IANA completo, ma Reports rispetta solo i dieci fusi indicati sopra; se il tuo fuso bloccato non è tra questi, Account default si risolve silenziosamente in UTC. Se Lock reporting timezone non è abilitato, Account default torna a UTC. Quando è impostato un fuso orario, il raggruppamento per data usa l’ora locale invece di UTC. Ad esempio, un evento alle 2026-03-29T01:30:00Z cade il 28 marzo a New York (ET) ma il 29 marzo a Parigi (CET). Le query senza fuso orario, incluse quelle salvate in precedenza, continuano a essere eseguite in UTC.