Documentatie
Documentatie
Alles wat je nodig hebt om Track te installeren, serverevents te versturen, toestemming te integreren en destinations te configureren. De dashboardassistent linkt bij elke stap hiernaartoe.
Drie stappen naar een werkende setup
Eén keer installeren, je events versturen, de platformen koppelen die je gebruikt. Elke stap kun je in het dashboard controleren voordat je verdergaat.
Installeer de snippet
Voeg één asynchrone scripttag toe aan je pagina's. Die laadt de ondertekende configuratie voor je tracking-ID en respecteert toestemming vanaf de eerste paginaweergave.
Dit kun je controlerenPaginaweergaven verschijnen in de event-debugger.
Verstuur je events
Gebruik de standaardevents vanuit de browser, een shopplugin of je server. Aankopen dragen een order-ID, zodat de browser- en serverkopie worden gededupliceerd.
Dit kun je controlerenElk event toont zijn toestemmingsstatus en de reden waarom het is afgeleverd of vastgehouden.
Koppel een destination
De begeleide wizard valideert credentials, mapt events, verstuurt een echt testevent en publiceert pas na jouw goedkeuring.
Dit kun je controlerenAfleverstatus en de laatste geslaagde aflevering worden per destination getoond.
Hoe een event reist
Elk event volgt dezelfde route, of het nu uit de browser, een shopplugin of je server komt: Track valideert en dedupliceert het, evalueert het toestemmingsbeleid en routeert het naar de destinations die je hebt geconfigureerd.
Op deze pagina
Handleidingen
Installeer de snippet
Voeg het asynchrone script toe aan elke pagina, bij voorkeur in de head. Het laadt de ondertekende configuratie voor je tracking-ID, respecteert toestemming en blokkeert nooit het renderen. Vervang TRACKING_ID door de ID van zes tekens uit je dashboard.
<script async src="https://cdn.track.site/v1/tracker.js" data-site-id="TRACKING_ID"></script>Browserevents versturen
Standaardevents (page_view, view_item, add_to_cart, begin_checkout, purchase, generate_lead, sign_up, subscribe, start_trial, contact, book_appointment, download, search, login) dragen gevalideerde parameters; custom events gebruiken namen in lowercase snake_case.
window.tsq = window.tsq || [];
tsq.push(["track", "purchase", { order_id: "A1001", currency: "EUR", value: 129.9, items: [{ item_id: "SKU-1", price: 99.9, quantity: 1 }] }]);
tsq.push(["identify", { user_id: "u_42", email: "customer@example.com" }]); // wordt client-side gehasht vóór verzendingServer-API en offline conversies
Maak een source key aan onder Instellingen → Server source keys en verstuur events vanuit je backend, CRM of kassasysteem. Geef dezelfde order-ID mee als het browserevent voor deduplicatie; voeg props.offline toe voor offline conversies.
curl -X POST https://api.track.site/v1/s \
-H "Authorization: Bearer tsk_..." -H "Content-Type: application/json" \
-d '{"events":[{"name":"purchase","ts":1767225600000,"props":{"offline":true},"commerce":{"order_id":"A1001","currency":"EUR","value":129.9},"user_data":{"email":"customer@example.com"},"click_ids":{"gclid":"Cj0K..."},"consent":{"granted":["necessary","marketing"],"source":"crm"}}]}'Toestemming integreren
Gebruik een ondersteund CMP (TCF 2.2, GPP/GPC, Cookiebot, OneTrust, Usercentrics) — de tracker leest het automatisch uit — of roep de consent-API aan vanuit je eigen banner. Doelen: necessary, analytics, marketing, personalization. Intrekken stopt alles onmiddellijk.
tsq.push(["consent", { granted: ["necessary", "analytics", "marketing"], source: "api", policy_version: "2026-09" }]);Destinations
Elke destination heeft een begeleide wizard: identifiers, credentials uit de kluis of OAuth, validatie bij de leverancier, eventmapping met geverifieerde standaardwaarden, een echt testevent, lint, diff en publiceren na goedkeuring. Browser en server delen één event-ID; aankopen voegen de order-ID toe.
- Meta, Google Ads/YouTube, GA4, TikTok, Microsoft, LinkedIn, Reddit, Pinterest, Snapchat
- X, Taboola, Outbrain, Amazon Ads, Spotify, Quora
- Yahoo DSP, The Trade Desk, Google Marketing Platform, AdRoll, Criteo, affiliate-postbacks (13 presets), webhooks
Shopplatformen
Shopify (app met orderwebhooks en web pixel), WooCommerce (plugin met ondertekende orderwebhooks) en Shopware 6 (app met storefront-script en orderwebhooks) versturen geverifieerde aankoop- en terugbetalingsevents met order-ID's. Plugin installeren, tracking-ID en source key plakken, klaar.
- Geverifieerde bron: events worden gemarkeerd als source_verified en gelden als de gezaghebbende conversie
- Terugbetalingen maken events met negatieve waarde aan voor leveranciers die dat ondersteunen
- Browseraankopen uit het thema worden gededupliceerd op order-ID
Privacycenter en DSAR
Bewaartermijnen per gegevenssoort, versies van het toestemmingsbeleid per site en verzoeken van betrokkenen (export, verwijderen, beperken, rectificeren, bezwaar maken, overdraagbaarheid) worden afgehandeld onder Toestemming & privacy. Verzoeken gebruiken alleen gehashte identifiers en leveren een geauditeerd rapport op.
Endpoints in één oogopslag
Alle antwoorden zijn JSON; 202 betekent dat de batch duurzaam in de queue staat.
| Endpoint | Doel | Opmerkingen |
|---|---|---|
POST /v1/e | Browserbatches | ≤ 50 events per batch |
POST /v1/s | Serverbatches | ≤ 100 events per batch, Bearer source key |
POST /v1/affiliate/in/{trackingId}/{preset} | Inkomende postbacks van affiliatenetwerken | 13 netwerkpresets |
GET /c/{trackingId}/manifest.json | Configuratiemanifest en ondertekende bundle | Ed25519-ondertekend, geverifieerd door de browser-SDK |