SDK installieren

Möchten Sie das Dashboard sehen, bevor Sie etwas installieren? Öffnen Sie die Live-Demo: ein Demo-Shop mit 30 Tagen erfundener Besucher, ohne Anmeldung.

1. Snippet kopieren

Öffnen Sie im Dashboard Ihre Website und dann SDK → Installation. Kopieren Sie das Snippet mit dem Token Ihrer Website und fügen Sie es in den <head> jeder Seite ein:

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

Das Token kennzeichnet die Website und ist kein Geheimnis: Das SDK nimmt Daten nur von den Domains an, die Sie bestätigt haben. Hat die Website schon den älteren Pandus-Einbettungscode für den Button „Barriere melden“, lassen Sie ihn: Es ist dasselbe Snippet, und es startet das SDK, sobald Ihr Tarif es enthält.

Anleitungen für Plattformen finden Sie unter Plattformen: WordPress und WooCommerce, Shopify, Google Tag Manager, Wix, Tilda, Webflow und jede andere Website.

Installation mit npm

Für Apps mit Bundler nutzen Sie statt des Script-Tags das Open-Source-npm-Paket. Es fügt denselben Loader einmal ein, tut auf dem Server nichts und hält die Einwilligungsregeln ein.

npm install @pandus/sdk

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

init({ site: 'YOUR_SITE_TOKEN' });

Übergeben Sie die Wahl des Besuchers aus Ihrem eigenen Banner:

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

2. Bestätigen, dass die Domain Ihnen gehört

Das SDK erfasst nichts, bevor die Domain bestätigt ist. Sonst könnte jeder Ihr Token auf eine fremde Website setzen oder umgekehrt. Wählen Sie unter SDK → Installation einen Weg:

Das SDK prüft außerdem den Origin jeder Anfrage gegen die bestätigte Domain und die Subdomains aus den Einstellungen. Verschwindet der Nachweis später, läuft die Website noch 30 Tage weiter und erfasst dann nichts mehr.

3. Prüfen, dass es läuft

Öffnen Sie Ihre Website in einem privaten Fenster, akzeptieren Sie das Einwilligungsbanner und besuchen Sie zwei, drei Seiten. SDK → Installation zeigt „SDK funktioniert“, sobald die ersten Ereignisse ankommen. Ihre eigenen Besuche zählen nicht, solange Sie als Teammitglied bei Pandus angemeldet sind – testen Sie daher im privaten Fenster.

Für einen Live-Blick auf jedes Ereignis eines Geräts öffnen Sie eine beliebige Seite mit ?pandus_debug=1: siehe Debugging.

Content Security Policy

Sendet Ihre Website einen CSP-Header, erlauben Sie das Pandus-Skript und den Annahmedienst. Die genauen Werte Ihrer Website stehen unter SDK → Installation:

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

Single-Page-Apps

Das SDK folgt Seitenwechseln über die History API (pushState, replaceState, Zurück-Button). React, Vue, Next.js und ähnliche Apps erhalten ohne zusätzlichen Code einen page_view pro Route.

Performance

• Der Loader hat etwa 5 KB gzip, wird mit async geladen und blockiert nie das Rendern.
• Module laden verzögert: nur eingeschaltete, nur nach Einwilligung, Aufzeichnungen nur für Sitzungen der Stichprobe.
• Ereignisse gehen gebündelt mit sendBeacon oder fetch mit keepalive in Leerlaufzeiten raus.
• Unsere End-to-End-Tests prüfen, dass unser Code keine Long Task über 50 ms verursacht, und messen die Wirkung auf LCP, INP und CLS.

SDK entfernen

Löschen Sie das Snippet oder schalten Sie das SDK für die Website unter SDK → Einstellungen ab. Gespeicherte Daten werden am Ende ihrer Aufbewahrungsfrist gelöscht oder sofort auf derselben Einstellungsseite.