Пиксель для сайтов (JS-скрипт)
Сайт-пиксель позволяет собирать детальную аналитику посетителей вашего сайта одной строкой кода. Работает совместно с трекинговыми ссылками TGIO: когда пользователь переходит по вашей ссылке, пиксель автоматически связывает его с источником перехода.
Установка
Добавьте одну строку в <head> вашего сайта:
<script src="https://tgio.app/widget/ВАШТРЕКЕР.js" async></script>Замените ВАШТРЕКЕР на код пикселя из раздела Пиксели в личном кабинете.
Что отслеживается
Сессия
- IP-адрес, User-Agent, Accept-Language
- Гео (страна, город)
- Устройство (тип, OS, браузер), обнаружение ботов
- UTM-метки (source, medium, campaign, content, term)
Взаимодействие (engagement)
- Список посещённых страниц (включая SPA-навигацию)
- Глубина прокрутки (максимальная, в %)
- Количество кликов на странице
- Длительность сессии (сек.)
Технические параметры браузера
- Разрешение экрана и viewport
- Device pixel ratio, color depth
- Поддержка touch
- Timezone, platform
- Тип подключения (WiFi, 4G, ...)
- doNotTrack, cookieEnabled
Связь с переходами по ссылкам
Когда посетитель переходит по трекинговой ссылке TGIO (tgio.app/g/...), бэкенд:
- Генерирует UUID (
_tgiouuid) - Устанавливает его как cookie и добавляет в URL (
?_tgiouuid=...)
Пиксель на сайте читает _tgiouuid из URL или cookie и привязывает сессию к конкретному клику по ссылке. Это позволяет видеть путь: ссылка → сессия на сайте.
SPA-поддержка
Скрипт перехватывает history.pushState и history.replaceState, автоматически трекая переходы в одностраничных приложениях без перезагрузки страницы.
События
| Тип | Когда отправляется |
|---|---|
pageview | При загрузке страницы и каждой SPA-навигации |
heartbeat | Каждые 30 секунд |
leave | При закрытии страницы (beforeunload / visibilitychange) |
API endpoint
POST /api/pixel-eventsВсе события отправляются через navigator.sendBeacon (надёжнее для leave-событий).
Ограничения по тарифам
| Тариф | Пиксели |
|---|---|
| Free | 1 |
| Starter | 3 |
| Pro | 10 |
| Business | Без ограничений |