> For the complete documentation index, see [llms.txt](https://docs.graspil.com/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graspil.com/ru/app/reports/trends.md).

# Тренды

Этот тип отчёта показывает динамику выбранных показателей во времени. По горизонтальной оси — даты, по вертикальной — значение показателя в зависимости от выбранной агрегации. Тот же отчёт можно показать не графиком, а таблицей с цифрами по дням — выбор формата (график/таблица) не меняет настройку самого показателя.

## Как добавить тренд

1. Нажмите «Добавить тренд» (или аналогичную кнопку добавления показателя).
2. Выберите событие, которое хотите отслеживать — например, «Покупка» или «Новые пользователи». Можно выбрать конкретное событие или «Все события», если важно общее количество активности.
3. Выберите агрегацию — то, как именно считать выбранное событие (см. таблицу ниже).
4. При необходимости добавьте фильтр к этому показателю — нажмите на иконку воронки рядом с событием. Доступные поля для фильтра описаны на странице [Поля для фильтров](/ru/app/reports/filter-fields.md).
5. Повторите для всех показателей, которые хотите видеть на одном графике — можно добавить несколько трендов сразу, они будут показаны отдельными линиями.

## Агрегации

Агрегация определяет, что именно считается для выбранного события за каждый день (или другой период).

| Агрегация                            | Что показывает                                                                                                                                                                                                                          |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Всего**                            | Общее количество событий за период                                                                                                                                                                                                      |
| **Уникальные пользователи**          | Сколько разных пользователей совершили это событие, по полю `user_id`                                                                                                                                                                   |
| **Активные пользователи (MAU, WAU)** | Сколько уникальных пользователей совершили событие за последние 30 (MAU) или 7 (WAU) дней относительно каждой точки графика                                                                                                             |
| **Уникальные сессии**                | Сколько разных сессий бота содержат это событие                                                                                                                                                                                         |
| **Уникальные App сессии**            | Сколько разных сессий в Mini App содержат это событие                                                                                                                                                                                   |
| **Количество на пользователя**       | Сколько событий приходится на одного пользователя — можно выбрать среднее, минимальное, максимальное или медианное значение                                                                                                             |
| **Значение свойства**                | Агрегирует не количество событий, а числовое значение в их параметрах (сумма, среднее, минимум, максимум, медиана). Подходит, чтобы посчитать сумму продаж, а не просто их количество. Есть два поля на выбор — см. предупреждение ниже |

{% hint style="warning" %}
Для агрегации «Значение свойства» доступны два поля:

* `events.value_int` — «сырое» значение ровно в том виде, в котором оно было отправлено в событии (в `value_num`), **без** перевода в обычные единицы и **без** конвертации валют. Для денежных событий это минимальные единицы валюты (например, копейки для RUB) — если сумма продажи была 999 ₽, `value_int` будет равен 99900.
* `events.value_amount` — то же значение, но переведённое в обычный вид (рубли вместо копеек) и сконвертированное по курсу в валюту, указанную у вас в [профиле](https://app.graspil.com/profile).

Если считаете **деньги** (сумму продаж, выручку и т.п.) — используйте `events.value_amount`, иначе итоговая сумма будет казаться завышенной в 100 раз (или больше — если единица не копейка/цент). `events.value_int` подходит для нефинансовых числовых значений, где перевод и конвертация не нужны.
{% endhint %}

## Сравнение нескольких показателей

На одном графике можно одновременно показывать несколько трендов — например, «Новые пользователи» и «Заблокировали бота» рядом, чтобы сравнить приток и отток.

## Разбивка (breakdown)

Разбивка делит один показатель на несколько линий — по одному на каждое значение выбранного поля. Например, разбивка по источнику (UTM) покажет отдельную линию для каждого канала трафика, а разбивка по стране — отдельную линию для каждой страны пользователей.

Можно указать сразу несколько полей для разбивки — тогда линии будут построены по комбинации их значений.

## Режим формулы

Режим формулы позволяет складывать, вычитать, умножать и делить итоговые значения нескольких трендов между собой. Каждому тренду присваивается буква — `A`, `B`, `C` и так далее, в порядке добавления. В режиме формулы вы пишете выражение с этими буквами, и на графике появляется новая линия — результат вычисления.

**Пример:** хотим увидеть процент пользователей, которые ушли, от общего числа пришедших.

1. Тренд `A` — событие «Новые пользователи в боте», агрегация «Всего».
2. Тренд `B` — событие «Блокировка бота», агрегация «Всего».
3. Формула: `B / A * 100` — линия с процентом ушедших пользователей по дням.

## Пример отчёта

**Сумма продаж по дням, в разрезе источника трафика**

* Показатель: событие «Покупка», агрегация «Значение свойства» → сумма `events.value_amount`
* Разбивка: по полю «UTM (Первый запуск) → Источник»
* Период: последние 30 дней

В результате — несколько линий, по одной на каждый источник трафика, показывающих сумму продаж в валюте вашего профиля по дням (события в разных валютах будут автоматически приведены к одной по курсу).
