Skip to main content
L’Explorer ti consente di costruire query di analytics personalizzate usando un builder di query flessibile (AftersellQL). Puoi selezionare metriche, raggruppare i risultati per dimensioni, applicare filtri e visualizzare i dati in grafici o tabelle. Le query salvate possono essere aggiunte ai report come widget per un monitoraggio continuo.
Costruisci le query visivamente con i menu — senza bisogno di sintassi. Se preferisci digitare le query direttamente, l’Explorer espone anche il testo AftersellQL sottostante. Consulta Scrivere query AQL più avanti per il riferimento alla sintassi.

Metriche disponibili

Queste sono le metriche che puoi scegliere nell’Explorer, raggruppate allo stesso modo in cui le raggruppa il selettore delle metriche.

Ricavi e profitto

Conversioni

Interazione

Prestazioni del negozio

Rete Rokt


Dimensioni

Le dimensioni ti permettono di suddividere le metriche per un attributo specifico. Non tutte le dimensioni sono compatibili con ogni metrica.
Alcune combinazioni di dimensioni e metriche sono incompatibili. Ad esempio, Decline rate e Show rate non possono essere suddivise per Currency. L’Explorer previene automaticamente le combinazioni incompatibili.

Dimensioni disponibili

Dimensioni non disponibili

Le seguenti dimensioni sono in fase di sviluppo. Appaiono nel selettore ma non sono ancora disponibili come suddivisione. Vengono invece mostrate come ‘Not compatible’ per ogni metrica. Questo documento verrà aggiornato quando queste dimensioni saranno pienamente implementate.

Scrivere query AQL

Ogni query che costruisci nell’Explorer è un’istruzione AftersellQL (AQL). La maggior parte delle volte costruisci le query visivamente — scegliendo metriche, dimensioni, filtri e un intervallo di date dai menu — e non hai mai bisogno di scrivere AQL a mano. Per gli utenti avanzati, l’Explorer espone anche la query sottostante come testo modificabile. Questa sezione è il riferimento per quella forma testuale: cosa significano le clausole, quali valori accettano e alcuni esempi pronti all’uso.

Come si legge un’istruzione 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 apparire nell’ordine mostrato di seguito.
Un esempio minimale — ricavi da upsell e tasso di accettazione giornalieri degli ultimi 30 giorni:
Le parole chiave non distinguono 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 doppi apici; numeri ed elenchi no.

Scegliere cosa misurare e come segmentarlo

  • SELECT elenca le metriche da misurare, separate da virgole — ad esempio SELECT revenue, impressions, accept_rate.
  • GROUP BY suddivide quelle metriche per una o più dimensioni, come date, device, surface o funnel. Senza GROUP BY, ottieni un unico totale per l’intero periodo.
Per l’elenco completo di metriche e dimensioni disponibili — e delle combinazioni consentite — consulta Metriche disponibili e Dimensioni disponibili sopra. L’Explorer previene automaticamente le combinazioni incompatibili di metriche e dimensioni.

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 tale colonna. Aggiungere WHERE device = "mobile" a una query che le seleziona viene rifiutato con metric "impressions" cannot be filtered by "device".
I confronti supportati sono =, !=, IN, NOT IN, >, <, >= e <=. Usa un elenco con IN per far corrispondere 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. (È elencato tra le Dimensioni non disponibili più sopra per lo stesso motivo.)

Filtrare per più funnel

Il filtro funnel supporta operatori multi-selezione così puoi limitare una query a un sottoinsieme dei tuoi funnel:
  • is one of — include solo i funnel selezionati (IN).
  • is not one of — esclude i funnel selezionati (NOT IN).
Quando scegli is one of o is not one of, il campo del valore diventa un elenco di caselle di controllo scorrevole che mostra tutti i nomi dei tuoi funnel. Seleziona tutti i funnel di cui hai bisogno. Quando raggruppi i risultati per Funnel e applichi un filtro is one of, il grafico a linee mostra una linea per ogni funnel selezionato — anche se selezioni più del numero predefinito di serie. Nessun funnel selezionato viene compresso in una categoria “Other”.

Intervalli di tempo e confronti

Ogni query necessita di un intervallo di tempo, impostato con SINCE. Usa un preset o una finestra personalizzata. Preset disponibili: last_1d, last_7d, last_30d, last_90d, this_month, last_month e this_year.
  • GRAIN imposta la dimensione dell’intervallo per le serie temporali — day, week o month. (hour viene analizzato ma nessun rollup fornisce dati orari, quindi una query del genere viene rifiutata con group_by / time_grain combination is not supported.)
  • COMPARE sovrappone un secondo periodo così puoi vedere i cambiamenti a colpo d’occhio. Usa previous_period — la finestra di uguale durata immediatamente precedente. previous_year è deliberatamente nascosto dal selettore Compare perché il warehouse non contiene dati precedenti a febbraio 2026; rimane digitabile solo in AQL così le query salvate in precedenza continuano a essere analizzate.
I dati di reporting iniziano a febbraio 2026, quindi una finestra precedente a quella data restituisce risultati vuoti per entrambi i periodi. È anche per questo che i confronti anno su anno non sono ancora disponibili.

Scegliere un grafico e un fuso orario

