Links

Conversiepixel

Track conversies op bestemmingspagina's die je niet beheert, toegeschreven aan de oorspronkelijke click en A/B-variant.

A/B-tests van korte links kunnen bezoekers naar een bestemmingspagina sturen die je niet beheert — een webshop, een landingspagina-builder, de site van een partner. Styrar meet de click en welke variant een bezoeker zag, maar heeft geen manier om te weten of die bezoeker na de redirect ook converteerde.

De conversiepixel dicht dat gat. Het is een klein script dat je op de bestemmingspagina insluit en dat conversies terugmeldt aan Styrar, gekoppeld aan de exacte click (en A/B-variant) die de bezoeker daarheen stuurde.

Hoe het werkt

Wanneer een korte link een bezoeker doorstuurt, voegt Styrar een eenmalig styrar_ck-token toe aan de bestemmings-URL.
Het pixelscript op die pagina leest het token uit de URL (of localStorage, zodat het verdere navigatie op je site overleeft) en houdt het klaar om met elke gebeurtenis mee te sturen.
Je roept window.styrar.track(eventName, data) aan — of voegt een data-styrar-track-attribuut toe — wanneer een bezoeker iets doet dat het tellen waard is (aanmelden, afrekenen, een proefperiode starten).
Styrar herleidt het token terug naar de oorspronkelijke link en A/B-variant, en de conversie verschijnt in het experimentpaneel van die link.

Er is geen account-id, site-id of API-sleutel te configureren. Het token zelf is het enige dat een gebeurtenis terugkoppelt aan je werkruimte, en het is gescopet tot één click.

Een conversiepixel instellen

1. Vind je embed-snippet

Open het paneel Geavanceerd → A/B-test van de korte link in het dashboard en start (of configureer) een experiment. Het paneel toont een kaart "Conversies tracken op de bestemmingspagina" met een kopieerklare snippet:

HTML

<script src="https://api.styrar.com/v1/pixel/styrar.js" async></script>
<!-- mark a conversion -->
<button data-styrar-track="signup">Sign up</button>
<!-- or call it from your own code -->
<script>window.styrar && window.styrar.track('signup', { value: 19.99 })</script>

2. Voeg de scripttag toe aan je bestemmingspagina

Plak de tag <script src="…/v1/pixel/styrar.js"> op de pagina waar bezoekers terechtkomen nadat de korte link doorverwijst — in de <head> of net voor </body>. Dit werkt op elk platform (Shopify, Webflow, een statische site, je eigen app) omdat de pixel en het trackingendpoint een open, cookievrij CORS-beleid gebruiken.

3. Markeer een conversie

Kies wat het beste bij je pagina past:

Declaratief, zonder dat je eigen JavaScript nodig hebt:

HTML

<button data-styrar-track="signup">Sign up</button>
<form data-styrar-track="checkout_complete">…</form>

Een click triggert de gebeurtenis op de meeste elementen; op een <form> triggert het in plaats daarvan op submit.

Vanuit je eigen code, zodra het script geladen is:

HTML

<script>
  window.styrar && window.styrar.track('purchase', { value: 49.99 })
</script>

4. Bevestig dat het werkt

Trigger de conversie op de bestemmingspagina en open vervolgens het A/B-testpaneel van de link — het conversieaantal en -percentage van de variant worden bijgewerkt zodra de gebeurtenis binnenkomt.

Aangepaste conversiewaarden

window.styrar.track(eventName, data) accepteert elke gebeurtenisnaam en een optioneel data-object:

HTML

<script>
  window.styrar.track('purchase', {
    value: 49.99,          // numeric — stored as the event's value
    plan: 'pro_annual',    // any other field is stored alongside the event
    currency: 'USD',
  })
</script>

Veld	Type	Gedrag
`eventName`	string	Verplicht. Tot 64 tekens — gebruik wat past bij je funnel: `signup`, `add_to_cart`, `purchase`, enzovoort.
`value`	number	Wordt alleen opgeslagen als het een JS-`number` is (bijvoorbeeld orderomzet). Alles anders wordt genegeerd.
elk ander veld op `data`	elke JSON-waarde	Wordt opgeslagen naast de gebeurtenis (tot 4 KB geserialiseerd). Grotere payloads worden verwijderd, niet afgekapt.

Er is geen schema dat je vooraf moet registreren — roep track() aan met wat past bij je pagina, en het wordt bewaard bij de gebeurtenis.

Conversies vanaf je server rapporteren

Als de conversie server-side plaatsvindt (bijvoorbeeld een webhook van je betalingsprovider) in plaats van in de browser, lees je de parameter styrar_ck van het oorspronkelijke verzoek en post je die direct:

RequestPOST

Content-Type: application/json

{
  "clickToken": "the styrar_ck value",
  "eventName": "purchase",
  "value": 49.99
}

Response200 OK

{
  "ok": true
}

Dit is hetzelfde ongeauthenticeerde verzoek dat de browserpixel doet. Er is geen API-sleutel — het clickToken is eenmalig-gescopet tot één click en niet te enumereren, dus het dient ook als credential.

API-referentie

Plain text

GET  /v1/pixel/styrar.js   # the embeddable script, no auth required
POST /v1/pixel/track        # records a conversion event, no auth required

Body van POST /v1/pixel/track:

Veld	Verplicht	Beschrijving
`clickToken`	Ja	De `styrar_ck`-waarde uit de bestemmings-URL of `localStorage`
`eventName`	Ja	Tot 64 tekens
`value`	Nee	Getal, bijvoorbeeld orderwaarde
`eventData`	Nee	Willekeurig JSON-object, tot 4 KB geserialiseerd
`pageUrl`	Nee	Tot 2048 tekens; het script stuurt automatisch `window.location.href`

Het endpoint antwoordt altijd 200 { "ok": true } — ook bij een onbekend of verlopen clickToken — zodat de pixel nooit een fout laat zien op een pagina die je niet volledig beheert.

Privacy en beveiliging

De pixel stuurt alleen het clicktoken, de gebeurtenisnaam/waarde/data die jij meegeeft, en de huidige pagina-URL. Er zijn geen cookies, fingerprinting of cross-site-identifiers bij betrokken.
/v1/pixel/track is rate-limited per IP (120 verzoeken/minuut) om misbruik te absorberen zonder normaal verkeer te beïnvloeden.
clickToken is een willekeurige, eenmalig-gescopete identifier — hij kan niet worden afgeleid van de korte code van een link of een andere publieke waarde.

Limieten

Conversietracking vereist dat er een A/B-test is geconfigureerd op de link; de conversie wordt toegeschreven aan de variant die de bezoeker zag op het moment van de click.
Er is geen automatische pageview-tracking — de pixel rapporteert alleen gebeurtenissen die je expliciet triggert, om ruis en aantal verzoeken laag te houden.
Nog geen bulk-export- of verwijderendpoint voor conversiegebeurtenissen; neem contact op als je gegevens voor een specifieke werkruimte verwijderd wilt hebben.

Verwant

Webhooks — krijg een melding wanneer een A/B-test wordt afgerond via link.experiment.completed
Korte links en QR-codes in het helpcentrum
Bio-paginatrackers — Google Analytics, Meta, GTM en meer op je bio-pagina
Deze pixel per platform installeren: Shopify · WordPress · Wix · Framer · Server-side