Skip to main content
Hver forespørgsel, du bygger i Exploreren, er en AftersellQL (AQL)-sætning. Det meste af tiden bygger du forespørgsler visuelt og skriver aldrig AQL i hånden; denne side er referencen for de metrics og dimensioner, du kan vælge, AQL-tekstformen og tidszonereglerne.

Tilgængelige metrics

Dette er de metrics, du kan vælge, grupperet på samme måde som i metric-vælgeren.

Omsætning og profit

Konverteringer

Engagement

Butiksperformance

Rokt-netværk

Dimensioner

Dimensioner opdeler en metric efter en attribut. Ikke alle dimensioner er kompatible med alle metrics; Exploreren forhindrer automatisk inkompatible kombinationer (for eksempel kan Decline rate og Show rate ikke opdeles efter Currency).

Tilgængelige dimensioner

Utilgængelige dimensioner

Følgende er under udvikling. De vises i vælgeren, men vises som ‘Not compatible’ for alle metrics, indtil de er implementeret.

Syntaks for AQL-sætninger

En AQL-sætning er et enkelt spørgsmål bestående af klausuler. Kun SELECT og et tidsinterval (SINCE) er påkrævet; alt andet er valgfrit. Når du inkluderer valgfrie klausuler, skal de stå i denne rækkefølge:
Et minimalt eksempel, daglig upsell-omsætning og acceptrate for de sidste 30 dage:
Nøgleord skelner ikke mellem store og små bogstaver (SELECT og select virker begge), og sætninger afsluttes ikke med semikolon. Strengværdier omgives af dobbelte anførselstegn; tal og lister gør ikke.

SELECT og GROUP BY

  • SELECT angiver de metrics, der skal måles, adskilt af kommaer, for eksempel SELECT revenue, impressions, accept_rate.
  • GROUP BY opdeler disse metrics efter en eller flere dimensioner, såsom date, device, surface eller funnel. Uden GROUP BY får du en enkelt total for hele perioden.

Filtrering med WHERE

WHERE indsnævrer dataene, før de måles. Kombiner betingelser med AND.
impressions, accept_rate og rpv kan ikke filtreres eller grupperes efter enhed, funnel, placering eller produkt; deres kilde-rollup har ingen sådan kolonne. Tilføjelse af WHERE device = "mobile" til en forespørgsel, der vælger en af dem, afvises med metric "impressions" cannot be filtered by "device".
Understøttede sammenligninger er =, !=, IN, NOT IN, >, <, >= og <=. Brug en liste med IN for at matche flere værdier:
experiment er ikke et filtrerbart felt; det har ingen rollup-kilde, så WHERE experiment IN [...] afvises med filters on "experiment" are not supported. Funnel-filteret understøtter multi-select: is one of (IN) inkluderer kun de valgte funnels, is not one of (NOT IN) udelukker dem. Når du grupperer efter Funnel og anvender et is one of-filter, viser diagrammet én linje pr. valgt funnel, uden at noget samles i “Other”.

Tidsintervaller og sammenligninger

Hver forespørgsel har brug for et tidsinterval, som sættes med SINCE: Tilgængelige forudindstillinger: last_1d, last_7d, last_30d, last_90d, this_month, last_month og this_year.
  • GRAIN sætter intervallets størrelse for tidsserier: day, week eller month. (hour kan parses, men intet rollup leverer timedata, så sådan en forespørgsel afvises med group_by / time_grain combination is not supported.)
  • COMPARE lægger en anden periode ovenpå. Brug previous_period, vinduet af samme længde umiddelbart før. previous_year er skjult fra Compare-vælgeren, fordi datavarehuset ikke indeholder data fra før februar 2026; den kan stadig kun skrives i AQL, så tidligere gemte forespørgsler fortsat kan parses.
Rapporteringsdata begynder i februar 2026, så et vindue tidligere end det returnerer tomt for begge perioder.

Valg af diagram

  • CHART angiver, hvordan resultatet vises: scorecard, line_chart, bar_chart, area_chart, funnel_chart eller table.
  • TIMEZONE angiver den tidszone, der bruges til at inddele datoer, som et IANA-navn i anførselstegn, for eksempel TIMEZONE "America/New_York". Standard er UTC (se Tidszoner).
Diagramtypen funnel_chart har specifikke krav:
  • Placeringstilstand. Gruppér efter placement, og vælg én metric. Trinene ordnes efter den kanoniske placeringssekvens (upsell default, derefter downsell, derefter yderligere upsells). Kun den første metric plottes; yderligere metrics noteres i en fodnote.
  • Metric-tilstand. Vælg to eller flere metrics uden GROUP BY. Hver metric bliver et tragttrin i forespørgselsrækkefølgen (for eksempel viser SELECT impressions, conversions et frafald fra impressions til conversions). Alle metrics skal have samme enhed.
Placeringstilstand kræver en metric, der kan opdeles efter placering. Det kan impressions, accept_rate og rpv ikke; tragtdiagrammet viser “These metrics can’t be grouped by placement” for dem.

Sortering og begrænsning

  • ORDER BY sorterer resultater efter en metric eller dimension med ASC eller DESC.
  • LIMIT begrænser antallet af returnerede rækker, nyttigt til spørgsmål af typen “top N”.

Flere eksempler

impressions, accept_rate og rpv kan ikke opdeles efter enhed; deres rollup er shop × surface × dag uden nogen enhedskolonne. Brug revenue (eller en anden konverteringsbaseret metric) til enhedssammenligninger.

Tidszoner

Som standard kører forespørgsler i UTC. Du kan tilsidesætte tidszonen, så datoopdelte resultater afspejler lokal tid (se Indstil en tidszone for trinene i værktøjslinjen).
Forespørgsler, der inkluderer Impressions, Accept Rate eller Revenue Per Visit, inddeler altid datoer i UTC, uanset hvilken tidszone du vælger, fordi de stammer fra et dagligt rollup, der rapporteres i UTC-dage. Hvis en forespørgsel blander en af disse med andre metrics, falder hele resultatsættet tilbage til UTC, så datointervallerne forbliver justerede.

TIMEZONE-klausulen

Angiv en tidszone direkte i AQL med TIMEZONE-klausulen, som står mellem CHART og ORDER BY:
Når klausulen er til stede, tilsidesætter den værktøjslinjevalget for den pågældende forespørgsel og bevares, når du gemmer og genindlæser.

Tilgængelige tidszoner

Vælgeren (og TIMEZONE-klausulen) accepterer et lukket sæt på ti zoner. Enhver anden IANA-tidszone afvises som ikke understøttet.

Kontoens standard, og hvordan tidszonen påvirker resultater

Hvis Lock reporting timezone er aktiveret i dine analyseindstillinger, bruger valget Account default den låste tidszone (værktøjslinjen viser den resulterende zone, for eksempel Timezone: Account default (Paris (CET))). Siden med analyseindstillinger accepterer den fulde IANA-liste, men Reports respekterer kun de ti zoner ovenfor; hvis din låste zone ikke er en af dem, oversættes Account default stiltiende til UTC. Hvis Lock reporting timezone ikke er aktiveret, falder Account default tilbage til UTC. Når en tidszone er indstillet, bruger datoinddelingen lokal tid i stedet for UTC. For eksempel falder en hændelse kl. 2026-03-29T01:30:00Z på den 28. marts i New York (ET), men på den 29. marts i Paris (CET). Forespørgsler uden tidszone, inklusive tidligere gemte, kører fortsat i UTC.