-- cap the number of rows
```
Минимальный пример — ежедневный доход от апселлов и accept rate за последние 30 дней:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
```
Ключевые слова не чувствительны к регистру (работают и `SELECT`, и `select`), а инструкции не заканчиваются точкой с запятой. Строковые значения заключаются в двойные кавычки; числа и списки — нет.
### SELECT и GROUP BY
* **`SELECT`** перечисляет измеряемые метрики через запятую, например `SELECT revenue, impressions, accept_rate`.
* **`GROUP BY`** разбивает эти метрики по одному или нескольким измерениям, таким как `date`, `device`, `surface` или `funnel`. Без `GROUP BY` вы получаете одно итоговое значение за весь период.
### Фильтрация с помощью WHERE
`WHERE` сужает данные до их измерения. Объединяйте условия с помощью `AND`.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
WHERE device = "mobile"
GROUP BY date
SINCE last_month
GRAIN day
```
`impressions`, `accept_rate` и `rpv` **нельзя** фильтровать или группировать по устройству, воронке, размещению или товару; в их исходной агрегации нет такого столбца. Добавление `WHERE device = "mobile"` к запросу, выбирающему любую из них, отклоняется с ошибкой `metric "impressions" cannot be filtered by "device"`.
Поддерживаемые операторы сравнения: `=`, `!=`, `IN`, `NOT IN`, `>`, `<`, `>=` и `<=`. Используйте список с `IN`, чтобы сопоставить несколько значений:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
WHERE surface IN ["PPU", "Checkout"]
```
`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`:
| Форма | Пример | Значение |
| - | - | - |
| Пресет | `SINCE last_30d` | Скользящее окно, заканчивающееся **вчера** (UTC). Текущий незавершенный день намеренно исключается, поэтому `last_1d` означает только вчерашний день, а `this_month` охватывает период с 1-го числа по вчерашний день. |
| Пользовательское окно | `SINCE 2026-07-02 UNTIL 2026-07-05` | Фиксированный диапазон с датами в формате ISO (`YYYY-MM-DD`). |
Доступные пресеты: `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 только для того, чтобы ранее сохраненные запросы продолжали распознаваться.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- A four-day sale vs the four days immediately before it
SELECT revenue, impressions, accept_rate
GROUP BY date
SINCE 2026-07-02 UNTIL 2026-07-05
GRAIN day
COMPARE previous_period
```
Данные отчетности начинаются с **февраля 2026 года**, поэтому окно ранее этой даты возвращает пустой результат для обоих периодов.
### Выбор графика
* **`CHART`** задает способ отображения результата: `scorecard`, `line_chart`, `bar_chart`, `area_chart`, `funnel_chart` или `table`.
* **`TIMEZONE`** задает часовой пояс для группировки дат в виде имени IANA в кавычках, например `TIMEZONE "America/New_York"`. По умолчанию используется UTC (см. [Часовые пояса](#timezones)).
У типа `funnel_chart` есть особые требования:
* **Режим размещений.** Группируйте по `placement` и выберите одну метрику. Этапы упорядочены по каноничной последовательности размещений (сначала апселл по умолчанию, затем даунселл, затем дополнительные апселлы). Отображается только первая метрика; дополнительные метрики отмечаются в сноске.
* **Режим метрик.** Выберите две или более метрики без `GROUP BY`. Каждая метрика становится этапом воронки в порядке запроса (например, `SELECT impressions, conversions` показывает отсев от показов к конверсиям). Все метрики должны иметь одинаковую единицу измерения.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Placement funnel: conversion drop-off across placements
SELECT conversions
GROUP BY placement
SINCE last_30d
CHART funnel_chart
```
Для режима размещений нужна метрика, которую можно разбить по размещению. `impressions`, `accept_rate` и `rpv` этого не позволяют; для них график воронки показывает сообщение «These metrics can't be grouped by placement».
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Metric funnel: impressions to conversions drop-off
SELECT impressions, conversions
SINCE last_30d
CHART funnel_chart
```
### Сортировка и ограничение
* **`ORDER BY`** сортирует результаты по метрике или измерению с `ASC` или `DESC`.
* **`LIMIT`** ограничивает количество возвращаемых строк, что полезно для вопросов вида «топ N».
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Top 20 products by upsell revenue this month
SELECT revenue, conversions, avg_conversion_value
GROUP BY product
SINCE this_month
ORDER BY revenue DESC
LIMIT 20
```
### Другие примеры
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Daily performance vs the previous period
SELECT revenue, impressions, conversions, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
COMPARE previous_period
```
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Mobile vs desktop revenue over the last 90 days
SELECT revenue
GROUP BY device
SINCE last_90d
ORDER BY revenue DESC
```
`impressions`, `accept_rate` и `rpv` нельзя разбить по устройству; их агрегация имеет вид магазин × поверхность × день, без столбца устройства. Для сравнения устройств используйте `revenue` (или другую метрику на основе конверсий).
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Which surface is driving the most revenue?
SELECT revenue, impressions, accept_rate
GROUP BY surface
SINCE last_30d
ORDER BY revenue DESC
```
## Часовые пояса
По умолчанию запросы выполняются в UTC. Вы можете переопределить часовой пояс, чтобы результаты с группировкой по датам отражали местное время (шаги на панели инструментов см. в разделе [Настройка часового пояса](/ru/aftersell/reports_explorer#setting-a-timezone)).
Запросы, включающие **Impressions**, **Accept Rate** или **Revenue Per Visit**, всегда группируют даты в UTC независимо от выбранного часового пояса, поскольку эти данные берутся из ежедневной агрегации, формируемой по дням UTC. Если запрос сочетает одну из этих метрик с другими, весь набор результатов переключается на UTC, чтобы интервалы дат оставались согласованными.
### Предложение TIMEZONE
Укажите часовой пояс непосредственно в AQL с помощью предложения `TIMEZONE`, которое располагается между `CHART` и `ORDER BY`:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT ...
CHART ...
TIMEZONE "Asia/Tokyo"
ORDER BY ...
```
Если это предложение присутствует, оно переопределяет выбор на панели инструментов для данного запроса и сохраняется при сохранении и повторной загрузке.
### Доступные часовые пояса
Список выбора (и предложение `TIMEZONE`) принимает закрытый набор из десяти поясов. Любой другой часовой пояс IANA отклоняется как неподдерживаемый.
| Часовой пояс | Пример местоположения |
| - | - |
| UTC | Всемирное координированное время |
| America/New\_York | Нью-Йорк (ET) |
| America/Chicago | Чикаго (CT) |
| America/Denver | Денвер (MT) |
| America/Los\_Angeles | Лос-Анджелес (PT) |
| Europe/London | Лондон (GMT/BST) |
| Europe/Paris | Париж (CET/CEST) |
| Asia/Tokyo | Токио (JST) |
| Asia/Singapore | Сингапур (SGT) |
| Australia/Sydney | Сидней (AEST/AEDT) |
### Значение по умолчанию для аккаунта и влияние часового пояса на результаты
Если в настройках аналитики включен параметр **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.