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).
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.
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:
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.SELECTsomt de te meten statistieken op, gescheiden door komma’s, bijvoorbeeldSELECT revenue, impressions, accept_rate.GROUP BYsplitst die statistieken uit naar een of meer dimensies, zoalsdate,device,surfaceoffunnel. ZonderGROUP BYkrijg je één totaal voor de hele periode.
WHERE beperkt de gegevens voordat ze worden gemeten. Combineer voorwaarden met AND.
=, !=, 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”.
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.
GRAINstelt de intervalgrootte voor tijdreeksen in:day,weekofmonth. (hourwordt wel geparsed, maar geen enkele rollup levert gegevens per uur, dus zo’n query wordt geweigerd metgroup_by / time_grain combination is not supported.)COMPARElegt een tweede periode eroverheen. Gebruikprevious_period, het even lange venster direct ervoor.previous_yearis 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.
CHARTbepaalt hoe het resultaat wordt weergegeven:scorecard,line_chart,bar_chart,area_chart,funnel_chartoftable.TIMEZONEstelt de tijdzone in die wordt gebruikt om datums te groeperen, als IANA-naam tussen aanhalingstekens, bijvoorbeeldTIMEZONE "America/New_York". Standaard UTC (zie Tijdzones).
funnel_chart heeft specifieke vereisten:
- Plaatsingsmodus. Groepeer op
placementen 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 (bijvoorbeeldSELECT impressions, conversionstoont de uitval van impressies naar conversies). Alle statistieken moeten dezelfde eenheid hebben.
ORDER BYsorteert resultaten op een statistiek of dimensie, metASCofDESC.LIMITbeperkt het aantal geretourneerde rijen, handig voor “top N”-vragen.
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.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.
TIMEZONE-clausule, die tussen CHART en ORDER BY staat:
TIMEZONE-clausule) accepteert een vaste set van tien zones. Elke andere IANA-tijdzone wordt als niet-ondersteund geweigerd.
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.