> ## Documentation Index
> Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversietracking

> Meet aanmeldingen, demo's en aankopen op je website met de Scribe JavaScript SDK en herleid elke conversie naar de e-mailhandtekening die eraan bijdroeg.

Conversietracking sluit de funnel van je e-mailhandtekeningen. Handtekeninganalytics laat je al weergaven en kliks zien. Met de Scribe JavaScript SDK leg je ook vast wat er daarna op je eigen website gebeurt: aanmeldingen, geboekte demo's en aankopen. Elke actie koppel je terug aan de handtekening, het teamlid en de link die de conversie veroorzaakten. Dit is de onderkant van de funnel: weergaven, dan kliks, dan conversies.

In Scribe heten deze conversies **events**. Je legt ze vast met een paar regels JavaScript en Scribe kent ze automatisch toe via dezelfde kliktracking die de rest van je analytics aandrijft.

<Note>
  Conversietracking is beschikbaar in betaalde abonnementen. Als het abonnement van je Workspace dit niet bevat, registreert de trackingsnippet niets.
</Note>

## Hoe het werkt

1. Een ontvanger klikt op een link in een van je e-mailhandtekeningen.
2. Scribe stuurt de ontvanger door naar je site en voegt een `scribe_click_id`-parameter toe aan de bestemmings-URL.
3. De Scribe SDK op je landingspagina leest die `scribe_click_id` uit, slaat deze first-party op en koppelt deze aan elk event dat je vastlegt.
4. Zodra de bezoeker converteert, roep je `scribe.track('signup')` aan. Scribe koppelt het event terug aan de oorspronkelijke klik.

Het resultaat: je ziet welke handtekeningen, teamleden en aangeklikte elementen echte conversies en omzet opleveren, niet alleen kliks. Toewijzing werkt op afzender-, handtekening- en elementniveau, en Scribe koppelt een conversie tot 30 dagen na de klik aan de klik.

Als een event binnenkomt zonder een bekende `scribe_click_id` (direct verkeer, een verlopen link of een gestripte parameter), wordt het nog steeds vastgelegd. Het wordt alleen niet aan een klik toegeschreven.

## Voordat je begint

Je hebt drie dingen nodig:

