Измерения разбивают метрику по атрибуту. Не все измерения совместимы с каждой метрикой; Explorer автоматически предотвращает несовместимые комбинации (например, Decline rate и Show rate нельзя разбить по Currency).
Следующие измерения находятся в разработке. Они отображаются в списке выбора, но показываются как «Not compatible» для каждой метрики, пока не будут реализованы.
Инструкция AQL — это один вопрос, состоящий из предложений. Обязательны только
SELECT и временной диапазон (SINCE); все остальное необязательно. Если вы добавляете необязательные предложения, они должны идти в следующем порядке:
Ключевые слова не чувствительны к регистру (работают и
SELECT, и select), а инструкции не заканчиваются точкой с запятой. Строковые значения заключаются в двойные кавычки; числа и списки — нет.SELECTперечисляет измеряемые метрики через запятую, напримерSELECT revenue, impressions, accept_rate.GROUP BYразбивает эти метрики по одному или нескольким измерениям, таким какdate,device,surfaceилиfunnel. БезGROUP BYвы получаете одно итоговое значение за весь период.
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, которое располагается между 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.