Instalace SDK

Chcete panel vidět dřív, než cokoli nainstalujete? Otevřete živé demo: ukázkový obchod s 30 dny vymyšlených návštěvníků, bez přihlášení.

1. Zkopírujte úryvek

V panelu otevřete web a pak SDK → Instalace. Zkopírujte úryvek s tokenem webu a vložte ho do <head> každé stránky:

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

Token označuje web a není tajný: SDK přijímá data jen z domén, které jste potvrdili. Pokud web už má starší kód Pandus pro tlačítko „Nahlásit bariéru“, nechte ho: je to tentýž úryvek a spustí SDK, jakmile ho tarif bude obsahovat.

Návody pro platformy jsou v části Platformy: WordPress a WooCommerce, Shopify, Google Tag Manager, Wix, Tilda, Webflow a jakýkoli jiný web.

Instalace přes npm

V aplikacích s bundlerem použijte místo tagu script open-source balíček npm. Přidá stejný zavaděč jednou, na serveru nic nedělá a dodržuje pravidla souhlasu.

npm install @pandus/sdk

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

init({ site: 'YOUR_SITE_TOKEN' });

Předejte volbu návštěvníka z vlastní lišty:

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

2. Potvrďte, že doména je vaše

SDK nic nesbírá, dokud doména není potvrzená. Jinak by kdokoli mohl dát váš token na cizí web a naopak. Vyberte způsob v SDK → Instalace:

SDK také porovnává Origin každého požadavku s potvrzenou doménou a subdoménami z nastavení. Když důkaz později zmizí, web běží ještě 30 dní a pak přestane sbírat.

3. Ověřte, že běží

Otevřete web v anonymním okně, přijměte lištu souhlasu a navštivte dvě tři stránky. SDK → Instalace ukáže „SDK funguje“, jakmile dorazí první události. Vaše vlastní návštěvy se nepočítají, dokud jste přihlášeni do Pandus jako člen týmu, proto testujte v anonymním okně.

Pro živý pohled na každou událost z jednoho zařízení otevřete libovolnou stránku s ?pandus_debug=1: viz Ladění.

Content Security Policy

Pokud web posílá hlavičku CSP, povolte skript Pandus a službu příjmu dat. Přesné hodnoty pro váš web jsou v SDK → Instalace:

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

Jednostránkové aplikace

SDK sleduje změny stránky přes History API (pushState, replaceState, tlačítko zpět), takže React, Vue, Next.js a podobné aplikace dostanou jeden page_view na trasu bez dalšího kódu.

Výkon

• Zavaděč má asi 5 KB gzip, načítá se s async a nikdy neblokuje vykreslení.
• Moduly se načítají líně: jen zapnuté, jen po souhlasu a nahrávky jen pro relace ze vzorku.
• Události odcházejí v dávkách přes sendBeacon nebo fetch s keepalive v době nečinnosti.
• Naše end-to-end testy ověřují, že náš kód nezpůsobí long task delší než 50 ms, a měří dopad na LCP, INP a CLS.

Odebrání SDK

Smažte úryvek nebo SDK pro web vypněte v SDK → Nastavení. Uložená data se smažou na konci doby uchování nebo hned na téže stránce nastavení.