Установка SDK

Хотите увидеть кабинет, ничего не устанавливая? Откройте живое демо: демо-магазин с 30 днями выдуманных посетителей, без входа.

1. Скопируйте сниппет

В кабинете откройте сайт, затем SDK → Установка. Скопируйте сниппет с токеном сайта и вставьте его в <head> каждой страницы:

<script async src="https://pandus.online/embed.js" data-site="YOUR_SITE_TOKEN"></script>

Токен обозначает сайт и не является секретом: SDK принимает данные только с доменов, которые вы подтвердили. Если на сайте уже есть старый код Pandus для кнопки «Сообщить о барьере», оставьте его: это тот же сниппет, и он запустит SDK, как только ваш тариф его включит.

Инструкции для платформ — в разделе Платформы: WordPress и WooCommerce, Shopify, Google Tag Manager, Wix, Tilda, Webflow и любой другой сайт.

Установка через npm

Для приложений со сборщиком вместо тега script используйте открытый npm-пакет. Он добавляет тот же загрузчик один раз, ничего не делает на сервере и соблюдает правила согласия.

npm install @pandus/sdk

import { init, consent } from '@pandus/sdk';

init({ site: 'YOUR_SITE_TOKEN' });

Передайте выбор посетителя из своего баннера:

consent({ analytics: true, recordings: false });

2. Подтвердите, что домен ваш

SDK ничего не собирает, пока домен не подтверждён. Иначе кто угодно мог бы поставить ваш токен на чужой сайт или наоборот. Выберите способ в SDK → Установка:

SDK также сверяет Origin каждого запроса с подтверждённым доменом и поддоменами из настроек. Если доказательство потом пропадёт, сайт работает ещё 30 дней, а затем перестаёт собирать данные.

3. Проверьте, что работает

Откройте сайт в приватном окне, примите баннер согласия и посетите две-три страницы. SDK → Установка покажет «SDK работает», как только придут первые события. Ваши собственные визиты не считаются, пока вы вошли в Pandus как член команды, поэтому проверяйте в приватном окне.

Чтобы вживую видеть каждое событие с одного устройства, откройте любую страницу с ?pandus_debug=1: см. Отладка.

Content Security Policy

Если сайт отправляет заголовок CSP, разрешите скрипт Pandus и сервис приёма данных. Точные значения для вашего сайта — в SDK → Установка:

script-src  https://pandus.online
connect-src https://pandus.online https://e.pandus.online

Одностраничные приложения

SDK отслеживает смену страниц через History API (pushState, replaceState, кнопку «назад»), поэтому React, Vue, Next.js и похожие приложения получают один page_view на маршрут без дополнительного кода.

Производительность

• Загрузчик весит около 5 КБ gzip, грузится с async и никогда не блокирует отрисовку.
• Модули грузятся лениво: только включённые, только после согласия, а записи — только для сессий из выборки.
• События уходят пачками через sendBeacon или fetch с keepalive во время простоя.
• Наши сквозные тесты проверяют, что наш код не создаёт long task дольше 50 мс, и измеряют влияние на LCP, INP и CLS.

Удаление SDK

Удалите сниппет или выключите SDK для сайта в SDK → Настройки. Сохранённые данные удаляются в конце срока хранения или сразу на той же странице настроек.