-- cap the number of rows
```
Een minimaal voorbeeld — dagelijkse upsell-omzet en acceptatiepercentage voor de afgelopen 30 dagen:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
```
Trefwoorden zijn niet hoofdlettergevoelig (`SELECT` en `select` werken allebei) en statements eindigen niet met een puntkomma. Tekstwaarden worden tussen dubbele aanhalingstekens gezet; getallen en lijsten niet.
### Kiezen wat je meet en hoe je het uitsplitst
* **`SELECT`** somt de te meten statistieken op, gescheiden door komma's — bijvoorbeeld `SELECT revenue, impressions, accept_rate`.
* **`GROUP BY`** splitst die statistieken uit op een of meer dimensies, zoals `date`, `device`, `surface` of `funnel`. Zonder `GROUP BY` krijg je één totaal voor de hele periode.
Zie [Beschikbare statistieken](#available-metrics) en [Beschikbare dimensies](#available-dimensions) hierboven voor de volledige lijst van beschikbare statistieken en dimensies — en welke combinaties zijn toegestaan. De Explorer voorkomt incompatibele combinaties van statistieken en dimensies automatisch.
#### Filteren met `WHERE`
`WHERE` beperkt de data voordat die wordt gemeten. Combineer voorwaarden met `AND`.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
WHERE device = "mobile"
GROUP BY date
SINCE last_month
GRAIN day
```
`impressions`, `accept_rate` en `rpv` kunnen **niet** worden gefilterd of gegroepeerd op apparaat, funnel, plaatsing of product — hun bron-rollup heeft zo'n kolom niet. Als je `WHERE device = "mobile"` toevoegt aan een query die een van deze selecteert, wordt die afgewezen met `metric "impressions" cannot be filtered by "device"`.
Ondersteunde vergelijkingen zijn `=`, `!=`, `IN`, `NOT IN`, `>`, `<`, `>=` en `<=`. Gebruik een lijst met `IN` om meerdere waarden te matchen:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
WHERE surface IN ["PPU", "Checkout"]
```
`experiment` is **geen** filterbaar veld — het heeft geen rollup-bron, dus `WHERE experiment IN [...]` wordt afgewezen met `filters on "experiment" are not supported.` (Het staat om dezelfde reden hieronder vermeld onder **Niet-beschikbare dimensies**.)
#### Filteren op meerdere funnels
Het **funnel**-filter ondersteunt operatoren voor meervoudige selectie, zodat je een query kunt beperken tot een deelverzameling van je funnels:
* **is one of** — neemt alleen de geselecteerde funnels op (`IN`).
* **is not one of** — sluit de geselecteerde funnels uit (`NOT IN`).
Wanneer je **is one of** of **is not one of** kiest, verandert de waarde-invoer in een scrollbare checkboxlijst met al je funnelnamen. Selecteer zoveel funnels als je nodig hebt.
Wanneer je resultaten groepeert op **Funnel** en een **is one of**-filter toepast, toont de lijngrafiek één lijn per geselecteerde funnel — zelfs als je er meer selecteert dan het standaardaantal reeksen. Geen enkele geselecteerde funnel wordt samengevoegd tot een categorie "Other".
### Tijdsbereiken en vergelijkingen
Elke query heeft een tijdsbereik nodig, ingesteld met `SINCE`. Gebruik een preset of een aangepast venster.
| Vorm | Voorbeeld | Betekenis |
| ----------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Preset | `SINCE last_30d` | Een voortschrijdend venster dat eindigt op **gisteren** (UTC). De lopende huidige dag wordt bewust uitgesloten, dus `last_1d` betekent alleen gisteren, en `this_month` loopt van de 1e tot gisteren. |
| Aangepast venster | `SINCE 2026-07-02 UNTIL 2026-07-05` | Een vast bereik, met ISO-datums (`YYYY-MM-DD`). |
Beschikbare presets: `last_1d`, `last_7d`, `last_30d`, `last_90d`, `this_month`, `last_month` en `this_year`.
* **`GRAIN`** stelt de intervalgrootte voor tijdreeksen in — `day`, `week` of `month`. (`hour` wordt geparseerd, maar geen enkele rollup levert uurdata, dus zo'n query wordt afgewezen met `group_by / time_grain combination is not supported.`)
* **`COMPARE`** legt een tweede periode over de eerste, zodat je verandering in één oogopslag ziet. Gebruik `previous_period` — het venster van gelijke lengte direct ervoor. `previous_year` is bewust verborgen in de Compare-kiezer omdat het warehouse geen data bevat van vóór februari 2026; het blijft alleen typbaar in AQL zodat eerder opgeslagen query's blijven parsen.
```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
```
Rapportagedata begint in **februari 2026**, dus een venster van eerder dan dat geeft voor beide perioden een leeg resultaat. Daarom worden jaar-op-jaarvergelijkingen ook nog niet aangeboden.
### Een grafiek en tijdzone kiezen
Deze optionele clausules worden meestal voor je ingesteld door de visuele besturing van de Explorer, maar je kunt ze ook rechtstreeks schrijven:
* **`CHART`** bepaalt hoe het resultaat wordt weergegeven: `scorecard`, `line_chart`, `bar_chart`, `area_chart`, `funnel_chart` of `table`.
* **`TIMEZONE`** stelt de tijdzone in die wordt gebruikt om datums in intervallen te verdelen, als een IANA-naam tussen aanhalingstekens — bijvoorbeeld `TIMEZONE "America/New_York"`. Standaard 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"
```
Het type `funnel_chart` heeft specifieke vereisten:
* **Plaatsingsmodus** — Groepeer op `placement` en selecteer één statistiek. De fasen worden geordend volgens de canonieke plaatsingsvolgorde (upsell default → downsell → aanvullende upsells). Alleen de eerste statistiek wordt getekend; extra geselecteerde statistieken worden in een voetnoot vermeld.
* **Statistiekmodus** — Selecteer twee of meer statistieken zonder `GROUP BY`. Elke statistiek wordt een funnelfase in queryvolgorde (bijvoorbeeld, `SELECT impressions, conversions` toont een uitval van impressions → conversions). Alle statistieken moeten dezelfde eenheid delen (je kunt bijvoorbeeld geen valuta- en percentagestatistieken mengen).
```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
```
De plaatsingsmodus heeft een statistiek nodig die daadwerkelijk kan worden uitgesplitst naar plaatsing. `impressions`, `accept_rate` en `rpv` kunnen dat niet — de trechtergrafiek toont daarvoor "These metrics can't be grouped by placement".
```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
```
### Sorteren en beperken
* **`ORDER BY`** sorteert resultaten op een statistiek of dimensie, met `ASC` of `DESC`.
* **`LIMIT`** beperkt het aantal geretourneerde rijen — handig voor vragen in de trant van "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
```
### Meer voorbeelden
```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
```
`impressions`, `accept_rate` en `rpv` kunnen niet worden uitgesplitst naar apparaat — hun rollup is shop × surface × dag, zonder apparaatkolom. Gebruik `revenue` (of een andere op conversies gebaseerde statistiek) voor apparaatvergelijkingen.
```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
```
Heb je eenmaal een query die je bevalt, sla die dan op en voeg hem als widget toe aan een rapport zodat hij bijgewerkt blijft — zie [Widgets beheren](/nl/aftersell/reports_widgets). Om een widget te verwijderen die je niet meer nodig hebt, laad je hem in de Explorer en klik je op **Delete** in de titelbalk. Als je een widget verwijdert, wordt hij verwijderd uit elk rapport waarop hij voorkomt. De knop **Delete** wordt alleen getoond bij widgets die van jou zijn; globale sjabloonwidgets zijn alleen-lezen.
***
## Resultaten exporteren
De Explorer toont je queryresultaten op het scherm als scorecard, grafiek of tabel — er wordt niet rechtstreeks een bestand gedownload vanuit de queryweergave.
Om de resultaten als bestand te krijgen, sla je de query op en voeg je hem als [widget](/nl/aftersell/reports_widgets) toe aan een rapport. Elke widget heeft een eigen knop **Export to CSV** waarmee de data van de widget als `.csv`-bestand wordt gedownload. Zie [Je data exporteren](/nl/aftersell/analytics_in_aftersell#exporting-your-data) voor de standaardexports van de Analytics-pagina (Excel en CSV).
***
## Tijdzone-ondersteuning
Standaard draaien query's in UTC. Je kunt de tijdzone voor elke query rechtstreeks in de werkbalk van de Explorer overschrijven, zodat resultaten die op datum zijn ingedeeld (dagelijkse, wekelijkse, maandelijkse uitsplitsingen) je lokale tijd weerspiegelen in plaats van UTC.
Query's die **Impressions**, **Accept Rate** of **Revenue Per Visit** bevatten, delen datums altijd in op basis van UTC, ongeacht de tijdzone die je selecteert. Deze statistieken komen uit een dagelijkse rollup die alleen in UTC-dagen wordt gerapporteerd. Als een query een van deze statistieken met andere mengt, valt de hele resultatenset terug op UTC zodat de datumintervallen uitgelijnd blijven.
### Een tijdzone instellen voor een query
1. Open de Explorer in je Aftersell-beheer.
2. Klik in de werkbalk op de **Timezone**-selector (naast **Compare**).
3. Kies een van de beschikbare tijdzones uit de lijst, of selecteer **Account default** om de tijdzone te gebruiken die in je analytics-instellingen is geconfigureerd.
4. Voer je query uit. De resultaten worden ingedeeld op basis van de geselecteerde tijdzone.
De geselecteerde tijdzone wordt samen met de query opgeslagen. Wanneer je een query opslaat en opnieuw laadt, wordt de tijdzone automatisch hersteld.
### Standaardtijdzone van het account
Als je **Lock reporting timezone** hebt ingeschakeld in je analytics-instellingen, gebruikt de selectie **Account default** in de werkbalk die vergrendelde tijdzone voor je query. Het werkbalklabel toont de bepaalde zone, bijvoorbeeld **Timezone: Account default (Paris (CET))**.
De pagina met analytics-instellingen accepteert de volledige IANA-tijdzonelijst, maar Reports respecteert alleen de tien bovenstaande zones. Als je vergrendelde zone daar niet bij zit, lost **Account default** stilzwijgend op naar UTC — kies dus een vergrendelde zone uit deze lijst als je wilt dat Reports die volgt.
Als **Lock reporting timezone** niet is ingeschakeld, valt **Account default** terug op UTC.
### Een tijdzone opgeven in AQL
Je kunt ook rechtstreeks in je AQL-query een tijdzone opgeven met de `TIMEZONE`-clausule, die tussen `CHART` en `ORDER BY` staat:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT ...
CHART ...
TIMEZONE "Asia/Tokyo"
ORDER BY ...
```
Als de clausule aanwezig is, overschrijft die de werkbalkselectie voor die query. De tijdzone blijft behouden wanneer je de query opslaat en opnieuw laadt.
### Beschikbare tijdzones
De tijdzonekiezer bevat de volgende opties:
| Tijdzone | Voorbeeldlocatie |
| -------------------- | -------------------------- |
| UTC | Universal Coordinated Time |
| America/New\_York | New York (ET) |
| America/Chicago | Chicago (CT) |
| America/Denver | Denver (MT) |
| America/Los\_Angeles | Los Angeles (PT) |
| Europe/London | Londen (GMT/BST) |
| Europe/Paris | Parijs (CET/CEST) |
| Asia/Tokyo | Tokio (JST) |
| Asia/Singapore | Singapore (SGT) |
| Australia/Sydney | Sydney (AEST/AEDT) |
Dit is een gesloten set van tien zones. Elke andere IANA-tijdzone in een `TIMEZONE`-clausule wordt afgewezen als niet ondersteund.
### Hoe de tijdzone queryresultaten beïnvloedt
Wanneer een tijdzone is ingesteld, gebruikt de datumindeling in je query lokale tijd in plaats van UTC. Een gebeurtenis die plaatsvond op `2026-03-29T01:30:00Z` (UTC) valt bijvoorbeeld op 28 maart in de tijd van New York (ET), maar op 29 maart in de tijd van Parijs (CET). Door de juiste tijdzone in te stellen, zorg je ervoor dat je dagelijkse, wekelijkse en maandelijkse uitsplitsingen overeenkomen met je zakelijke rapportageverwachtingen.
Query's zonder tijdzone — inclusief eerder opgeslagen query's — blijven in UTC draaien, dus bestaande resultaten worden niet beïnvloed.
***
## Hulp nodig?
Heb je vragen over de Explorer of wil je toegang laten inschakelen, neem dan via de in-app chat contact op met het supportteam van Aftersell.