> 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/kak-rabotaet-analitika-i-otchety.md).

# Как работает аналитика и отчеты?

В основе каждой аналитики лежат события. Обычно события это какое-то действие пользователя, запуск бота, открытие страницы сайта, клик по кнопке, покупка, уход пользователя, отправка сообщения и т.д.

У каждого события есть несколько параметров, основные из них:

1. `date` - Дата и время когда произошло событие
2. `user_id` - пользователь который совершил событие. Может быть 0 - такие события называются **анонимными**
3. `event_id/event_name` - название самого события которое было совершено
4. `category_id/category_name` - категория события, для дополнительной категоризации событий
5. `value_int` - числовое значение, это может быть сумма продажи или любое другое числовое значение. Если событие денежное, значение хранится в **минимальных единицах валюты** (например, в копейках для RUB) — так, как его передали через `value_num`/`unit`, без переводного коэффициента
6. `unit` - единица измерения, например usd
7. `value_amount` - вычисляемое поле, доступное только в отчётах (не хранится как отдельная колонка): переводит `value_int` в обычный вид (рубли, а не копейки) и конвертирует по курсу в валюту, которая установлена у вас в [профиле](https://app.graspil.com/profile). Используйте его вместо `value_int`, когда считаете суммы в деньгах — подробнее см. [Тренды](/ru/app/reports/trends.md)
8. и т.д...

Все события хранятся в виде большой таблицы, к которой можно делать запросы и строить различные отчеты.

Для построения действительно полезных отчетов **критически** **важно** **собирать** **все** **нужные** **события**, невозможно построить отчет о количестве продаж если у нас физически нет событий продаж.

#### **Как собирать события?**

При подключении graspil, вам автоматически будет достпен довольно широкий набор событий. Но все же каждый продукт уникален и требуется индивидуальная настройка. Для этого вам доступные следующие инструменты:

1. [API](/ru/api/send-event.md) - апи позволяет передать события даже в самых сложных случаях
2. Триггеры - вы можете задать условия при наступлении которых будет создано событие, например ваш бот отправляет сообщение после продажи с текстом "Спасибо за покупку", вы можете создать триггер, который будет искать фразу "Спасибо за покупку" в сообщениях и будет создавать событие
3. Автоматизация - при создании автоматизаций вы можете так же создавать события.
4. [Передача событий из mini app](/ru/connect-bot/mini-app.md#svoi-sobytiya) - можно создвать события при определенных кликах или действиях.
5. [Переход по внешним ссылкам](/ru/app/outside-links.md) - если пользователь переходит по ссылке из бота или канала, есть способ создавать событие при переходе.

#### Какие события создаются автоматически в graspil?

При подключении ресурса вам автоматически доступен большой набор стандартных событий — запуск и блокировка бота, сообщения, платежи, действия в мини-приложении, рассылки и т.д. Полный список со всеми названиями и пояснениями смотрите на странице [Список событий](/ru/app/reports/events.md).