Skip to main content
Каждый запрос, который вы создаете в Explorer, — это инструкция AftersellQL (AQL). Чаще всего вы создаете запросы визуально и никогда не пишете AQL вручную; эта страница — справочник по метрикам и измерениям, которые можно выбрать, по текстовой форме AQL и по правилам часовых поясов.

Доступные метрики

Ниже перечислены метрики, которые можно выбрать, сгруппированные так же, как в списке выбора метрик.

Доход и прибыль

Конверсии

Вовлеченность

Показатели магазина

Сеть Rokt

Измерения

Измерения разбивают метрику по атрибуту. Не все измерения совместимы с каждой метрикой; Explorer автоматически предотвращает несовместимые комбинации (например, Decline rate и Show rate нельзя разбить по Currency).

Доступные измерения

Недоступные измерения

Следующие измерения находятся в разработке. Они отображаются в списке выбора, но показываются как «Not compatible» для каждой метрики, пока не будут реализованы.

Синтаксис инструкций AQL

Инструкция AQL — это один вопрос, состоящий из предложений. Обязательны только SELECT и временной диапазон (SINCE); все остальное необязательно. Если вы добавляете необязательные предложения, они должны идти в следующем порядке:
Минимальный пример — ежедневный доход от апселлов и accept rate за последние 30 дней:
Ключевые слова не чувствительны к регистру (работают и SELECT, и select), а инструкции не заканчиваются точкой с запятой. Строковые значения заключаются в двойные кавычки; числа и списки — нет.

SELECT и GROUP BY

  • SELECT перечисляет измеряемые метрики через запятую, например SELECT revenue, impressions, accept_rate.
  • GROUP BY разбивает эти метрики по одному или нескольким измерениям, таким как date, device, surface или funnel. Без GROUP BY вы получаете одно итоговое значение за весь период.

Фильтрация с помощью WHERE

WHERE сужает данные до их измерения. Объединяйте условия с помощью AND.
impressions, accept_rate и rpv нельзя фильтровать или группировать по устройству, воронке, размещению или товару; в их исходной агрегации нет такого столбца. Добавление WHERE device = "mobile" к запросу, выбирающему любую из них, отклоняется с ошибкой metric "impressions" cannot be filtered by "device".
Поддерживаемые операторы сравнения: =, !=, 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 показывает отсев от показов к конверсиям). Все метрики должны иметь одинаковую единицу измерения.
Для режима размещений нужна метрика, которую можно разбить по размещению. impressions, accept_rate и rpv этого не позволяют; для них график воронки показывает сообщение «These metrics can’t be grouped by placement».

Сортировка и ограничение

  • ORDER BY сортирует результаты по метрике или измерению с ASC или DESC.
  • LIMIT ограничивает количество возвращаемых строк, что полезно для вопросов вида «топ N».

Другие примеры

impressions, accept_rate и rpv нельзя разбить по устройству; их агрегация имеет вид магазин × поверхность × день, без столбца устройства. Для сравнения устройств используйте revenue (или другую метрику на основе конверсий).

Часовые пояса

По умолчанию запросы выполняются в UTC. Вы можете переопределить часовой пояс, чтобы результаты с группировкой по датам отражали местное время (шаги на панели инструментов см. в разделе Настройка часового пояса).
Запросы, включающие Impressions, Accept Rate или Revenue Per Visit, всегда группируют даты в UTC независимо от выбранного часового пояса, поскольку эти данные берутся из ежедневной агрегации, формируемой по дням UTC. Если запрос сочетает одну из этих метрик с другими, весь набор результатов переключается на UTC, чтобы интервалы дат оставались согласованными.

Предложение TIMEZONE

Укажите часовой пояс непосредственно в AQL с помощью предложения TIMEZONE, которое располагается между CHART и ORDER BY:
Если это предложение присутствует, оно переопределяет выбор на панели инструментов для данного запроса и сохраняется при сохранении и повторной загрузке.

Доступные часовые пояса

Список выбора (и предложение TIMEZONE) принимает закрытый набор из десяти поясов. Любой другой часовой пояс IANA отклоняется как неподдерживаемый.

Значение по умолчанию для аккаунта и влияние часового пояса на результаты

Если в настройках аналитики включен параметр Lock reporting timezone, выбор Account default использует этот зафиксированный часовой пояс (панель инструментов показывает итоговый пояс, например Timezone: Account default (Paris (CET))). Страница настроек аналитики принимает полный список IANA, но Reports учитывает только десять перечисленных выше поясов; если ваш зафиксированный пояс не входит в их число, Account default без предупреждения использует UTC. Если параметр Lock reporting timezone не включен, Account default использует UTC. Когда часовой пояс задан, группировка по датам использует местное время вместо UTC. Например, событие в 2026-03-29T01:30:00Z приходится на 28 марта в Нью-Йорке (ET), но на 29 марта в Париже (CET). Запросы без часового пояса, включая ранее сохраненные, по-прежнему выполняются в UTC.