> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Explorer

> Costruisci query di analytics e report personalizzati usando l'Explorer in Aftersell.

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.

<Tip>
  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](#writing-aql-queries) più avanti per il riferimento alla sintassi.
</Tip>

***

<div id="available-metrics">
  ## Metriche disponibili
</div>

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

<div id="revenue-profit">
  ### Ricavi e profitto
</div>

| Metrica                      | Descrizione                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Revenue**                  | Ricavi da upsell nella valuta nativa del tuo negozio.                                                                                                                                                                                                                                                                                                                 |
| **Revenue (USD)**            | Ricavi da upsell normalizzati in USD per confronti tra valute.                                                                                                                                                                                                                                                                                                        |
| **Revenue Per Visit**        | Ricavi da upsell per sessione di impression. Non può essere suddivisa per prodotto, placement, funnel o dispositivo.                                                                                                                                                                                                                                                  |
| **Avg. Conversion Value**    | Ricavi per offerta accettata. Detto anche Average Upsell Value.                                                                                                                                                                                                                                                                                                       |
| **Upsell Revenue Per Order** | Ricavi da upsell (USD) divisi per il totale degli ordini. Solo a livello di negozio.                                                                                                                                                                                                                                                                                  |
| **Product Profit**           | Ricavi meno il costo del venduto (COGS) per i prodotti in upsell. Si basa sui COGS configurati dal merchant, quindi trattala come una stima: i prodotti senza un costo tracciato riportano i ricavi come profitto, e la copertura dei costi varia da negozio a negozio. Solo a granularità di prodotto; non può essere suddivisa per funnel, placement o dispositivo. |

<div id="conversions">
  ### Conversioni
</div>

| Metrica          | Descrizione                                                                                                                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Conversions**  | Il numero di eventi di offerta accettata. Un'offerta accettata è una conversione, quindi una sessione che accetta due offerte conta due volte.                                                                      |
| **Accept Rate**  | Basato sulle sessioni: la quota di sessioni che hanno visto un'offerta e ne hanno accettata almeno una. È calcolato indipendentemente da Conversions, da un rollup diverso, quindi non è Conversions ÷ Impressions. |
| **Units Sold**   | Unità totali vendute tramite offerte di upsell.                                                                                                                                                                     |
| **Decline Rate** | Percentuale di offerte post-acquisto rifiutate esplicitamente. Solo post-acquisto.                                                                                                                                  |

<div id="engagement">
  ### Interazione
</div>

| Metrica         | Descrizione                                                |
| --------------- | ---------------------------------------------------------- |
| **Impressions** | Sessioni uniche che hanno visto un'offerta.                |
| **Show Rate**   | Percentuale di decisioni che hanno prodotto un'impression. |

<div id="store-performance">
  ### Prestazioni del negozio
</div>

| Metrica                       | Descrizione                                                                                                                                         |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Total Store Revenue**       | Ricavi totali degli ordini pagati su Shopify. Solo a livello di negozio — non può essere suddivisa per superficie, funnel, placement o dispositivo. |
| **Orders**                    | Totale degli ordini pagati su Shopify. Solo a livello di negozio.                                                                                   |
| **Average Total Order Value** | Ricavi del negozio divisi per gli ordini. Valore medio dell'ordine a livello di negozio.                                                            |

<div id="rokt-network">
  ### Rete Rokt
</div>

| Metrica                        | Descrizione                                                                                                       |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| **Rokt Revenue**               | Ricavi della rete Rokt attribuiti al tuo negozio.                                                                 |
| **Rokt Transactions**          | Numero di transazioni della rete Rokt per il tuo negozio.                                                         |
| **Rokt Revenue / Transaction** | Ricavi Rokt divisi per le transazioni per intervallo temporale.                                                   |
| **Rokt Impressions**           | Impression totali della rete Rokt su tutti i placement del tuo negozio. Distinta dalle **Impressions** di upsell. |
| **Rokt Referrals**             | Referral della rete Rokt — interazioni positive che hanno indirizzato l'acquirente a un partner Rokt.             |

***

<div id="dimensions">
  ## Dimensioni
</div>

Le dimensioni ti permettono di suddividere le metriche per un attributo specifico. Non tutte le dimensioni sono compatibili con ogni metrica.

<Note>
  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.
</Note>

<div id="available-dimensions">
  ### Dimensioni disponibili
</div>

| Dimensione    | Descrizione                                                                                                                                                                       |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Date**      | Raggruppa i risultati per giorno, settimana o mese.                                                                                                                               |
| **Surface**   | La superficie di upsell. Una tra PPU (post-acquisto), Checkout, Thank You Page o Cart.                                                                                            |
| **Funnel**    | Il funnel specifico a cui appartiene l'offerta.                                                                                                                                   |
| **Product**   | Il prodotto proposto in upsell.                                                                                                                                                   |
| **Placement** | Il placement all'interno di un funnel.                                                                                                                                            |
| **Device**    | Il tipo di dispositivo: Mobile, Desktop o Unknown. Non esiste un valore separato per tablet.                                                                                      |
| **Currency**  | Il codice valuta ISO (ad esempio USD, EUR, GBP). Utile per negozi multi-valuta. Compatibile con le metriche a livello di negozio e con la maggior parte delle metriche di upsell. |

<div id="unavailable-dimensions">
  ### Dimensioni non disponibili
</div>

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.**

| Dimensione        | Descrizione                                                        |
| ----------------- | ------------------------------------------------------------------ |
| **Flow type**     | Il tipo di flusso di upsell.                                       |
| **Experiment**    | La variante del test A/B o dell'esperimento.                       |
| **Outcome**       | L'esito della decisione (ad esempio idoneo, esaurito).             |
| **Reason code**   | Il motivo dell'esito di una decisione.                             |
| **Scope**         | L'ambito della decisione (Flow, Experience, Placement o ItemSlot). |
| **Response type** | La risposta all'offerta (Accepted, Declined o Timeout).            |

***

<div id="writing-aql-queries">
  ## Scrivere query AQL
</div>

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.

<div id="how-an-aql-statement-reads">
  ### Come si legge un'istruzione AQL
</div>

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.

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT    <metrics>                    -- what to measure (required)
WHERE     <filters>                    -- narrow the data
GROUP BY  <dimensions>                 -- break the numbers down
SINCE     <time range>                 -- the period to cover (required)
GRAIN     <time grain>                 -- bucket size for time series
COMPARE   <comparison>                 -- compare against another period
CHART     <visualization>              -- how to display the result
TIMEZONE  "<timezone>"                 -- timezone for date buckets
ORDER BY  <field> <direction>          -- sort the results
LIMIT     <number>                     -- cap the number of rows
```

Un esempio minimale — ricavi da upsell e tasso di accettazione giornalieri degli ultimi 30 giorni:

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
```

<Note>
  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.
</Note>

<div id="picking-what-to-measure-and-how-to-slice-it">
  ### Scegliere cosa misurare e come segmentarlo
</div>

* **`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](#available-metrics) e [Dimensioni disponibili](#available-dimensions) sopra. L'Explorer previene automaticamente le combinazioni incompatibili di metriche e dimensioni.

<div id="filtering-with-where">
  #### Filtrare con `WHERE`
</div>

`WHERE` restringe i dati prima che vengano misurati. Combina le condizioni con `AND`.

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
WHERE device = "mobile"
GROUP BY date
SINCE last_month
GRAIN day
```

<Warning>
  `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"`.
</Warning>

I confronti supportati sono `=`, `!=`, `IN`, `NOT IN`, `>`, `<`, `>=` e `<=`. Usa un elenco con `IN` per far corrispondere più valori:

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
WHERE surface IN ["PPU", "Checkout"]
```

`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.)

