Skip to main content
Elke query die je in de Explorer bouwt, is een AftersellQL (AQL)-statement. Meestal bouw je queries visueel en schrijf je nooit handmatig AQL; deze pagina is de referentie voor de statistieken en dimensies die je kunt kiezen, de tekstvorm van AQL en de tijdzoneregels.

Beschikbare statistieken

Dit zijn de statistieken die je kunt kiezen, gegroepeerd op dezelfde manier als in de statistiekkiezer.

Omzet en winst

Conversies

Betrokkenheid

Winkelprestaties

Rokt-netwerk

Dimensies

Dimensies splitsen een statistiek uit op basis van een kenmerk. Niet alle dimensies zijn compatibel met elke statistiek; de Explorer voorkomt automatisch incompatibele combinaties (bijvoorbeeld Decline rate en Show rate kunnen niet worden uitgesplitst naar Currency).

Beschikbare dimensies

Niet-beschikbare dimensies

De volgende dimensies zijn nog in ontwikkeling. Ze verschijnen in de kiezer, maar worden voor elke statistiek als ‘Not compatible’ weergegeven totdat ze zijn geïmplementeerd.

Syntaxis van AQL-statements

Een AQL-statement is één vraag die uit clausules bestaat. Alleen SELECT en een tijdsbereik (SINCE) zijn verplicht; al het andere is optioneel. Wanneer je optionele clausules opneemt, moeten ze in deze volgorde staan:
Een minimaal voorbeeld, dagelijkse upsellomzet en accept rate voor de afgelopen 30 dagen:
Trefwoorden zijn niet hoofdlettergevoelig (SELECT en select werken allebei) en statements eindigen niet met een puntkomma. Tekstwaarden staan tussen dubbele aanhalingstekens; getallen en lijsten niet.

SELECT en GROUP BY

  • SELECT somt de te meten statistieken op, gescheiden door komma’s, bijvoorbeeld SELECT revenue, impressions, accept_rate.
  • GROUP BY splitst die statistieken uit naar een of meer dimensies, zoals date, device, surface of funnel. Zonder GROUP BY krijg je één totaal voor de hele periode.

Filteren met WHERE

WHERE beperkt de gegevens voordat ze worden gemeten. Combineer voorwaarden met AND.
impressions, accept_rate en rpv kunnen niet worden gefilterd of gegroepeerd op device, funnel, placement of product; hun bron-rollup heeft geen dergelijke kolom. Het toevoegen van WHERE device = "mobile" aan een query die een van deze selecteert, wordt geweigerd 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:
experiment is geen filterbaar veld; het heeft geen rollup-bron, dus WHERE experiment IN [...] wordt geweigerd met filters on "experiment" are not supported. Het funnel-filter ondersteunt meervoudige selectie: is one of (IN) neemt alleen de geselecteerde funnels op, is not one of (NOT IN) sluit ze uit. Wanneer je groepeert op Funnel en een is one of-filter toepast, toont de grafiek één lijn per geselecteerde funnel, zonder samenvoeging tot “Other”.

Tijdsbereiken en vergelijkingen

Elke query heeft een tijdsbereik nodig, ingesteld met SINCE: Beschikbare voorinstellingen: 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 wel geparsed, maar geen enkele rollup levert gegevens per uur, dus zo’n query wordt geweigerd met group_by / time_grain combination is not supported.)
  • COMPARE legt een tweede periode eroverheen. Gebruik previous_period, het even lange venster direct ervoor. previous_year is verborgen in de Compare-kiezer omdat het warehouse geen gegevens van vóór februari 2026 bevat; het blijft alleen in AQL te typen zodat eerder opgeslagen queries blijven werken.
Rapportagegegevens beginnen in februari 2026, dus een venster vóór die datum levert voor beide perioden een leeg resultaat op.

Een grafiek kiezen

  • 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 te groeperen, als IANA-naam tussen aanhalingstekens, bijvoorbeeld TIMEZONE "America/New_York". Standaard UTC (zie Tijdzones).
Het type funnel_chart heeft specifieke vereisten:
  • Plaatsingsmodus. Groepeer op placement en selecteer één statistiek. Fasen worden geordend volgens de canonieke plaatsingsvolgorde (standaard-upsell, dan downsell, dan aanvullende upsells). Alleen de eerste statistiek wordt weergegeven; aanvullende statistieken worden in een voetnoot vermeld.
  • Statistiekmodus. Selecteer twee of meer statistieken zonder GROUP BY. Elke statistiek wordt een funnelfase in de volgorde van de query (bijvoorbeeld SELECT impressions, conversions toont de uitval van impressies naar conversies). Alle statistieken moeten dezelfde eenheid hebben.
De plaatsingsmodus vereist een statistiek die naar plaatsing kan worden uitgesplitst. impressions, accept_rate en rpv kunnen dat niet; de funnelgrafiek toont daarvoor “These metrics can’t be grouped by placement”.

Sorteren en beperken

  • ORDER BY sorteert resultaten op een statistiek of dimensie, met ASC of DESC.
  • LIMIT beperkt het aantal geretourneerde rijen, handig voor “top N”-vragen.

Meer voorbeelden

impressions, accept_rate en rpv kunnen niet naar apparaat worden uitgesplitst; hun rollup is shop × surface × dag, zonder apparaatkolom. Gebruik revenue (of een andere op conversies gebaseerde statistiek) voor vergelijkingen tussen apparaten.

Tijdzones

Standaard worden queries in UTC uitgevoerd. Je kunt de tijdzone overschrijven zodat resultaten die per datum zijn gegroepeerd de lokale tijd weerspiegelen (zie Een tijdzone instellen voor de stappen in de werkbalk).
Queries met Impressions, Accept Rate of Revenue Per Visit groeperen datums altijd in UTC, ongeacht de tijdzone die je selecteert, omdat ze afkomstig zijn uit een dagelijkse rollup die in UTC-dagen wordt gerapporteerd. Als een query een van deze combineert met andere statistieken, valt de hele resultatenset terug op UTC zodat de datumintervallen op elkaar aansluiten.

De TIMEZONE-clausule

Geef een tijdzone direct in AQL op met de TIMEZONE-clausule, die tussen CHART en ORDER BY staat:
Als de clausule aanwezig is, overschrijft deze de selectie in de werkbalk voor die query, en blijft ze behouden wanneer je opslaat en opnieuw laadt.

Beschikbare tijdzones

De kiezer (en de TIMEZONE-clausule) accepteert een vaste set van tien zones. Elke andere IANA-tijdzone wordt als niet-ondersteund geweigerd.

Accountstandaard en hoe de tijdzone de resultaten beïnvloedt

Als Lock reporting timezone is ingeschakeld in je analytics-instellingen, gebruikt de selectie Account default die vergrendelde tijdzone (de werkbalk toont de gekozen zone, bijvoorbeeld Timezone: Account default (Paris (CET))). De pagina met analytics-instellingen accepteert de volledige IANA-lijst, maar Reports respecteert alleen de tien bovenstaande zones; als je vergrendelde zone daar niet bij hoort, wordt Account default zonder melding omgezet naar UTC. Als Lock reporting timezone niet is ingeschakeld, valt Account default terug op UTC. Wanneer een tijdzone is ingesteld, gebruikt het groeperen per datum de lokale tijd in plaats van UTC. Een gebeurtenis op 2026-03-29T01:30:00Z valt bijvoorbeeld op 28 maart in New York (ET), maar op 29 maart in Parijs (CET). Queries zonder tijdzone, inclusief eerder opgeslagen queries, blijven in UTC worden uitgevoerd.