Сбор данных
Как Framix собирает данные аналитики — какие параметры отслеживаются, когда происходит запись, защита от дубликатов. Подключение Яндекс.Метрики, sitemap.xml и robots.txt для каждого сайта.
Сбор данных
Аналитика 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 |
| Язык | Язык браузера | navigator.language |
| Разрешение экрана | Физическое разрешение | screen.width × screen.height |
| Время визита | Точное время посещения | Текущее время клиента |
На стороне сервера
Эти данные определяются сервером автоматически по 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 минуты, считаются отдельными визитами
Подключение Яндекс.Метрики
Framix позволяет добавить счётчик Яндекс.Метрики, который будет автоматически инжектироваться в HTML каждой публичной страницы сайта.
Как настроить
- Откройте проект в личном кабинете
- Перейдите на вкладку «Настройки»
- В поле «Яндекс.Метрика» введите числовой идентификатор счётчика (например,
12345678) - Сохраните настройки
После сохранения счётчик автоматически появится в <head> всех страниц сайта при следующей загрузке. Инициализируется с параметрами: clickmap: true, trackLinks: true, accurateTrackBounce: true, webvisor: true.
Яндекс.Метрика — это ваш личный счётчик. Framix только вставляет его код — данные поступают прямо в ваш аккаунт на metrika.yandex.ru.
Google Analytics (через buildHtmlDocument)
Помимо Яндекс.Метрики, сервер поддерживает поле googleAnalytics в настройках проекта. Если оно заполнено (идентификатор вида G-XXXXXXXXXX), Framix вставит в HTML страниц стандартный тег gtag.js. Заполнить это поле в данный момент можно через API или административную панель — интерфейсное поле в настройках проекта для GA появится в одном из следующих обновлений.
Sitemap.xml и robots.txt
Каждый пользовательский сайт на Framix — на поддомене <slug>.framix.app или на своём домене — получает собственный sitemap.xml и robots.txt.
Sitemap.xml
Файл /sitemap.xml на вашем сайте содержит только ваши страницы:
- Опубликованные страницы сайта (
/,/aboutи т.д.) - Товары каталога:
/p/<slug>(если товар виден на этом сайте) - Услуги:
/s/<slug>(если услуга видна на этом сайте)
Все URL подставляются под хост вашего сайта. Фреймворковые страницы Framix (личный кабинет, документация и т.д.) в ваш sitemap не попадают.
Robots.txt
На пользовательском сайте robots.txt чистый и открыт к индексации:
User-agent: *
Allow: /
Disallow: /*?type=preview
Disallow: /*&type=preview
Sitemap: https://<ваш-домен>/sitemap.xml
Framix-специфичные Disallow (такие как /account/, /admin/) сюда не попадают — этих разделов на вашем сайте просто нет.
Точность геолокации
- Страна — высокая точность (>95%)
- Город — средняя точность, может быть неточным для мобильных операторов
- Координаты — приблизительные, указывают на центр города
При использовании VPN или прокси данные будут соответствовать расположению VPN-сервера.