Instalacja SDK

Chcesz zobaczyć panel, zanim cokolwiek zainstalujesz? Otwórz demo na żywo: sklep demonstracyjny z 30 dniami wymyślonych odwiedzających, bez logowania.

1. Skopiuj fragment kodu

W panelu otwórz stronę, a potem SDK → Instalacja. Skopiuj fragment kodu z tokenem strony i wklej go do <head> każdej podstrony:

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

Token identyfikuje stronę i nie jest tajny: SDK przyjmuje dane tylko z domen, które potwierdziłeś. Jeśli strona ma już starszy kod Pandus dla przycisku „Zgłoś barierę”, zostaw go: to ten sam fragment, który uruchomi SDK, gdy tylko plan je obejmie.

Instrukcje dla platform są w sekcji Platformy: WordPress i WooCommerce, Shopify, Google Tag Manager, Wix, Tilda, Webflow i każda inna strona.

Instalacja przez npm

W aplikacjach z bundlerem zamiast tagu script użyj otwartego pakietu npm. Dodaje ten sam loader raz, nic nie robi na serwerze i zachowuje zasady zgody.

npm install @pandus/sdk

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

init({ site: 'YOUR_SITE_TOKEN' });

Przekaż wybór odwiedzającego z własnego banera:

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

2. Potwierdź, że domena jest Twoja

SDK nic nie zbiera, dopóki domena nie zostanie potwierdzona. Inaczej każdy mógłby wstawić Twój token na cudzą stronę i odwrotnie. Wybierz sposób w SDK → Instalacja:

SDK sprawdza też Origin każdego żądania względem potwierdzonej domeny i subdomen z ustawień. Jeśli dowód później zniknie, strona działa jeszcze 30 dni, a potem przestaje zbierać dane.

3. Sprawdź, że działa

Otwórz stronę w oknie prywatnym, zaakceptuj baner zgody i odwiedź dwie, trzy podstrony. SDK → Instalacja pokaże „SDK działa”, gdy przyjdą pierwsze zdarzenia. Twoje wizyty się nie liczą, dopóki jesteś zalogowany do Pandus jako członek zespołu, więc testuj w oknie prywatnym.

Aby na żywo zobaczyć każde zdarzenie z jednego urządzenia, otwórz dowolną stronę z ?pandus_debug=1: zobacz Debugowanie.

Content Security Policy

Jeśli strona wysyła nagłówek CSP, zezwól na skrypt Pandus i usługę przyjmowania danych. Dokładne wartości dla Twojej strony są w SDK → Instalacja:

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

Aplikacje jednostronicowe

SDK śledzi zmiany strony przez History API (pushState, replaceState, przycisk wstecz), więc React, Vue, Next.js i podobne aplikacje dostają jeden page_view na trasę bez dodatkowego kodu.

Wydajność

• Loader ma ok. 5 KB gzip, ładuje się z async i nigdy nie blokuje renderowania.
• Moduły ładują się leniwie: tylko włączone, tylko po zgodzie, a nagrania tylko dla sesji z próbki.
• Zdarzenia idą paczkami przez sendBeacon lub fetch z keepalive, w czasie bezczynności.
• Nasze testy end-to-end sprawdzają, że nasz kod nie powoduje long task powyżej 50 ms, i mierzą wpływ na LCP, INP i CLS.

Usunięcie SDK

Usuń fragment kodu albo wyłącz SDK dla strony w SDK → Ustawienia. Zapisane dane są usuwane po końcu okresu przechowywania albo od razu na tej samej stronie ustawień.