Instalarea SDK-ului

Vrei să vezi panoul înainte să instalezi ceva? Deschide demo-ul live: un magazin demo cu 30 de zile de vizitatori inventați, fără autentificare.

1. Copiază fragmentul

În panou deschide site-ul, apoi SDK → Instalare. Copiază fragmentul cu tokenul site-ului și pune-l în <head> pe fiecare pagină:

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

Tokenul identifică site-ul și nu este secret: SDK-ul acceptă date doar de la domeniile confirmate. Dacă site-ul are deja codul Pandus mai vechi pentru butonul „Raportează o barieră”, păstrează-l: este același fragment și pornește SDK-ul de îndată ce planul îl include.

Ghidurile pentru platforme sunt la Platforme: WordPress și WooCommerce, Shopify, Google Tag Manager, Wix, Tilda, Webflow și orice alt site.

Instalare cu npm

Pentru aplicațiile cu bundler, folosește pachetul npm open-source în locul tagului script. Adaugă același încărcător o singură dată, nu face nimic pe server și respectă regulile de consimțământ.

npm install @pandus/sdk

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

init({ site: 'YOUR_SITE_TOKEN' });

Transmite alegerea vizitatorului din propriul banner:

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

2. Confirmă că domeniul este al tău

SDK-ul nu colectează nimic până când domeniul nu este confirmat. Altfel oricine ar putea pune tokenul tău pe alt site sau invers. Alege o metodă în SDK → Instalare:

SDK-ul verifică și Origin pentru fiecare cerere față de domeniul confirmat și subdomeniile din setări. Dacă dovada dispare mai târziu, site-ul mai funcționează 30 de zile, apoi nu mai colectează.

3. Verifică funcționarea

Deschide site-ul într-o fereastră privată, acceptă bannerul de consimțământ și vizitează două-trei pagini. SDK → Instalare arată „SDK-ul funcționează” când sosesc primele evenimente. Vizitele tale nu se numără cât timp ești autentificat în Pandus ca membru al echipei, așa că testează în fereastră privată.

Pentru a vedea live fiecare eveniment de pe un dispozitiv, deschide orice pagină cu ?pandus_debug=1: vezi Depanare.

Content Security Policy

Dacă site-ul trimite un antet CSP, permite scriptul Pandus și serviciul de preluare a datelor. Valorile exacte pentru site-ul tău sunt în SDK → Instalare:

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

Aplicații cu o singură pagină

SDK-ul urmărește schimbările de pagină prin History API (pushState, replaceState, butonul înapoi), așa că React, Vue, Next.js și aplicații similare primesc un page_view pe rută fără cod suplimentar.

Performanță

• Încărcătorul are circa 5 KB gzip, se încarcă cu async și nu blochează niciodată randarea.
• Modulele se încarcă leneș: doar cele activate, doar după consimțământ, iar înregistrările doar pentru sesiunile din eșantion.
• Evenimentele pleacă în loturi prin sendBeacon sau fetch cu keepalive, în timpul inactiv.
• Testele noastre end-to-end verifică faptul că codul nostru nu produce long task peste 50 ms și măsoară efectul asupra LCP, INP și CLS.

Eliminarea SDK-ului

Șterge fragmentul sau dezactivează SDK-ul pentru site în SDK → Setări. Datele stocate se șterg la sfârșitul perioadei de păstrare sau imediat, din aceeași pagină de setări.