> 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/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` - числовое значение, это может быть сумма продажи или любое другое числовое значение
6. `unit` - единица измерения, например usd
7. и т.д...

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

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

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

При подключении 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?

| Событие | Название события      | Пояснение                                                         |
| ------- | --------------------- | ----------------------------------------------------------------- |
|         | Первый запуск бота    |                                                                   |
|         | Возврат в бот         | Создается когда пользователь заблокировал бот и зпустил его снова |
|         | Повторный запуск бота | Если бот уже был запущен и отправляется команда /start            |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.graspil.com/ru/kak-rabotaet-analitika-i-otchety.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.