Fingerprinting instellen

Stel cside fingerprinting in door het browserscript vroeg te laden, telemetry te verzamelen met sendClientTelemetry en het geretourneerde sessietoken naar uw backend te sturen.

Kies een implementatieoptie

Methode	Best voor	Productieadvies
Cloudflare Workers	Sites die al via Cloudflare lopen	Goed voor edge-injectie en uitrol op beperkte routes
Directe scriptinjectie	De meeste productiewebsites	Aanbevolen wanneer u HTML of app shell beheert
NPM-pakket	Framework-apps met ondersteunde pakketten	Aanbevolen wanneer het pakket het script vroeg plaatst
Google Tag Manager	Snelle validatie zonder codewijzigingen	Alleen gebruiken voor testen wanneer scriptvolgorde telt

Advies voor klantdomein

Gebruik de DNS-setup om waar mogelijk uw eigen domein te gebruiken. cside biedt dit aan om privacyzorgen rond domeinen van derden te vermijden, het script first-party te laten lijken voor de browser en te voorkomen dat browser-adblockers of client-side blokkering het script verstoren of de nauwkeurigheid van de detecties beïnvloeden.

Als cside een specifieke script-URL levert, gebruik dan exact die URL in elke installatiemethode. De voorbeelden hieronder gebruiken placeholders.

Het script via uw eigen domein serveren

Met deze optie serveert u het fingerprinting-script vanaf een subdomein dat u beheert, zoals fingerprint.example.com. Dit is bedoeld voor productieaccounts die first-party scriptlevering en strakkere CSP-controle willen.

Account-enabled setup

Aangepaste fingerprintdomeinen vereisen dat cside een doelhostname voor uw account provisiont. Neem contact op met cside voordat u DNS-records toevoegt.

DNS-setup

Kies een subdomein, bijvoorbeeld fingerprint.example.com
Vraag cside om uw fingerprinting-doelhostname
Voeg een CNAME-record toe van uw subdomein naar het cside-doel
Wacht op DNS-propagatie en cside-validatie van de hostname
Gebruik uw subdomein als scriptbron

Voorbeeld van DNS-record:

Type	Naam	Waarde
`CNAME`	`fingerprint.example.com`	`<YOUR_TEAM>.csidefd.com`

Gebruik na validatie de klantdomein-script-URL:

<script
  src="https://fingerprint.example.com/client.js"
  referrerpolicy="origin"
  data-src="6">
</script>

Werk uw CSP bij om het klantensubdomein toe te staan voor script-src en connect-src.

Directe scriptinjectie

Voeg het script toe aan de <head> van de pagina voordat u fingerprintingfuncties aanroept.

<script
  src="https://<YOUR_SUBDOMAIN>.csidefd.com/client.js"
  referrerpolicy="origin"
  data-src="6">
</script>

Roep daarna sendClientTelemetry aan nadat het script is geladen. U kunt de functie zonder argumenten aanroepen of optioneel een externalIds-object meegeven.

const response = await sendClientTelemetry({
  accountId: "customer-123",
  orderId: "order-456",
});

const { token: sessionToken } = await response.json();

Stuur het sessietoken naar uw backend en wissel het uit met de cside API. Zie de Events API voor de volledige flow.

NPM-pakket

Gebruik voor ondersteunde frameworks het cside-pakket dat het browserscript toevoegt aan de app shell. Dit is handig wanneer uw framework documentrendering beheert.

Het pakket moet nog steeds hetzelfde cside-script laden voordat uw app sendClientTelemetry aanroept.

Neem contact op met het cside-team voor hulp als u de NPM-installatiemethode wilt gebruiken.

Google Tag Manager

GTM is handig voor snelle tests, maar garandeert niet dat cside vóór andere scripts laadt. Gebruik een Custom HTML-tag met een All Pages-trigger om de flow te valideren.

Gebruik GTM voor validatie

Voor productie-enforcement of gegevensverzameling met hoge betrouwbaarheid gebruikt u directe scriptinjectie, een NPM-pakket of Cloudflare Workers.

Cloudflare Workers

Gebruik Cloudflare Workers wanneer verkeer al via Cloudflare loopt en u scriptinjectie aan de edge wilt beheren. Zie de Cloudflare Workers-handleiding.