Что Web SDK собирает сам
Краткое содержание
Статья помогает понять, какие данные автоматически передаются в МТС Аналитику после установки Web SDK. Скрипт собирает технические параметры визита: cookie, параметры страницы, сессии, браузер и устройство. Персональные данные и действия пользователя (клики, поля форм) не собираются автоматически, пока вы не передадите их явно.
Что передаётся в каждом событии
В статье описано, какие данные входят в каждое стандартное событие, что позволяет настроить корректный сбор информации. В каждое событие попадают:
- Страница: полный URL с параметрами, заголовок документа и реферер.
- Сессия: идентификатор, порядковые номера сессии/события и случайное значение для отсева дубликатов.
- Окружение: разрешение экрана, язык браузера, признак iframe и время события с часовым поясом.
- Идентификаторы: анонимный ID посетителя, ID потока и ID пользователя (только если передан через
setUserId). - Источник перехода: UTM-метки для атрибуции рекламы.
- Технические события: фиксация «не отказ» при времени на странице более 15 секунд.
- Эксперименты: номера вариантов сплит-теста (при подключенном инструменте экспериментов).
IP-адрес скрипт не собирает.
Дополнительные возможности
Информация помогает активировать дополнительные плагины Web SDK для расширенного сбора данных. Все плагины отключены по умолчанию и включаются через параметры кода установки или МТС Тег.
В таблице описаны возможности, данные, которые они собирают, и способы их активации:
- Метрики производительности: собирает данные Navigation Timing (DNS, connect, отрисовка DOM).
- JS-ошибки: собирает текст ошибки, файл, строку и стектрейс.
- Междоменное связывание: добавляет технический параметр в ссылки для корректного отслеживания переходов между доменами.
- dataLayer и e-commerce: собирает данные из dataLayer, включая события GA4/UA.
Клики и пользовательские события
Статья объясняет, как настроить сбор кликов, так как автоматический сбор отсутствует. Чтобы клик попал в аналитику, его необходимо разметить одним из способов:
- Использовать триггер в МТС Теге по элементу или ссылке.
- Сделать собственный вызов на стороне сайта.
Состав передаваемых данных определяется настройками пользователя.
Чего Web SDK не делает
Раздел помогает избежать ошибок в ожиданиях от функционала SDK. Web SDK:
- Не записывает сессии и не делает снимков экрана (session replay отсутствует).
- Не считывает текст страницы и разметку автоматически; значения передаются согласно настройкам в МТС Теге.
- Не собирает значения полей форм и введённые символы (Page ping фиксирует только факт нажатия).
- Не читает cookie и localStorage сайта, работая только со своими ключами
ma_*и признаком панели проверки. - Не собирает персональные данные (телефон, email, ФИО) без явной передачи их сайтом через
setUserId, параметры события, dataLayer или URL.
Домены, к которым обращается Web SDK
Информация помогает понять сетевую активность скрипта. В таблице указаны домены и их назначение:
static.a.mts.ru: используется всегда для загрузки скрипта и панели проверки разметки при отладке.api.a.mts.ru: используется всегда для отправки событий (POST, JSON, батчами).
См. также
В статье приведены ссылки на дополнительные материалы по настройке куки, параметрам событий, командам отправки и подходу к разметке.
После установки Web SDK скрипт передаёт в МТС Аналитику технические данные о визите: cookie на домене сайта, параметры страницы, сессии, браузера и устройства. Персональные данные и действия пользователя — клики, поля форм, разметка — не собираются, пока вы сами их не передадите.
Полный список параметров для отчётов — в статье Параметры событий Web. Сроки хранения cookie — в статье Куки, устанавливаемые МТС Аналитикой.
Что передаётся в каждом событии
В стандартной конфигурации в каждое событие попадают:
Страница
- полный URL — с query-параметрами и якорем;
document.title;document.referrer.
Сессия
- id сессии;
- порядковый номер сессии и события;
- случайное значение для отсева повторно доставленных событий.
Окружение
- разрешение экрана и размер окна;
- язык браузера и кодировка документа;
- признак iframe;
- время события по часам клиента с часовым поясом.
Идентификаторы
- анонимный идентификатор посетителя;
- id потока (
flow_id); - идентификатор пользователя (
user_id) — только если сайт передаёт его вызовом setUserId.
Источник перехода
- UTM-метки фиксируются на старте сессии и используются для атрибуции рекламы.
Технические события — в стандартной конфигурации:
- «не отказ» — если посетитель провёл на странице больше 15 секунд
Эксперименты — номера вариантов сплит-теста передаются только если на сайте подключён инструмент экспериментов. Это отдельный скрипт: он определяет вариант на странице, Web SDK за вариантами в сеть не обращается.
IP-адрес скрипт не собирает.
Дополнительные возможности
Web SDK поставляется одним файлом со всем набором плагинов. Отдельных «облегчённых» версий нет.
Ни один из перечисленных ниже плагинов по умолчанию не включён — каждый активируется параметром в коде установки или настройкой в МТС Теге.
| Возможность | Что собирает | Как включить |
|---|---|---|
| Метрики производительности | Navigation Timing: DNS, connect, request, отрисовка DOM, load | Конфигурация Web SDK или МТ С Тег |
| JS-ошибки | Текст, файл, строка, колонка, стектрейс | Конфигурация Web SDK или МТС Тег |
| Междоменное связывание | Технический параметр в ссылках на указанные домены, чтобы переход между доменами одного сайта не считался новым визитом | Междоменное отслеживание |
| dataLayer и e-commerce | Данные, которые сайт добавляет в dataLayer, включая события GA4/UA | dataLayer в коде установки или веб-разметка |
Клики и пользовательские события
Автоматического сбора кликов нет: скрипт не подписывается на клики по странице.
Клик попадёт в аналитику только если вы его разметите:
- триггером в МТС Теге — по элементу или ссылке;
- собственным вызовом на стороне сайта.
Состав передаваемых данных определяет ваша настройка.
Чего Web SDK не делает
- Не записывает сессии, не делает снимков экрана и DOM — session replay не реализован. Неиспользуемый код служебной библиотеки в файле не вызывается и удаляется из сборки.
- Не считывает текст страницы и разметку. Триггеры и переменные в МТС Теге (текст элемента, класс, id, адрес ссылки) передают значения согласно вашей настройке, а не автоматически.
- Не собирает значения полей форм и введённые символы. Page ping передаёт только факт нажатия клавиши — без самой клавиши.
- Не читает cookie и localStorage сайта. Работает только со своими ключами
ma_*и с признаком включённой панели проверки разметки (mtsa-events) и не читает ключи сайта. - Не собирает персональные данные — телефон, email, ФИО, id клиента попадают в систему только если их передаёт сайт через
setUserId, параметры события, dataLayer или URL.
Домены, к которым обращается Web SDK
| Домен | Назначение | Когда используется |
|---|---|---|
static.a.mts.ru | Загрузка скрипта и, при отладке, панели проверки разметки | Всегда |
api.a.mts.ru | Отправка событий (POST, JSON, батчами) | Всегда |