03Начало работы
Проверка установки
Как убедиться, что трекер Gauss работает — режим отладки в консоли, запросы во вкладке Network и частые причины, по которым событий не видно.
Проверить установку можно за пару минут прямо в браузере: включить режим отладки и посмотреть, какие события печатает трекер и какие запросы уходят на сервер.
Режим отладки
Есть два способа включить отладку:
- добавьте
?gauss_debug=1к адресу страницы, напримерhttps://example.com/?gauss_debug=1; - или добавьте атрибут
data-debugв сниппет:
<script defer data-debug data-site="YOUR_SITE_ID" src="https://collect.gausslab.io/js/gauss.js"></script>Откройте консоль браузера (DevTools → Console). Трекер печатает каждое событие перед отправкой с префиксом [gauss]: имя события и объект, который уходит на сервер.
[gauss] page_view {v: 1, site: "k3f9x2ab", name: "page_view", page_location: "https://example.com/", …}
[gauss] user_engagement {v: 1, site: "k3f9x2ab", name: "user_engagement", params: {engagement_time_msec: 48200, scroll_depth_pct: 75}, …}Флаг ?gauss_debug=1 ничего не сохраняет на устройстве: трекер проверяет адрес при загрузке страницы, поэтому отладка работает, пока страница открыта с этим параметром. Атрибут data-debug не забудьте убрать после проверки.
На localhost и в других исключённых окружениях режим отладки тоже печатает события, но не отправляет их. Так можно проверить разметку своих событий до публикации.
Предупреждения [gauss] dropped … печатаются всегда, даже без режима отладки: так трекер сообщает, что отбросил событие с неверным именем или лишний параметр.
Вкладка Network
- Откройте DevTools → Network и обновите страницу.
- В фильтре введите
api/event. - Найдите запрос
POST https://collect.gausslab.io/api/event.
Каждое событие — отдельный запрос. Тело — JSON, тип — text/plain, поэтому браузер не делает предварительный CORS-запрос. Трекер отправляет события через navigator.sendBeacon, а если он недоступен — через fetch с keepalive. В Chrome запросы sendBeacon отображаются с типом ping.
Чтобы увидеть user_engagement, переключитесь на другую вкладку и вернитесь: событие уходит при скрытии страницы. Включите в DevTools опцию Preserve log, иначе запросы при переходе на другую страницу пропадут из списка.
Почему событий не видно
| Причина | Что проверить |
|---|---|
| Сайт открыт локально | localhost, 127.*, *.local, file: не отправляют события. Проверяйте на опубликованном сайте или через режим отладки |
| Превью конструктора | в редакторе и предпросмотре сайт открыт в <iframe> — события не уходят. Откройте опубликованную версию |
| Блокировщик рекламы или трекеров | отключите расширения или откройте страницу в профиле браузера без них |
| Content Security Policy | в консоли будет ошибка о нарушении CSP. Добавьте https://collect.gausslab.io в script-src и connect-src, см. Установка |
| Неверный Site ID | при неверном формате трекер не запускается и ничего не пишет в консоль. Проверка ниже |
| Сниппет не на всех страницах | проверьте исходный код страницы: тег должен быть в <head> |
| Сниппет подключён дважды | каждый переход даёт два page_view — оставьте один тег |
Проверка Site ID — выполните в консоли страницы:
const id = document.querySelector('script[data-site]')?.dataset.site;
console.log(id, /^[a-z0-9]{8,16}$/.test(id || ''));Если выводится false, в data-site лишний символ, пробел или заглавная буква: Site ID состоит из 8–16 строчных латинских букв и цифр. Если true, но событий нет, сравните значение с Site ID в кабинете.
Ещё одна проверка: typeof gauss в консоли после загрузки страницы. Если трекер запустился, это "function", и у функции нет свойства q. Если gauss.q — массив, работает только заглушка для ранних вызовов, а сам трекер не стартовал: скрипт заблокирован или Site ID неверный.
Проверка в кабинете
Кабинет сейчас в закрытой бете — доступ по заявке на заявка в бету.
- Экран ожидания первого события. После добавления сайта кабинет ждёт первое событие и показывает статус установки. Статус меняется не позже чем через 10 секунд после первого события; если данных нет 24 часа, кабинет покажет и это.
- Живая лента событий. Последние события сайта появляются в ленте не позже чем через 5 секунд после отправки. Каждое событие раскрывается в JSON — так, как оно сохранено после обработки. В ленте видны и отклонённые события с причиной. Ленту видят участники с ролями owner и admin.