<div id="filtering-by-multiple-funnels">
  #### Filtrare per più funnel
</div>

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".

<div id="time-ranges-and-comparisons">
  ### Intervalli di tempo e confronti
</div>

Ogni query necessita di un intervallo di tempo, impostato con `SINCE`. Usa un preset o una finestra personalizzata.

| Forma                   | Esempio                             | Significato                                                                                                                                                                         |
| ----------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Preset                  | `SINCE last_30d`                    | Una finestra mobile che termina **ieri** (UTC). Il giorno corrente in corso è deliberatamente escluso, quindi `last_1d` significa solo ieri, e `this_month` va dal giorno 1 a ieri. |
| Finestra personalizzata | `SINCE 2026-07-02 UNTIL 2026-07-05` | Un intervallo fisso, usando date ISO (`YYYY-MM-DD`).                                                                                                                                |

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.

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- A four-day sale vs the four days immediately before it
SELECT revenue, impressions, accept_rate
GROUP BY date
SINCE 2026-07-02 UNTIL 2026-07-05
GRAIN day
COMPARE previous_period
```

<Note>
  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.
</Note>

<div id="choosing-a-chart-and-timezone">
  ### Scegliere un grafico e un fuso orario
</div>

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.

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
GROUP BY date
SINCE last_30d
GRAIN day
CHART line_chart
TIMEZONE "America/New_York"
```

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).

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Placement funnel: conversion drop-off across placements
SELECT conversions
GROUP BY placement
SINCE last_30d
CHART funnel_chart
```

<Warning>
  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.
</Warning>

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Metric funnel: impressions to conversions drop-off
SELECT impressions, conversions
SINCE last_30d
CHART funnel_chart
```

