# Аналитика поведения Mini App

## Зачем собираем

Главный результат — понять, какие экраны и услуги приводят клиента к заявке, а где он теряется. Основные показатели:

- конверсия активного пользователя в заявку;
- конверсия просмотра услуги в отправку заявки;
- доля завершённых планов отдыха;
- поиски без результатов;
- время до первого содержательного действия;
- популярные экраны, услуги и направления.

## События

| Событие | Что означает |
| --- | --- |
| `SESSION_STARTED` | новый запуск Mini App |
| `SCREEN_VIEWED` | пользователь открыл экран |
| `SCREEN_TIME_RECORDED` | активное время на экране, от 1 секунды до 30 минут за отрезок |
| `SERVICE_VIEWED` | открыта карточка экскурсии или трансфера |
| `SEARCH_USED` | выполнен поиск; сохраняется только число результатов |
| `FILTER_APPLIED` | выбрано направление или категория |
| `CTA_CLICKED` | нажат чат, отправка заявки или отправка плана |

## Приватность

В события не записываются телефон, имя, комментарии, текст переписки и текст поискового запроса. Активность связана с уже авторизованным Telegram-пользователем и доступна только в защищённой админке.

## Как читать данные

- «В Mini App» в карточке клиента — сумма зафиксированного активного времени в выбранном периоде.
- «Интерес» — последняя открытая услуга; если услуг не открывали, последний экран.
- «Где проводят время» — суммарное активное время всех клиентов по экранам.
- «Интерес к услугам» — число открытий карточек, а не число уникальных покупателей.

Первые данные появятся только после публикации версии с аналитикой. Историческая активность до релиза не восстанавливается.

## Рекомендуемая эксплуатация

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