Встановлення 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 → Налаштування. Збережені дані видаляються наприкінці строку зберігання або одразу на тій самій сторінці налаштувань.