* **Een betaald abonnement** dat conversietracking bevat.
* **Tracking ingeschakeld** voor je Workspace. Dit is dezelfde instelling die de weergave- en klikanalyses van handtekeningen aandrijft. Schakel het pas in als je over de vereiste toestemming beschikt (zie [Privacy en toestemming](#privacy-and-consent)).
* **Je Event Tracking ID.** Dit is een openbare, niet-geheime identifier voor je Workspace. Je kunt hem veilig in de HTML van je website opnemen.

<Steps>
  <Step title="Kopieer je Event Tracking ID">
    Open in Scribe **Settings**, ga naar het tabblad **Workspace** en kopieer de waarde onder **Event Tracking ID**. Controleer meteen of **Tracking** is ingeschakeld.
  </Step>

  <Step title="Voeg de SDK toe aan je site">
    Gebruik het scriptsnippet voor een gewone website, of het npm-pakket voor een app of single-page app. Beide bieden dezelfde `scribe.track(...)` API.

    **Optie A. Scriptsnippet.** Voeg dit toe aan elke pagina die je wilt tracken, vlak vóór de afsluitende `</head>`-tag. Het snippet initialiseert zichzelf vanuit `data-workspace`, dus je hoeft geen `init()` aan te roepen.

    ```html theme={null}
    <!-- Scribe conversion tracking -->
    <script src="https://cdn-1.scribe-mail.com/v1/tracking.js"
            data-workspace="YOUR_EVENT_TRACKING_ID" async></script>
    ```

    **Optie B. npm of yarn.** Installeer het pakket en initialiseer het één keer bij het opstarten van de app.

    ```bash theme={null}
    npm install @scribemail/js
    # or: yarn add @scribemail/js
    ```

    ```js theme={null}
    import scribe from '@scribemail/js';

    scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }); // once, at app startup
    ```

    Het importeren van de module heeft geen side effects (veilig voor server-side rendering). Er wordt niets verzonden totdat je `init()` aanroept.
  </Step>

  <Step title="Registreer je eerste conversie">
    Roep `scribe.track` aan waar een conversie plaatsvindt, bijvoorbeeld in je handler voor een geslaagde aanmelding.

    ```js theme={null}
    scribe.track('signup', { value: 99.0, currency: 'USD', plan: 'pro' });
    ```

    De SDK legt de Scribe-klikattributie vast vanuit de landings-URL, bundelt je events en verzendt ze betrouwbaar, ook wanneer de bezoeker wegnavigeert.
  </Step>

  <Step title="Check that it works">
    Activeer het event op je site en open vervolgens **Analytics** in Scribe. Je conversies verschijnen naast weergaven en kliks, uitgesplitst per handtekening, teamlid, campagne en land.
  </Step>
</Steps>

## SDK-referentie

### `scribe.track(name, metadata)`

Registreert een event. `name` is verplicht, bijvoorbeeld `signup`, `demo_booked` of `purchase`.

```js theme={null}
scribe.track('purchase', {
  value: 149.0,           // optional, monetary value of the conversion
  currency: 'EUR',        // optional, ISO currency code
  event_id: 'order_8821', // optional, your own id, used for idempotency
  plan: 'team',           // any other key becomes an event "property"
  seats: 5
});
```

* `value`, `currency` en `event_id` zijn herkende topniveauvelden.
* **Elke andere sleutel** wordt onderdeel van de `properties` van het event. Houd eigenschappen op platte scalaire waarden (strings, getallen, booleans). Zet geen persoonsgegevens zoals e-mailadressen of telefoonnummers in eigenschappen: Scribe verwijdert sleutels die eruitzien als persoonsgegevens automatisch.
* Geef je eigen `event_id` mee om een verzending veilig opnieuw te kunnen uitvoeren. Dezelfde `event_id` die binnen 24 uur twee keer wordt ontvangen, wordt slechts één keer geregistreerd.

### `scribe.identify(userId, traits)`

Koppelt de bezoeker aan een van je eigen gebruikers, zodat je ziet welke handtekeningen welke klanten binnenhalen. Handig voor B2B en account-based werk.

```js theme={null}
scribe.identify('user_42', { email: 'ada@example.com', name: 'Ada', plan: 'pro' });
```

Na een `identify`-aanroep zijn volgende `track`-aanroepen aan die gebruiker gekoppeld. Roep `scribe.reset()` aan bij het uitloggen om de identiteit te wissen.

### `scribe.flush()`

Events worden automatisch gebundeld en verzonden, en altijd wanneer de pagina wordt verborgen. Roep `flush()` alleen aan als je de huidige batch onmiddellijk moet forceren.

### Snippet-attributen

Wanneer je het scriptsnippet gebruikt, configureer je het met `data-*`-attributen:

| Attribuut            | Verplicht | Beschrijving                                                                                   |
| -------------------- | --------- | ---------------------------------------------------------------------------------------------- |
| `data-workspace`     | Ja        | Je Event Tracking ID.                                                                          |
| `data-consent`       | Nee       | Zet op `"denied"` om first-party opslag uit te schakelen totdat de bezoeker toestemming geeft. |
| `data-cookie-domain` | Nee       | Stel je apex-domein in om identiteit te delen tussen subdomeinen.                              |

### Content Security Policy

Als je site een Content Security Policy instelt, plaats dan de Scribe-hosts op de allowlist:

```
script-src  https://cdn-1.scribe-mail.com;
connect-src https://t.scribe-mail.com;
```

<Tip>
  Wil je een gezaghebbende gebeurtenis vanuit je backend registreren, zoals een betaling die je server heeft bevestigd? Scribe accepteert gebeurtenissen ook via de API met een `events:write` API-sleutel, waardoor omzetwaarden betrouwbaar blijven in plaats van door de client aangeleverd. Zie de [API-referentie](/api-reference/introduction) voor details.
</Tip>

## Toepassingen: zet conversies om in groei

Met conversietracking worden je e-mailhandtekeningen een meetbaar acquisitiekanaal. Zo zetten teams de data in, inclusief het doorspelen naar betaalde remarketing.

### Voer remarketingcampagnes uit op Google Ads en Meta Ads

Activeer de conversiepixels van je advertentieplatform op dezelfde plek waar je `scribe.track` aanroept, zodat één conversie tegelijk binnenkomt in Scribe, Google Ads en Meta. Scribe vertelt je dat de conversie uit een e-mailhandtekening komt; Google en Meta gebruiken hetzelfde signaal voor bidding en doelgroepen.

```js theme={null}
function onSignupComplete(plan, price) {
  // 1. Attribute the conversion to the email signature that drove it
  scribe.track('signup', { value: price, currency: 'USD', plan });

  // 2. Send the same conversion to your ad platforms for bidding and audiences
  // gtag('event', 'conversion', { send_to: 'AW-XXXXXXXXX/abc', value: price, currency: 'USD' });
  // fbq('track', 'CompleteRegistration', { value: price, currency: 'USD' });
}
```

### Bouw retargetingdoelgroepen met hoge intentie

Mensen die op je handtekening hebben geklikt en op je site zijn beland, maar niet hebben geconverteerd, zijn warm. Gebruik Scribe om verkeer vanuit handtekeningen te bevestigen en retarget die bezoekers vervolgens met een gerichte aanbieding op Google en Meta. Omdat het verkeer uit je eigen e-mails komt, converteren deze doelgroepen doorgaans beter dan koude prospectie.

### Voed lookalike- en vergelijkbare doelgroepen vanuit je converters

Je beste seed-doelgroep bestaat uit mensen die al hebben geconverteerd via een vertrouwd kanaal. Haal de bezoekers op die via handtekeningen zijn binnengekomen (filter op handtekening, teamlid of campagne), upload ze als aangepaste doelgroep in Meta of als Customer Match-lijst in Google Ads en bouw daaruit Lookalike- of Vergelijkbare doelgroepen op basis van die hoogwaardige seed.

### Sluit bestaande klanten uit van acquisitiebudget

Stop met betalen om mensen te werven die zich al hebben aangemeld of iets hebben gekocht. Exporteer je converters en voeg ze toe als uitsluitings- of onderdrukkingslijst in je prospectingcampagnes, zodat je budget naar echt nieuwe prospects gaat.

### Optimaliseer op omzet, niet alleen op kliks

Geef bij elke conversie een echte `value` en `currency` mee. Met omzet erbij kun je Google en Meta overzetten op value-based bidding, en in Scribe kun je handtekeningen, teamleden en campagnes rangschikken op de omzet die ze genereren in plaats van alleen op kliks.

### Bewijs het kanaal en verdeel budget opnieuw

Met conversietracking vergelijk je de omzet uit e-mailhandtekeningen op dezelfde manier met die van je betaalde kanalen. Als een handtekeningcampagne beter presteert dan een betaalde, heb je de cijfers om budget te verschuiven naar wat werkt.

## Laat een AI-agent het instellen

Je hoeft dit niet handmatig aan te sluiten. Als je een AI-codeerassistent gebruikt (zoals Claude Code, Cursor of een vergelijkbare agent in je editor), plak er dan een prompt als deze in, met je eigen Event Tracking ID en de conversies die er voor jou toe doen:

```text theme={null}
Install the Scribe conversion tracking SDK on my website.

- If this is an app or single-page app, add the @scribemail/js package and call
  scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }) once at startup. If it is a plain
  HTML site, add the https://cdn-1.scribe-mail.com/v1/tracking.js script with
  data-workspace="YOUR_EVENT_TRACKING_ID" before </head> instead.
- Call scribe.track('signup', { value, currency }) from my signup success handler
  and scribe.track('purchase', { value, currency }) from my checkout confirmation.
- If I have logged-in users, call scribe.identify(userId, { email, plan }) after login.
- Add https://cdn-1.scribe-mail.com and https://t.scribe-mail.com to my Content
  Security Policy if I have one.
```

Zodra er conversies binnenkomen, kan een agent die verbonden is met de [Scribe MCP-server](/nl/ai-agents/connect) de resultaten voor je uitlezen en toelichten. Stel vragen als „welke handtekeningen en teamleden leverden deze maand de meeste conversies en omzet op?" of „geef een lijst van de bezoekers die mijn handtekeningen deze week hebben binnengehaald." Zie [Scribe voor AI-agents](/nl/ai-agents) en de [Scribe-analyseskill](/nl/ai-agents/skills) voor wat je assistent kan ophalen.

## Privacy en toestemming

Conversietracking is zo gebouwd dat je bezoekers en je verplichtingen worden gerespecteerd:

* **IP-adressen worden geanonimiseerd.** Scribe hasht het IP-adres voordat het wordt opgeslagen. Onbewerkte IP-adressen worden nooit bewaard.
* **Geen persoonsgegevens in eigenschappen.** Sleutels die eruitzien als persoonsgegevens (e-mailadres, telefoonnummer, wachtwoord, tokens, kaartnummers en dergelijke) worden automatisch uit gebeurteniseigenschappen verwijderd. Gebruik `identify` wanneer je bewust een gebruiker wilt koppelen.
* **Opslag na toestemming.** Stel `data-consent="denied"` (snippet) of `consent: false` (npm `init`) in, zodat de SDK de klik-ID pas opslaat nadat je bezoeker toestemming heeft gegeven.
* **Vraag toestemming voordat je tracking inschakelt.** De trackinginstelling van de Workspace draagt dezelfde verantwoordelijkheid als elke andere analytics-pixel. Zorg dat je over de vereiste toestemming beschikt volgens de regels in jouw regio voordat je de instelling activeert.

## Gerelateerde artikelen

* [Overzicht van analytics](/nl/analytics-overview): weergaven, kliks, bereik en CTR in je Workspace.
* [Analytics-dashboard](/nl/analytics-dashboard): lees conversies naast weergaven en kliks in elk tabblad.
* [Handtekeninganalytics](/nl/signature-analytics): prestaties van een individuele handtekening.
* [Marketingcampagnes](/nl/marketing-overview): banner-campagnes uitvoeren en meten binnen handtekeningen.
* [Scribe voor AI-agents](/nl/ai-agents): laat een assistent tracking instellen en rapporteren over conversies.