Система аналитики Gifty 📊
Философия и цели
Аналитика в Gifty — это не просто сбор цифр, это инструмент для понимания того, насколько успешно наши алгоритмы решают задачу пользователя (поиск подарка). Мы разделяем мониторинг на два уровня: бизнес-аналитика (поведение пользователей) и техническое здоровье (стабильность сервисов).
Почему мы это измеряем?
- Quiz Completion Rate: Показывает, насколько сложной или длинной кажется анкета. Если пользователь уходит на 3-м вопросе, нам нужно упрощать UI.
- Gift CTR (Click-Through Rate): Главная метрика качества наших рекомендаций. Если пользователь кликает на предложенные товары, значит, LLM и векторный поиск сработали верно.
- Accuracy of Categories: Мы отслеживаем, насколько корректно AI-категоризатор распределяет товары по нашему "дереву категорий".
Ключевые метрики (KPI)
Система автоматически агрегирует данные через API и предоставляет следующие показатели:
| Метрика | Описание | Зачем это разработчику? |
|---|---|---|
| DAU | Количество уникальный пользователей в день. | Планирование нагрузки на базу данных и API. |
| Sessions | Общее количество начатых сессий. | Базовая метрика вовлеченности. |
| Completion Rate | % завершенных квизов. | Барометр "усталости" пользователя от интерфейса. |
| Gift CTR | % кликов по результатам выдачи. | Главный индикатор здоровья RecSys-движка. |
Структура воронки (Funnel)
Мы отслеживаем путь пользователя по следующим этапам:
quiz_started— вход в воронку.quiz_completed— завершение анкеты, формирование профиля получателя.results_shown— отображение списка рекомендаций.gift_clicked— целевое действие (переход на сайт магазина).
Архитектура сбора данных
Система построена на базе PostHog:
- Backend Tracking: Мы логируем события на стороне сервера (создание сессий, выдача рекомендаций), чтобы иметь 100% точность данных без влияния блокировщиков рекламы.
- Async Processing: События отправляются в PostHog асинхронно, что не замедляет ответ API пользователю.
- Data Enrichment: В события добавляются метаданные (категория товара, ID сессии, параметры квиза) для глубокого анализа.
Технический мониторинг
В отличие от бизнес-аналитики, технический мониторинг (Prometheus + Grafana) следит за:
- Скоростью ответа Intelligence API (LLM).
- Количеством ошибок в парсерах.
- Объемом памяти, потребляемой векторной базой данных.
📖 Подробное описание всех эндпоинтов доступно в API Reference.
Tip
Для получения доступа к дашборду PostHog обратитесь к вашему ментору или запросите через Telegram бота.