Что собирается автоматически

После установки сниппета трекер сам отправляет пять событий: просмотры, время на странице с глубиной прокрутки, клики по внешним ссылкам, клики по контактам и отправки форм. Имена событий и параметров — как в GA4.

Автоматические события

page_view

Вместе с каждым событием уходят общие поля: page_location (адрес страницы), а у page_view ещё page_referrer, page_title (до 200 символов), screen_width (ширина окна — по ней определяется тип устройства) и content_group, если вы размечаете категории страниц.

Адрес очищается до отправки: из query остаются только utm_source, utm_medium, utm_campaign, utm_term, utm_content и имена рекламных click ID со значением 1 (подробнее — UTM-метки и click ID). Внешний referrer передаётся только как домен (https://t.me/), referrer своего сайта — как путь без query.

user_engagement

Считается только видимое время: пока вкладка в фоне, время не идёт. Событие уходит при скрытии вкладки, закрытии страницы и переходе внутри SPA; после отправки отсчёт начинается заново. Если вкладка не была видимой ни мгновения, событие не отправляется.

Мобильные браузеры иногда не дают отправить событие при закрытии вкладки, поэтому время на последней странице визита может не засчитаться.

click

Внешней считается ссылка http: или https: на другой хост. Поддомены — это другой хост: ссылка с example.com на shop.example.com даст click. Переходы по ссылкам внутри сайта отдельным событием не отправляются — их видно по page_view.

contact_click

Уходит только тип контакта. Номер телефона, адрес почты и сама ссылка не передаются.

form_submit

Трекер читает только атрибуты самой формы: id (или name, если id нет) и путь из action без query. Если action не задан, в form_destination будет путь текущей страницы. Значения полей не читаются никогда.

Событие срабатывает на стандартный submit элемента <form>. Если форма отправляется скриптом без <form> или через form.submit(), браузер это событие не создаёт — отправьте своё событие, например generate_lead.

Скоро. Событие file_download для ссылок на файлы (pdf, docx, xlsx, zip и т. п.). Сейчас трекер его не отправляет: клик по такой ссылке на другой домен придёт как click, по ссылке на свой домен — не придёт.

Скоро. Отключение отдельных автособытий в настройках сайта. Сейчас трекер отправляет все события из таблицы.

Что не собирается

• Значения полей форм, номера телефонов и адреса почты из ссылок.
• Query-параметры, кроме UTM, и значения click ID рекламных систем — значение заменяется на 1 до отправки.
• Часть адреса после # и путь внешнего referrer.
• Клики по кнопкам и внутренним ссылкам, движения мыши, нажатия клавиш.
• Cookie, localStorage, sessionStorage, IndexedDB: трекер ничего не хранит на устройстве посетителя и не создаёт идентификаторов в браузере.
• Данные для fingerprinting: из окружения браузера берётся только ширина окна. IP-адрес не хранится.

Полный перечень — на странице Какие данные собираются и в Данные и приватность. Нужно ли согласие посетителей, решает владелец сайта со своим юристом; см. Заявление о данных посетителей.

Когда события не отправляются

Трекер молчит, если страница открыта:

• на localhost, *.localhost, 127.*, по IPv6-адресу вроде [::1] или на домене *.local;
• из файла (file:);
• внутри <iframe> — например, в превью конструктора сайтов;
• в автоматизированном браузере (headless, navigator.webdriver).

В режиме отладки события и в этих случаях печатаются в консоль, но на сервер не уходят.