<div id="sorting-and-limiting">
  ### Ordinare e limitare
</div>

* **`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".

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Top 20 products by upsell revenue this month
SELECT revenue, conversions, avg_conversion_value
GROUP BY product
SINCE this_month
ORDER BY revenue DESC
LIMIT 20
```

<div id="more-examples">
  ### Altri esempi
</div>

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Daily performance vs the previous period
SELECT revenue, impressions, conversions, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
COMPARE previous_period
```

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Mobile vs desktop revenue over the last 90 days
SELECT revenue
GROUP BY device
SINCE last_90d
ORDER BY revenue DESC
```

<Note>
  `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.
</Note>

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Which surface is driving the most revenue?
SELECT revenue, impressions, accept_rate
GROUP BY surface
SINCE last_30d
ORDER BY revenue DESC
```

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](/it/aftersell/reports_widgets). 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.

***

<div id="exporting-results">
  ## Esportare i risultati
</div>

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](/it/aftersell/reports_widgets). 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](/it/aftersell/analytics_in_aftersell#exporting-your-data).

***

<div id="timezone-support">
  ## Supporto ai fusi orari
</div>

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.

<Note>
  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.
</Note>

<div id="setting-a-timezone-for-a-query">
  ### Impostare un fuso orario per una query
</div>

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.

<div id="account-default-timezone">
  ### Fuso orario predefinito dell'account
</div>

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.

<div id="specifying-a-timezone-in-aql">
  ### Specificare un fuso orario in AQL
</div>

Puoi anche specificare un fuso orario direttamente nella tua query AQL usando la clausola `TIMEZONE`, che appare tra `CHART` e `ORDER BY`:

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT ...
CHART ...
TIMEZONE "Asia/Tokyo"
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.

<div id="available-timezones">
  ### Fusi orari disponibili
</div>

Il selettore di fusi orari include le seguenti opzioni:

| Fuso orario          | Località di esempio         |
| -------------------- | --------------------------- |
| UTC                  | Tempo coordinato universale |
| America/New\_York    | New York (ET)               |
| America/Chicago      | Chicago (CT)                |
| America/Denver       | Denver (MT)                 |
| America/Los\_Angeles | Los Angeles (PT)            |
| Europe/London        | Londra (GMT/BST)            |
| Europe/Paris         | Parigi (CET/CEST)           |
| Asia/Tokyo           | Tokyo (JST)                 |
| Asia/Singapore       | Singapore (SGT)             |
| Australia/Sydney     | Sydney (AEST/AEDT)          |

Si tratta di un insieme chiuso di dieci fusi. Qualsiasi altro fuso orario IANA in una clausola `TIMEZONE` viene rifiutato come non supportato.

<div id="how-timezone-affects-query-results">
  ### Come il fuso orario influisce sui risultati delle query
</div>

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.

***

<div id="need-help">
  ## Hai bisogno di aiuto?
</div>

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