Snippet-setup

Deze pagina is de HTML- / eenvoudige-script-installatiehandleiding voor het Selgeo-trackingsnippet (selgeo.js) — een lichtgewicht JavaScript-bestand dat op uw website wordt uitgevoerd, partnerreferralklikken registreert en attribuutgegevens opslaat in de browser van de bezoeker voor latere conversiematching. Gebruik deze handleiding als u de ruwe HTML van uw site rechtstreeks beheert (statische sites, Webflow, Shopify Liquid, aangepaste server-gerenderde pagina's of een tagbeheerder).

Gebruikt u een framework?

• Next.js — zie de Next.js-handleiding voor het next/script-componentpatroon.
• React (Vite) — zie de React-(Vite)-handleiding voor plaatsing in index.html en de useEffect-terugvaloptie.
• WordPress — zie de WordPress-handleiding voor plaatsing via Site Editor, footer.php en header-footer-plugins.

API-versie: v1

Basisinstallatie

Voeg de volgende <script>-tag toe aan elke pagina van uw website, vlak voor de sluitende </body>-tag:

<script
  async
  src="https://cdn.selgeo.com/v1/selgeo.js"
  data-merchant="pk_test_YOUR_KEY"
></script>

Vereiste attributen

Attribuut	Beschrijving
src	CDN-URL voor het snippet. Gebruik altijd https://cdn.selgeo.com/v1/selgeo.js.
data-merchant	Uw publieke API-sleutel (pk_test_* voor testmodus, pk_live_* voor live-modus).
async	Laadt het snippet asynchroon zodat de paginaweergave niet wordt geblokkeerd.

Optionele attributen

Attribuut	Beschrijving
data-debug	Schakelt debug-logging in de browserconsole in. Verwijderen voor live gaan.
data-api-url	Overschrijft de API-eindpunt-URL. Alleen voor geavanceerd gebruik.

Hoe het werkt

Wanneer een bezoeker uw site bezoekt met een ?ref=-parameter in de URL, doet het snippet het volgende:

1. Detecteert de ref-queryparameter.
2. Registreert de klik bij de Selgeo-API met uw publieke sleutel.
3. Slaat de click_id op die door de API wordt geretourneerd in de sessionStorage van de browser.
4. Verwijdert ?ref= uit de URL via history.replaceState.
5. Herschrijft Stripe Payment Links op de pagina om client_reference_id=CLICK_ID toe te voegen.

Opslagmechanisme

Sleutel	Opslag	Waarde	Levensduur
__selgeo_cid	sessionStorage	De click_id (UUID)	Tot het browsertabblad wordt gesloten
__selgeo_vtk	sessionStorage	Een bezoekerstoken (UUID)	Tot het browsertabblad wordt gesloten
selgeo:snippet_ping:<pk>	localStorage	Installatie-heartbeat-memo (alleen publieke sleutel, geen persoonsgegevens)	~24 uur

Privacyimplicaties:

• sessionStorage is tabspecifiek — het wordt niet gedeeld tussen tabbladen of vensters.
• Gegevens worden automatisch gewist wanneer het tabblad wordt gesloten.
• Er worden geen cookies ingesteld. Er is geen cookietoestemmingsbanner vereist voor Selgeo-tracking.

De klik-ID lezen

const clickId = __selgeo.getClickId();
// Retourneert een UUID-string of null als er geen referralklik is geregistreerd

Beschikbare methoden

Methode	Retourneert	Beschrijving
__selgeo.getClickId()	string | null	De huidige klik-ID, of null als er geen bestaat
__selgeo.getVisitorToken()	string | null	Het huidige bezoekerstoken, of null
__selgeo.checkUrl()	void	Controleert handmatig de huidige URL op een ?ref=-parameter

Single-page applicaties (SPA's)

Het snippet bewaakt automatisch URL-wijzigingen in single-page applicaties door te luisteren naar popstate-events en history.pushState/history.replaceState-aanroepen.

Automatisch herschrijven van Stripe Payment Links

Als uw pagina links bevat naar Stripe Payment Links (https://buy.stripe.com/...), voegt het snippet automatisch ?client_reference_id=CLICK_ID toe wanneer er een actieve referralklik is.

Het snippet moet op de landingspagina staan

De ?ref=-parameter is alleen aanwezig in de initiële URL wanneer de bezoeker op een partnerlink klikt. Als het snippet niet op die pagina is geladen, wordt de klik niet geregistreerd.

Plaatsingsaanbevelingen

Scenario	Aanbeveling
Standaard website	Toevoegen aan elke pagina via globale layout/template
SPA (React, Vue, enz.)	Eénmalig toevoegen aan index.html — snippet verwerkt routewijzigingen
Alleen landingspagina's	Alleen toevoegen aan pagina's waar partnerverkeer landt
Alleen betaalpagina	Niet aanbevolen — snippet moet op de landingspagina staan

Uw installatie verifiëren

1. Voeg data-debug tijdelijk toe aan de script-tag.
2. Haal een test-trackinglink op — deze worden aangemaakt door partners in het partnerportaal (onder Links); voor een zelftest logt u in als testpartner en maakt u er een aan. Bezoek uw site ermee: https://uw-site.com/?ref=UW_TRACKING_REF
3. Open de Ontwikkelaarstools (F12) en controleer de Console op:

   [selgeo] ref detected UW_TRACKING_REF
   [selgeo] click_id stored xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Controleer sessionStorage op het tabblad Application (Chrome) of Storage (Firefox):
   • __selgeo_cid zou een UUID moeten bevatten
   • __selgeo_vtk zou een UUID moeten bevatten
5. Roep de API aan in de console:

   __selgeo.getClickId()  // Zou een UUID-tekenreeks moeten teruggeven

6. Controleer het dashboard — de klik zou binnen enkele seconden in Analytics moeten verschijnen.

Volgende stappen

• Stripe Payment Links — Stripe-integratie zonder backend
• Stripe Checkout — click_id doorgeven aan betaalsessies
• Stripe Metadata — click_id doorgeven via metadata
• Conversie-API — niet-Stripe-conversies bijhouden