Доступные метрики
Доход и прибыль
Конверсии
Вовлеченность
Показатели магазина
Сеть Rokt
Измерения
Доступные измерения
Следующие измерения находятся в разработке. Они отображаются в списке выбора, но показываются как «Not compatible» для каждой метрики, пока не будут реализованы.
Синтаксис инструкций AQL
SELECT и временной диапазон (SINCE); все остальное необязательно. Если вы добавляете необязательные предложения, они должны идти в следующем порядке:
Ключевые слова не чувствительны к регистру (работают и
SELECT, и select), а инструкции не заканчиваются точкой с запятой. Строковые значения заключаются в двойные кавычки; числа и списки — нет.SELECT и GROUP BY
SELECTперечисляет измеряемые метрики через запятую, напримерSELECT revenue, impressions, accept_rate.GROUP BYразбивает эти метрики по одному или нескольким измерениям, таким какdate,device,surfaceилиfunnel. БезGROUP BYвы получаете одно итоговое значение за весь период.
Фильтрация с помощью WHERE
WHERE сужает данные до их измерения. Объединяйте условия с помощью AND.
=, !=, IN, NOT IN, >, <, >= и <=. Используйте список с IN, чтобы сопоставить несколько значений:
experiment не является полем для фильтрации; у него нет источника агрегации, поэтому WHERE experiment IN [...] отклоняется с ошибкой filters on "experiment" are not supported.
Фильтр funnel поддерживает множественный выбор: is one of (IN) включает только выбранные воронки, is not one of (NOT IN) исключает их. Если вы группируете по Funnel и применяете фильтр is one of, график показывает по одной линии на каждую выбранную воронку, без объединения в «Other».
Временные диапазоны и сравнения
SINCE:
Доступные пресеты:
last_1d, last_7d, last_30d, last_90d, this_month, last_month и this_year.
GRAINзадает размер интервала для временных рядов:day,weekилиmonth. (hourраспознается, но ни одна агрегация не предоставляет почасовые данные, поэтому такой запрос отклоняется с ошибкойgroup_by / time_grain combination is not supported.)COMPAREнакладывает второй период. Используйтеprevious_period— окно той же длины непосредственно перед выбранным.previous_yearскрыт в списке выбора Compare, поскольку в хранилище нет данных до февраля 2026 года; его можно ввести в AQL только для того, чтобы ранее сохраненные запросы продолжали распознаваться.
Данные отчетности начинаются с февраля 2026 года, поэтому окно ранее этой даты возвращает пустой результат для обоих периодов.
Выбор графика
CHARTзадает способ отображения результата:scorecard,line_chart,bar_chart,area_chart,funnel_chartилиtable.TIMEZONEзадает часовой пояс для группировки дат в виде имени IANA в кавычках, напримерTIMEZONE "America/New_York". По умолчанию используется UTC (см. Часовые пояса).
funnel_chart есть особые требования:
- Режим размещений. Группируйте по
placementи выберите одну метрику. Этапы упорядочены по каноничной последовательности размещений (сначала апселл по умолчанию, затем даунселл, затем дополнительные апселлы). Отображается только первая метрика; дополнительные метрики отмечаются в сноске. - Режим метрик. Выберите две или более метрики без
GROUP BY. Каждая метрика становится этапом воронки в порядке запроса (например,SELECT impressions, conversionsпоказывает отсев от показов к конверсиям). Все метрики должны иметь одинаковую единицу измерения.
Сортировка и ограничение
ORDER BYсортирует результаты по метрике или измерению сASCилиDESC.LIMITограничивает количество возвращаемых строк, что полезно для вопросов вида «топ N».
Другие примеры
impressions, accept_rate и rpv нельзя разбить по устройству; их агрегация имеет вид магазин × поверхность × день, без столбца устройства. Для сравнения устройств используйте revenue (или другую метрику на основе конверсий).Часовые пояса
Запросы, включающие Impressions, Accept Rate или Revenue Per Visit, всегда группируют даты в UTC независимо от выбранного часового пояса, поскольку эти данные берутся из ежедневной агрегации, формируемой по дням UTC. Если запрос сочетает одну из этих метрик с другими, весь набор результатов переключается на UTC, чтобы интервалы дат оставались согласованными.
Предложение TIMEZONE
TIMEZONE, которое располагается между CHART и ORDER BY:
Доступные часовые пояса
TIMEZONE) принимает закрытый набор из десяти поясов. Любой другой часовой пояс IANA отклоняется как неподдерживаемый.
Значение по умолчанию для аккаунта и влияние часового пояса на результаты
2026-03-29T01:30:00Z приходится на 28 марта в Нью-Йорке (ET), но на 29 марта в Париже (CET). Запросы без часового пояса, включая ранее сохраненные, по-прежнему выполняются в UTC.