Сбор данных
Как Framix собирает данные аналитики — какие параметры отслеживаются, когда происходит запись, защита от дубликатов
Сбор данных
Аналитика Framix автоматически фиксирует каждое посещение ваших опубликованных страниц. Никакого дополнительного кода или скриптов подключать не нужно.
Когда происходит запись
Запись создаётся при каждом открытии публичной страницы вашего сайта. Данные отправляются автоматически при загрузке страницы.
Условия записи
Визит записывается, если:
- Страница открыта в обычном режиме (не в режиме предпросмотра редактора)
- Аналитика включена для проекта (по умолчанию — включена)
Визит не записывается, если:
- Страница открыта в режиме предпросмотра (
?type=preview) - Аналитика отключена в настройках проекта
- Тот же IP-адрес уже был зафиксирован менее 1 минуты назад (защита от дубликатов)
Какие данные собираются
При каждом визите записываются следующие параметры:
На стороне браузера
Эти данные определяются в браузере посетителя и передаются на сервер:
| Параметр | Описание | Как определяется |
|---|---|---|
| Путь (path) | URL страницы | window.location.pathname |
| User Agent | Строка идентификации браузера | navigator.userAgent |
| Источник (source) | Откуда пришёл посетитель | document.referrer |
| Устройство | Тип устройства | Анализ User Agent: mobile, tablet, desktop |
| ОС | Операционная система | Анализ User Agent: Windows, macOS, Linux, Android, iOS |
| Браузер | Название браузера | Анализ User Agent: Chrome, Safari, Firefox, Edge |
| Время визита | Точное время посещения | Текущее время клиента |
На стороне сервера
Эти данные определяются сервером автоматически по IP-адресу посетителя:
| Параметр | Описание |
|---|---|
| IP-адрес | Публичный IP-адрес посетителя |
| Страна | Код страны (RU, US, DE и т.д.) |
| Регион | Область или штат |
| Город | Название города |
| Часовой пояс | Часовой пояс в формате IANA (Europe/Moscow) |
| Координаты | Приблизительные широта и долгота |
Геолокация определяется с помощью базы данных IP-адресов (библиотека geoip-lite).
Определение устройства, ОС и браузера
Framix анализирует строку User Agent для определения параметров устройства:
Устройство
- Содержит
mobile→ mobile - Содержит
tablet→ tablet - Всё остальное → desktop
Операционная система
- Содержит
Win→ Windows - Содержит
Mac→ macOS - Содержит
Linux→ Linux - Содержит
Android→ Android - Содержит
like Mac(iOS) → iOS - Ничего не подошло → unknown
Браузер
- Содержит
Chrome→ Chrome - Содержит
Safari→ Safari - Содержит
Firefox→ Firefox - Содержит
Edge→ Edge - Ничего не подошло → unknown
Защита от дубликатов
Чтобы случайное обновление страницы не искажало статистику, Framix проверяет: если с того же IP-адреса уже была запись менее 1 минуты назад — новая запись не создаётся.
Это значит:
- Быстрое обновление страницы (F5) не считается новым визитом
- Если посетитель вернётся через 2 минуты — это будет новый визит
- Разные страницы одного сайта, открытые одним посетителем с интервалом более 1 минуты, считаются отдельными визитами
Точность геолокации
- Страна — высокая точность (>95%)
- Город — средняя точность, может быть неточным для мобильных операторов
- Координаты — приблизительные, указывают на центр города
При использовании VPN или прокси данные будут соответствовать расположению VPN-сервера.
Хранение данных
Все данные аналитики хранятся в базе данных проекта. При удалении проекта все данные статистики удаляются вместе с ним (каскадное удаление).
Данные индексируются по:
- ID проекта — для быстрой выборки по проекту
- ID страницы — для выборки по конкретной странице
- Времени визита — для быстрой фильтрации по диапазону дат