Dostępne metryki
Przychód i zysk
Konwersje
Zaangażowanie
Wyniki sklepu
Sieć Rokt
Wymiary
Dostępne wymiary
Poniższe wymiary są w trakcie opracowywania. Pojawiają się w selektorze, ale do czasu wdrożenia wyświetlają się jako „Not compatible” dla każdej metryki.
Składnia instrukcji AQL
SELECT i zakres czasu (SINCE); wszystko inne jest opcjonalne. Jeśli dodajesz klauzule opcjonalne, muszą one występować w tej kolejności:
W słowach kluczowych nie jest rozróżniana wielkość liter (
SELECT i select działają tak samo), a instrukcje nie kończą się średnikiem. Wartości tekstowe umieszcza się w podwójnych cudzysłowach; liczb i list nie.SELECT i GROUP BY
SELECTwymienia metryki do zmierzenia, oddzielone przecinkami, na przykładSELECT revenue, impressions, accept_rate.GROUP BYrozbija te metryki według jednego lub więcej wymiarów, takich jakdate,device,surfacelubfunnel. BezGROUP BYotrzymujesz pojedynczą sumę dla całego okresu.
Filtrowanie za pomocą WHERE
WHERE zawęża dane przed ich zmierzeniem. Warunki łączy się za pomocą AND.
=, !=, IN, NOT IN, >, <, >= i <=. Użyj listy z IN, aby dopasować kilka wartości:
experiment nie jest polem filtrowalnym; nie ma źródła rollupu, więc WHERE experiment IN [...] jest odrzucane z komunikatem filters on "experiment" are not supported.
Filtr funnel obsługuje wielokrotny wybór: is one of (IN) uwzględnia tylko wybrane lejki, a is not one of (NOT IN) je wyklucza. Gdy grupujesz według Funnel i stosujesz filtr is one of, wykres pokazuje po jednej linii dla każdego wybranego lejka, bez scalania do kategorii „Other”.
Zakresy czasu i porównania
SINCE:
Dostępne wartości predefiniowane:
last_1d, last_7d, last_30d, last_90d, this_month, last_month i this_year.
GRAINustawia rozmiar przedziału dla serii czasowych:day,weeklubmonth. (hourjest parsowane, ale żaden rollup nie dostarcza danych godzinowych, więc takie zapytanie jest odrzucane z komunikatemgroup_by / time_grain combination is not supported.)COMPAREnakłada drugi okres. Użyjprevious_period, czyli okna o tej samej długości bezpośrednio poprzedzającego.previous_yearjest ukryte w selektorze Compare, ponieważ hurtownia nie zawiera danych sprzed lutego 2026; pozostaje możliwe do wpisania w AQL wyłącznie po to, aby wcześniej zapisane zapytania nadal się parsowały.
Dane raportowe zaczynają się w lutym 2026, więc okno wcześniejsze niż ta data zwraca puste wyniki dla obu okresów.
Wybór wykresu
CHARTokreśla sposób wyświetlania wyniku:scorecard,line_chart,bar_chart,area_chart,funnel_chartlubtable.TIMEZONEustawia strefę czasową używaną do grupowania dat, jako nazwę IANA w cudzysłowach, na przykładTIMEZONE "America/New_York". Domyślnie UTC (zobacz Strefy czasowe).
funnel_chart ma szczególne wymagania:
- Tryb miejsc docelowych. Grupuj według
placementi wybierz jedną metrykę. Etapy są uporządkowane według kanonicznej sekwencji miejsc docelowych (domyślny upsell, potem downsell, potem dodatkowe upselle). Rysowana jest tylko pierwsza metryka; dodatkowe metryki są odnotowane w przypisie. - Tryb metryk. Wybierz dwie lub więcej metryk bez
GROUP BY. Każda metryka staje się etapem lejka w kolejności zapytania (na przykładSELECT impressions, conversionspokazuje spadek od wyświetleń do konwersji). Wszystkie metryki muszą mieć tę samą jednostkę.
Sortowanie i ograniczanie
ORDER BYsortuje wyniki według metryki lub wymiaru, zASClubDESC.LIMITogranicza liczbę zwracanych wierszy, co przydaje się przy pytaniach typu „top N”.
Więcej przykładów
impressions, accept_rate i rpv nie można rozbić według urządzenia; ich rollup to sklep × powierzchnia × dzień, bez kolumny urządzenia. Do porównań urządzeń używaj revenue (lub innej metryki pochodzącej z konwersji).Strefy czasowe
Zapytania zawierające Impressions, Accept Rate lub Revenue Per Visit zawsze grupują daty w UTC, niezależnie od wybranej strefy czasowej, ponieważ metryki te pochodzą z dziennego rollupu raportowanego w dniach UTC. Jeśli zapytanie łączy jedną z tych metryk z innymi, cały zbiór wyników wraca do UTC, aby przedziały dat pozostały wyrównane.
Klauzula TIMEZONE
TIMEZONE, która występuje między CHART a ORDER BY:
Dostępne strefy czasowe
TIMEZONE) akceptuje zamknięty zestaw dziesięciu stref. Każda inna strefa czasowa IANA jest odrzucana jako nieobsługiwana.
Domyślna strefa konta i wpływ strefy czasowej na wyniki
2026-03-29T01:30:00Z przypada na 28 marca w Nowym Jorku (ET), ale na 29 marca w Paryżu (CET). Zapytania bez strefy czasowej, w tym wcześniej zapisane, nadal działają w UTC.