ДокументацияБыстрый старт

Подключение за пару минут

Один JS-сниппет, и Trafvex начинает анализировать трафик. CMS-плагины не нужны.

1. Установка трекера

Вставьте в <head> вашего сайта, как можно выше. Работает на WordPress, OpenCart, Tilda, Bitrix и чистом HTML.

<script src="http://localhost:4001/tracker.js" data-site-id="ВАШ_SITE_ID" async></script>

SITE_ID берётся во вкладке «Установка» вашего сайта в кабинете.

2. Проверка

Откройте сайт в браузере и загляните в кабинет → «Живой трафик»: ваша сессия появится в течение нескольких секунд. Трекер защищён try/catch и никогда не ломает страницу или оформление заказа.

3. Серверная блокировка (опционально)

Чтобы блокировать до отрисовки страницы, вызывайте edge-эндпоинт из бэкенда и действуйте по полю action. Трекер ставит cookie tg_vid.

POST http://localhost:4001/decision { "siteId": "...", "visitorId": "<tg_vid>" } → { action, riskScore, category, reasons[], challenge?, ttl }

Всегда короткий таймаут и fail-open: защита никогда не должна класть сайт. При CHALLENGE покажите капчу, при BLOCK верните 403.

4. REST API

Управляйте сайтами, правилами, списками и читайте аналитику через /api/v1 (Bearer JWT). Ключи во вкладке «Аккаунт».

GET /api/v1/sites/:id/analytics/summary GET /api/v1/sites/:id/blocked-ips GET /api/v1/sites/:id/exports/:platform # IP-исключения для рекламы

5. Приватность

Собираем только поведенческие и технические сигналы, никогда содержимое форм или нажатые клавиши. Доступен режим hash-only-IP (сырой IP не сохраняется) и настраиваемый срок хранения.