> 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.md).

# Отчеты

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

{% hint style="info" %}
Конструктор отчётов доступен на тарифе **Premium**.
{% endhint %}

{% hint style="info" %}
В основе любого отчёта лежат **события** — без них строить отчёты не из чего. Полный список стандартных событий, которые graspil создаёт автоматически, и о том, как добавить собственные, — на странице [Список событий](/ru/app/reports/events.md).
{% endhint %}

## Какие отчёты можно строить

| Тип отчёта   | Что показывает                                                                                                    | Подробнее                                |
| ------------ | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| **Тренды**   | Динамику показателя по дням (или по неделям) — например, сколько было покупок или новых пользователей каждый день | [Тренды](/ru/app/reports/trends.md)      |
| **Таблица**  | То же самое, что тренды, но в виде таблицы с цифрами, а не графика — удобно, когда нужны точные значения          | [Тренды](/ru/app/reports/trends.md)      |
| **Воронки**  | Сколько пользователей дошли от первого шага (например, открыл бота) до последнего (например, оплатил)             | [Воронки](/ru/app/reports/funnels.md)    |
| **Ретеншен** | Возвращаются ли пользователи и повторяют ли действие через какое-то время                                         | [Ретеншен](/ru/app/reports/retention.md) |

{% hint style="info" %}
Воронки можно строить **сквозными** — то есть собирать шаги из разных каналов и ботов в одну воронку. Например: подписка на канал → запуск бота → покупка — каждый шаг может относиться к своему ресурсу. Подробнее — в разделе [Воронки](/ru/app/reports/funnels.md#skvoznaya-voronka).
{% endhint %}

{% hint style="info" %}
Если перечисленных типов отчётов недостаточно — доступны кастомные отчёты на собственном SQL-запросе. Напишите в поддержку, чтобы обсудить разработку такого отчёта.
{% endhint %}

## Как создать отчёт

1. Откройте раздел «Отчёты» в личном кабинете и нажмите «Создать отчёт».
2. Выберите тип отчёта — тренды, таблица, воронка или ретеншен.
3. Добавьте нужные события — для трендов это один или несколько показателей, для воронки — шаги по порядку, для ретеншена — стартовое событие и событие возврата.
4. При необходимости настройте фильтры и период данных (см. ниже).
5. Сохраните отчёт. После сохранения отчёт появляется в общем списке отчётов, его можно открывать, редактировать и добавлять на дашборд.

## Возможности, общие для всех типов отчётов

### Фильтры

Фильтры сужают данные, которые попадают в отчёт. Бывают двух видов:

1. **Общий фильтр** — применяется сразу ко всем данным отчёта (ко всем трендам, ко всем шагам воронки и т.д.).
2. **Фильтр к событию** — применяется только к одному показателю или шагу. Чтобы добавить такой фильтр, нажмите на иконку воронки рядом с выбранным событием.

Например, чтобы посчитать только продажи на сумму больше 100$: выберите событие «Покупка» и добавьте к нему фильтр по полю «Значение (число)» больше `100000` (суммы хранятся в минимальных единицах — копейках/центах), а также при необходимости фильтр по полю «Единица измерения» равно `usd`.

Полный список полей, по которым можно фильтровать (категория, сумма, источник перехода, страна, устройство, кастомные поля пользователя и т.д.), с описанием каждого — на отдельной странице: [Поля для фильтров](/ru/app/reports/filter-fields.md).

### Ресурсы

В общих фильтрах отдельно настраивается, по каким ресурсам (ботам/каналам) считать отчёт:

| Настройка             | Что делает                                                                                                                                                                        |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Все ресурсы**       | Отчёт всегда использует данные всех ресурсов, доступных вам                                                                                                                       |
| **Текущий ресурс**    | Отчёт использует данные того ресурса, который выбран в шапке личного кабинета сейчас. Удобно для одного универсального отчёта, который будет работать для разных ботов по очереди |
| **Выбранные ресурсы** | Вы вручную указываете, с какими конкретными ресурсами должен работать отчёт                                                                                                       |

{% hint style="info" %}
Конструктор позволяет строить отчёты сразу по нескольким ресурсам — например, вывести на один график количество новых пользователей из канала и из бота одновременно.
{% endhint %}

### Период

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

### Системные отчёты

В graspil есть набор готовых базовых отчётов, доступных всем пользователям — они называются **системными**. Их нельзя редактировать напрямую, но можно сделать копию и изменить копию как угодно.

### Сохранение и дашборды

Любой созданный отчёт сохраняется в общем списке отчётов. Сохранённый отчёт можно закрепить на дашборд и использовать в других частях системы — так на одном экране можно собрать сразу несколько важных для вас графиков.