Track

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.

  1. 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.

  2. 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.

  3. 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.

Hoe een event reistWebsite → Track → Toestemming/Policy → Destinations. Een event zonder het vereiste toestemmingsdoel stopt bij de gate; het wordt niet opgeslagen en niet doorgestuurd.Websitebrowser · serverTrackvalideren · dedupliceren · routerenToestemmingvastgehouden: geen doeldoel toegestaanMetaGoogle AdsGA4Destinations
Website → Track → Toestemming/Policy → Destinations. Een event zonder het vereiste toestemmingsdoel stopt bij de gate; het wordt niet opgeslagen en niet doorgestuurd.

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.

Snippethtml
<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.

Browserjs
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 verzending

Server-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.

POST /v1/sbash
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"}}]}'

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.

Endpoints in één oogopslag
EndpointDoelOpmerkingen
POST /v1/eBrowserbatches≤ 50 events per batch
POST /v1/sServerbatches≤ 100 events per batch, Bearer source key
POST /v1/affiliate/in/{trackingId}/{preset}Inkomende postbacks van affiliatenetwerken13 netwerkpresets
GET /c/{trackingId}/manifest.jsonConfiguratiemanifest en ondertekende bundleEd25519-ondertekend, geverifieerd door de browser-SDK