Skip to main content
Każde zapytanie, które budujesz w Explorerze, jest instrukcją AftersellQL (AQL). Najczęściej budujesz zapytania wizualnie i nigdy nie piszesz AQL ręcznie; ta strona to dokumentacja metryk i wymiarów, które możesz wybrać, tekstowej formy AQL oraz zasad dotyczących stref czasowych.

Dostępne metryki

Oto metryki, które możesz wybrać, pogrupowane tak samo, jak grupuje je selektor metryk.

Przychód i zysk

Konwersje

Zaangażowanie

Wyniki sklepu

Sieć Rokt

Wymiary

Wymiary pozwalają rozbić metrykę według określonego atrybutu. Nie wszystkie wymiary są zgodne z każdą metryką; Explorer automatycznie zapobiega niezgodnym kombinacjom (na przykład Decline rate i Show rate nie można rozbić według Currency).

Dostępne wymiary

Niedostę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

Instrukcja AQL to pojedyncze pytanie złożone z klauzul. Wymagane są tylko SELECT i zakres czasu (SINCE); wszystko inne jest opcjonalne. Jeśli dodajesz klauzule opcjonalne, muszą one występować w tej kolejności:
Minimalny przykład — dzienny przychód z upsellów i wskaźnik akceptacji z ostatnich 30 dni:
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

  • SELECT wymienia metryki do zmierzenia, oddzielone przecinkami, na przykład SELECT revenue, impressions, accept_rate.
  • GROUP BY rozbija te metryki według jednego lub więcej wymiarów, takich jak date, device, surface lub funnel. Bez GROUP BY otrzymujesz pojedynczą sumę dla całego okresu.

Filtrowanie za pomocą WHERE

WHERE zawęża dane przed ich zmierzeniem. Warunki łączy się za pomocą AND.
impressions, accept_rate i rpv nie mogą być filtrowane ani grupowane według urządzenia, lejka, miejsca docelowego czy produktu; ich źródłowy rollup nie ma takiej kolumny. Dodanie WHERE device = "mobile" do zapytania wybierającego którąkolwiek z nich jest odrzucane z komunikatem metric "impressions" cannot be filtered by "device".
Obsługiwane porównania to =, !=, 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

Każde zapytanie potrzebuje zakresu czasu, ustawianego za pomocą SINCE: Dostępne wartości predefiniowane: last_1d, last_7d, last_30d, last_90d, this_month, last_month i this_year.
  • GRAIN ustawia rozmiar przedziału dla serii czasowych: day, week lub month. (hour jest parsowane, ale żaden rollup nie dostarcza danych godzinowych, więc takie zapytanie jest odrzucane z komunikatem group_by / time_grain combination is not supported.)
  • COMPARE nakłada drugi okres. Użyj previous_period, czyli okna o tej samej długości bezpośrednio poprzedzającego. previous_year jest 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

  • CHART określa sposób wyświetlania wyniku: scorecard, line_chart, bar_chart, area_chart, funnel_chart lub table.
  • TIMEZONE ustawia strefę czasową używaną do grupowania dat, jako nazwę IANA w cudzysłowach, na przykład TIMEZONE "America/New_York". Domyślnie UTC (zobacz Strefy czasowe).
Typ funnel_chart ma szczególne wymagania:
  • Tryb miejsc docelowych. Grupuj według placement i 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ład SELECT impressions, conversions pokazuje spadek od wyświetleń do konwersji). Wszystkie metryki muszą mieć tę samą jednostkę.
Tryb miejsc docelowych wymaga metryki, którą da się rozbić według miejsca docelowego. impressions, accept_rate i rpv się nie da; dla nich wykres lejkowy pokazuje komunikat „These metrics can’t be grouped by placement”.

Sortowanie i ograniczanie

  • ORDER BY sortuje wyniki według metryki lub wymiaru, z ASC lub DESC.
  • LIMIT ogranicza 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

Domyślnie zapytania działają w UTC. Możesz zastąpić strefę czasową, aby wyniki grupowane po datach odzwierciedlały czas lokalny (kroki na pasku narzędzi znajdziesz w sekcji Ustawianie strefy czasowej).
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

Strefę czasową możesz określić bezpośrednio w AQL za pomocą klauzuli TIMEZONE, która występuje między CHART a ORDER BY:
Gdy klauzula jest obecna, zastępuje wybór z paska narzędzi dla tego zapytania i jest zachowywana przy zapisywaniu i ponownym wczytywaniu.

Dostępne strefy czasowe

Selektor (oraz klauzula 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

Jeśli w ustawieniach analityki włączona jest opcja Lock reporting timezone, wybranie Account default używa tej zablokowanej strefy czasowej (pasek narzędzi pokazuje rozwiązaną strefę, na przykład Timezone: Account default (Paris (CET))). Strona ustawień analityki akceptuje pełną listę IANA, ale Reports honoruje tylko dziesięć powyższych stref; jeśli Twoja zablokowana strefa nie jest jedną z nich, Account default po cichu rozwiązuje się do UTC. Jeśli opcja Lock reporting timezone nie jest włączona, Account default wraca do UTC. Gdy ustawiona jest strefa czasowa, grupowanie po datach używa czasu lokalnego zamiast UTC. Na przykład zdarzenie o 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.