Queste clausole facoltative vengono solitamente impostate per te dai controlli visuali dell’Explorer, ma puoi anche scriverle direttamente:
  • 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.
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 → downsell → upsell aggiuntivi). Viene tracciata solo la prima metrica; le metriche aggiuntive selezionate sono riportate in una nota a piè di pagina.
  • Modalità metrica — Seleziona due o più metriche senza GROUP BY. Ogni metrica diventa una fase dell’imbuto nell’ordine della query (ad esempio, SELECT impressions, conversions mostra il calo da impressions a conversions). Tutte le metriche devono condividere la stessa unità (ad esempio, non puoi mescolare metriche in valuta e in percentuale).
La modalità placement necessita di una metrica che possa effettivamente essere suddivisa per placement. impressions, accept_rate e rpv non possono — il grafico a imbuto mostra “These metrics can’t be grouped by placement” per quelle.

Ordinare e limitare

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

Altri esempi

impressions, accept_rate e rpv non possono essere suddivise per dispositivo — il loro rollup è shop × superficie × giorno, senza colonna dispositivo. Usa revenue (o un’altra metrica derivata dalle conversioni) per i confronti tra dispositivi.
Una volta ottenuta una query che ti piace, salvala e aggiungila a un report come widget in modo che continui ad aggiornarsi — consulta Gestire i widget. Per rimuovere un widget di cui non hai più bisogno, caricalo nell’Explorer e clicca su Delete nella barra del titolo. Eliminare un widget lo rimuove da tutti i report in cui appare. Il pulsante Delete viene mostrato solo per i widget di tua proprietà; i widget template globali sono di sola lettura.

Esportare i risultati

L’Explorer mostra i risultati della tua query sullo schermo come scorecard, grafico o tabella — non scarica un file direttamente dalla vista della query. Per ottenere i risultati come file, salva la query e aggiungila a un report come widget. Ogni widget ha il proprio pulsante Export to CSV che scarica i dati del widget come file .csv. Per le esportazioni standard della pagina Analytics (Excel e CSV), consulta Esportare i tuoi dati.

Supporto ai fusi orari

Per impostazione predefinita, le query vengono eseguite in UTC. Puoi sovrascrivere il fuso orario per qualsiasi query direttamente nella barra degli strumenti dell’Explorer, così i risultati raggruppati per data (suddivisioni giornaliere, settimanali, mensili) riflettono la tua ora locale anziché l’UTC.
Le query che includono Impressions, Accept Rate o Revenue Per Visit raggruppano sempre le date in UTC, indipendentemente dal fuso orario selezionato. Queste metriche provengono da un rollup giornaliero riportato solo in giorni UTC. Se una query combina una di queste metriche con altre, l’intero set di risultati ricade su UTC così gli intervalli di date restano allineati.

Impostare un fuso orario per una query

  1. Apri l’Explorer nel tuo admin di Aftersell.
  2. Nella barra degli strumenti, clicca sul selettore Timezone (accanto a Compare).
  3. Scegli uno dei fusi orari disponibili dall’elenco, oppure seleziona Account default per usare il fuso orario configurato nelle tue impostazioni di analytics.
  4. Esegui la query. I risultati vengono raggruppati usando il fuso orario selezionato.
Il fuso orario selezionato viene salvato con la query. Quando salvi e ricarichi una query, il fuso orario viene ripristinato automaticamente.

Fuso orario predefinito dell’account

Se hai Lock reporting timezone abilitato nelle tue impostazioni di analytics, selezionando Account default nella barra degli strumenti viene usato quel fuso orario bloccato per la tua query. L’etichetta della barra degli strumenti mostra il fuso risolto, ad esempio Timezone: Account default (Paris (CET)). La pagina delle impostazioni di analytics accetta l’elenco completo dei fusi orari IANA, ma Reports rispetta solo i dieci fusi elencati sopra. Se il tuo fuso bloccato non è tra questi, Account default si risolve silenziosamente in UTC — quindi scegli un fuso bloccato da questo elenco se vuoi che Reports lo segua. Se Lock reporting timezone non è abilitato, Account default ricade su UTC.

Specificare un fuso orario in AQL

Puoi anche specificare un fuso orario direttamente nella tua query AQL usando la clausola TIMEZONE, che appare tra CHART e ORDER BY:
Quando presente, la clausola sovrascrive la selezione della barra degli strumenti per quella query. Il fuso orario viene preservato quando salvi e ricarichi la query.

Fusi orari disponibili

Il selettore di fusi orari include le seguenti opzioni: Si tratta di un insieme chiuso di dieci fusi. Qualsiasi altro fuso orario IANA in una clausola TIMEZONE viene rifiutato come non supportato.

Come il fuso orario influisce sui risultati delle query

Quando un fuso orario è impostato, il raggruppamento per data nella tua query usa l’ora locale invece dell’UTC. Ad esempio, un evento avvenuto alle 2026-03-29T01:30:00Z (UTC) cade il 28 marzo nell’ora di New York (ET) ma il 29 marzo nell’ora di Parigi (CET). Impostare il fuso orario corretto garantisce che le tue suddivisioni giornaliere, settimanali e mensili corrispondano alle aspettative di reporting della tua attività. Le query che non includono un fuso orario — incluse le query salvate in precedenza — continuano a essere eseguite in UTC, quindi i risultati esistenti non ne sono influenzati.

Hai bisogno di aiuto?

Se hai domande sull’Explorer o vuoi abilitare l’accesso, contatta il team di supporto di Aftersell tramite la chat in-app.