01Начало работы
Установка
Одна строка в <head> — и Gauss считает просмотры, визиты, время на странице и источники. Инструкция для HTML, CMS, конструкторов и SPA.
Трекер Gauss подключается одной строкой. После установки он сам отправляет просмотры страниц, время на странице, клики по внешним ссылкам и контактам, отправки форм — без cookie и без хранилищ браузера.
Где взять Site ID
Site ID — короткий идентификатор сайта: от 8 до 16 символов, только строчные латинские буквы и цифры. Его выдаёт кабинет, когда вы добавляете сайт, вместе с готовым сниппетом.
Кабинет сейчас в закрытой бете. Чтобы получить доступ и Site ID, оставьте заявку на странице заявка в бету.
Сниппет
Вставьте строку в <head> каждой страницы сайта и замените YOUR_SITE_ID на свой Site ID:
<script defer data-site="YOUR_SITE_ID" src="https://collect.gausslab.io/js/gauss.js"></script>Атрибут defer значит, что скрипт загружается параллельно со страницей и запускается после разбора HTML — отрисовку он не блокирует.
| Атрибут | Обязателен | Что делает |
|---|---|---|
data-site | да | Site ID. Если формат неверный, трекер не запускается |
data-debug | нет | печатает каждое событие в консоль браузера, см. Проверка установки |
data-api | нет | другой адрес приёма событий вместо https://collect.gausslab.io/api/event |
Скоро. Работа через собственный домен (first-party proxy), чтобы скрипт и приём событий шли с адреса вида
stats.ваш-сайт.ru.
Подключайте сниппет один раз: два тега на странице дадут два просмотра на каждый переход.
Конструкторы и CMS
Принцип везде один: сниппет должен попасть в <head> всех страниц. Названия пунктов меню у платформ меняются, поэтому ниже — где искать, а не точный путь.
- WordPress — вставьте строку в шапку темы (файл
header.php, перед</head>) или через любой плагин для вставки кода в header. Код в файле темы может пропасть при обновлении темы — для этого случая удобнее плагин или дочерняя тема. - Shopify — в коде темы, в файле
theme.liquid, перед</head>. - Tilda, Webflow, Wix — в настройках сайта есть раздел для пользовательского кода в
<head>. Вставьте сниппет туда и опубликуйте сайт заново.
В режиме редактирования и предпросмотра внутри конструктора события не отправляются: такие превью открываются во <iframe>, а трекер в iframe не работает. Проверяйте на опубликованном сайте.
SPA: React, Vue, Next.js и другие
Для одностраничных приложений ничего дополнительно настраивать не нужно. Трекер следит за History API (pushState, replaceState, popstate) и отправляет page_view при каждой смене адреса. Если адрес после очистки не изменился, повторного просмотра не будет.
Достаточно один раз добавить сниппет в общий шаблон: index.html для Vite и Create React App, корневой layout для Next.js, app.html или его аналог в других фреймворках.
Скоро. Hash-роутинг (
/#/catalog). Сейчас часть адреса после#отбрасывается, и переходы, которые меняют только hash, не считаются отдельными просмотрами.
Content Security Policy
Если на сайте настроен заголовок Content-Security-Policy, разрешите домен Gauss для загрузки скрипта и для отправки событий:
script-src 'self' https://collect.gausslab.io;
connect-src 'self' https://collect.gausslab.io;script-src нужен для загрузки gauss.js, connect-src — для запросов с событиями. Если вы добавляете встроенный скрипт-заглушку для своих событий, ему нужен nonce или хеш в script-src, как любому inline-скрипту. При data-api укажите в connect-src этот адрес.
Локальная разработка
С localhost, 127.*, адресов *.local, файлов, открытых через file:, и из автоматизированных браузеров события не отправляются. Ваши тесты не попадут в статистику, но и проверить установку на локальной машине по отчётам не получится. Как увидеть события до публикации — в разделе Проверка установки.
Что дальше
- Что собирается автоматически — какие события трекер отправляет сам.
- Проверка установки — как убедиться, что события уходят.
- Свои события — заявки, регистрации, клики по кнопкам.
- Какие данные собираются — что трекер передаёт и чего не передаёт. Нужно ли согласие посетителей, решает владелец сайта со своим юристом; см. Заявление о данных посетителей и Данные и приватность.