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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# De Whop Pixel installeren

> Voeg de Whop Pixel toe aan elke pagina van je funnel en stuur daarna events zodat je advertenties de credits krijgen voor leads en verkopen.

De Whop Pixel is een JavaScript-fragment dat je aan je website toevoegt. Het meet paginaweergaven, koppelt bezoekers aan hun aankopen en schrijft conversie-events toe aan je advertenties. Na de installatie zie je je website op de [Websites-pagina](https://whop.com/dashboard/websites).

## De Whop Pixel installeren

## 1. Haal je Whop-account-ID op

Je vindt deze in je [Whop Dashboard](https://whop.com/dashboard/): het deel van de URL na `dashboard/`, beginnend met `biz_`. Het ziet eruit als `biz_xxxxxxxxxxxxx`.

![Whop-dashboard-URL in de adresbalk van de browser, met het account-ID na dashboard onderstreept](https://mintcdn.com/whop/i81Det37UaKELkrh/images/dashboard-url.png?fit=max\&auto=format\&n=i81Det37UaKELkrh\&q=85\&s=f8dce6ea378318d4c89f7bce9239605d)

## 2. Installeer het fragment

Plak dit fragment in de `<head>` van **elke pagina** in je funnel: landingspagina's, advertorials, checkouts en bedankpagina's, niet alleen je homepage. Vervang `biz_xxxxxxxxxxxxx` door je eigen account-ID.

```html Pixel snippet theme={null}
<script>
!function(w,d,s,u,n,a,b){if(w[n])return;a=w[n]={q:[],t:+new Date,s:[],o:u,track:function(){a.q.push([+new Date].concat([].slice.call(arguments)))},setScope:function(){a.s=[].slice.call(arguments).filter(function(x){return typeof x==="string"});a.q.push([+new Date,"setScope"].concat(a.s))},scope:function(){var c=[].slice.call(arguments);return{track:function(){a.q.push([+new Date].concat([].slice.call(arguments)).concat([{__scope:c}]))}}}};b=d.createElement(s);b.async=1;b.src=u+"/s.js";d.getElementsByTagName(s)[0].parentNode.insertBefore(b,d.getElementsByTagName(s)[0])}(window,document,"script","https://t.whop.tw","whop");
whop.setScope("biz_xxxxxxxxxxxxx");
whop.track("page");
</script>
```

**Als je advertenties uitvoert vanuit meer dan één Whop-account**, voeg dan elk account-ID toe aan `setScope`. De pixel stuurt elk event naar elk vermeld account, zodat elk dashboard de paginaweergaven krijgt die nodig zijn om conversies aan de eigen campagnes toe te schrijven.

```javascript Send events to multiple accounts theme={null}
whop.setScope("biz_xxxxxxxxxxxxx", "biz_yyyyyyyyyyyyy", "biz_zzzzzzzzzzzzz");
```

Whop houdt gegevens per account gescheiden. Een account dat ontbreekt in `setScope` krijgt geen events van deze pagina. Als je ook [events vanaf je server verstuurt](https://docs.whop.com/nl/developer/ads/events-api.md), stuur elk event dan één keer per account, met de ID van dat account.

Bouw je je funnel op een platform in plaats van in pure HTML? Gebruik dan de bijbehorende installatiegids in plaats van het fragment in een tekstblok van een paginabouwer te plakken.

| Als je dit gebruikt | Volg |
| - | - |
| ClickFunnels | [De Whop Pixel installeren op ClickFunnels](https://docs.whop.com/nl/developer/ads/platforms/clickfunnels.md) |
| GoHighLevel | [De Whop Pixel installeren op GoHighLevel](https://docs.whop.com/nl/developer/ads/platforms/gohighlevel.md) |
| Kajabi | [De Whop Pixel installeren op Kajabi](https://docs.whop.com/nl/developer/ads/platforms/kajabi.md) |
| WordPress | [De Whop Pixel installeren op WordPress](https://docs.whop.com/nl/developer/ads/platforms/wordpress.md) |
| WooCommerce | [De Whop Pixel installeren op WooCommerce](https://docs.whop.com/nl/developer/ads/platforms/woocommerce.md) |
| Shopify | [De Whop Pixel installeren op Shopify](https://docs.whop.com/nl/developer/ads/platforms/shopify.md) |
| WebinarJam | [De Whop Pixel installeren op WebinarJam](https://docs.whop.com/nl/developer/ads/platforms/webinarjam.md) |
| iClosed | [De Whop Pixel installeren met iClosed](https://docs.whop.com/nl/developer/ads/platforms/iclosed.md) |
| Calendly | [De Whop Pixel installeren met Calendly](https://docs.whop.com/nl/developer/ads/platforms/calendly.md) |

## 3. Events tracken

Heeft je funnel belangrijke stappen buiten de checkout van Whop, zoals een leadformulier, het boeken van een gesprek of een aanvraag, voeg dan `whop.track`-aanroepen toe om die events te tracken.

```html Tracking events theme={null}
<script>
  whop.track("lead");                                      // a standard event
  whop.track("schedule", { value: 50, currency: "USD" });  // optionally with a value
  whop.track("quiz_completed");                            // or your own event name
</script>
```

Waar je de aanroep plaatst, hangt af van wat er na de actie gebeurt:

**a. De actie verwijst door** (een formulier dat de bezoeker naar een bedankpagina stuurt)

Activeer het event op de pagina waarop de bezoeker terechtkomt. De aanroep komt in de HTML van die pagina (of in het codeveld van een paginabouwer), dus plaats hem tussen `<script>`-tags. Het pixelfragment moet ook op die pagina zijn geïnstalleerd.

```html Track on a thank-you page theme={null}
<script>
  whop.track("lead");
</script>
```

**b. De actie blijft op dezelfde pagina** (een formulier dat een inline succesmelding toont)

Activeer het event in de succeshandler van de actie. Je zit dan al in JavaScript, dus zonder `<script>`-tags.

```javascript Track on submit (no redirect) theme={null}
form.addEventListener("submit", async (e) => {
  e.preventDefault();
  await submitForm();
  whop.track("lead");
});
```

**Het is belangrijk om in elke fase van de funnel alle informatie die je over de klant hebt mee te sturen.** Accepteer je een lead met een naam, e-mailadres en telefoonnummer, neem die dan op in het event dat naar Whop wordt gestuurd.

```html Lead with customer details theme={null}
<script>
  whop.track("lead", { name: "John Doe", email: "johndoe@example.com", phone: "555-555-1234" });
</script>
```

## Standaard-events

De Whop Pixel bevat een set standaardnamen voor events voor veelvoorkomende fasen van een funnel. Elk event accepteert een optionele `value` (getal) en `currency` (ISO 4217-code). De uitzondering is `purchase`, waarvoor een positieve `value` vereist is.

| Event | Wanneer activeren |
| - | - |
| `lead` | Een bezoeker verstuurt contactgegevens of een opt-in-formulier |
| `schedule` | Een bezoeker boekt een gesprek of afspraak |
| `submit_application` | Een bezoeker dient een aanvraag in |
| `contact` | Een bezoeker start een gesprek of contactverzoek |
| `complete_registration` | Een aanmelding of registratie wordt voltooid |
| `view_content` | Een bezoeker bekijkt een belangrijke pagina of content |
| `add_to_cart` | Een bezoeker voegt een artikel toe aan een winkelwagen |
| `initiate_checkout` | Een bezoeker bereikt de checkout |
| `purchase` | Een verkoop wordt voltooid in [je eigen checkout](#track-sales-on-your-own-checkout), alleen voor betalingen die buiten Whop plaatsvinden. Whop trackt de eigen checkout automatisch |

Geef `variant_id` (met prefix `plan_`) en `product_id` (met prefix `prod_`) mee om aan te geven over welke Whop-variant en welk product een event gaat, meestal bij `view_content` en `add_to_cart` ([Producten en winkelwagens tracken](https://docs.whop.com/nl/developer/websites/tracking.md#track-products-and-carts) toont een productpagina die beide doet):

```javascript theme={null}
whop.track("add_to_cart", {
  variant_id: "plan_xxxxxxxxxxxxx",
  product_id: "prod_xxxxxxxxxxxxx",
  value: 49,
  currency: "USD",
});
```

## Aangepaste events

Als de standaard-events van Whop niet aansluiten op wat je funnel nodig heeft, of als je specifieke fasen van de klantreis wilt tracken, kun je aangepaste events activeren.

```html Custom event theme={null}
<script>
  whop.track("watched_vsl");
  whop.track("quiz_completed", { value: 25, currency: "USD" });
</script>
```

Houd namen kort en stabiel, en hergebruik een kleine set. Whop slaat namen op tot 250 tekens.

Voor aangepaste events gelden dezelfde plaatsingsregels als voor standaard-events. Zie [Events tracken](#track-events).

## Verkopen in je eigen checkout tracken

Verkoop je via je eigen checkout in plaats van via die van Whop, activeer dan een `purchase`-event wanneer een verkoop is voltooid. `value` is vereist: Whop weigert een purchase-event zonder positieve waarde, omdat advertentieplatforms niet kunnen optimaliseren op een verkoop zonder bedrag. `currency` is optioneel en is standaard USD.

```html Purchase on your own checkout theme={null}
<script>
  whop.track("purchase", {
    value: 149.99,
    currency: "USD",
    event_id: "order_8412",
    email: "visitor@example.com",
  });
</script>
```

Whop stuurt deze door naar de advertentieplatforms als hun standaard-Purchase-event, zodat een campagne die op aankopen is geoptimaliseerd ervan leert. In de rapportage van Whop verschijnen ze als externe aankopen, gescheiden van aankopen. Aankopen en ROAS tellen alleen de betalingen die Whop verwerkt.

> [!WARNING]
>
> Activeer nooit `purchase` voor een verkoop die Whop heeft verwerkt. Whop rapporteert die verkoop al aan het advertentieplatform, dus met jouw event zou hij dubbel worden geteld.

## Geef elk event een ID

Geef een `event_id` mee met elk event dat Whop meer dan eens zou kunnen bereiken. Activeer je bijvoorbeeld een event bij het laden van een bedankpagina, zorg er dan voor dat dat event één keer per echte conversie wordt geactiveerd, niet één keer per paginaweergave. Whop telt elk paar van `event_name` en `event_id` één keer, dus een nieuwe poging, een paginavernieuwing of dezelfde conversie vanuit twee plekken wordt samengevoegd tot één event.

```html Event with an ID theme={null}
<script>
  whop.track("lead", { event_id: "lead_8f21c0" }); // one visitor's form submission
  whop.track("lead", { event_id: "lead_2b94de" }); // a different visitor's
</script>
```

**De ID identificeert één afzonderlijk event, niet het type event.** Elke lead heeft een eigen ID nodig. Stuur je `"lead"` als ID voor elke lead, dan behandelt Whop ze allemaal als één event en verschijnen honderden leads als één.

Gebruik een waarde die je eigen systeem al heeft voor die ene actie: een lead-ID, ordernummer of ID van een formulierinzending. Hergebruik die waarde alleen wanneer je dezelfde actie opnieuw verstuurt. Een nieuwe poging telt als dezelfde actie, net als dezelfde conversie die vanaf je server wordt gespiegeld. Een waarde die je bij het activeren verzint, is elke keer nieuw en voorkomt dus geen duplicaten.

Als dezelfde conversie zowel van je website als van je server kan komen, stuur dan vanaf beide dezelfde `event_id`, zodat deze als één event binnenkomt.

## Klantgegevens toevoegen

Stuur altijd zoveel klantgegevens mee als je beschikbaar hebt. Zo kan Whop events aan klanten koppelen en de conversietracking verbeteren.

Deze velden kunnen aan elk type event worden toegevoegd en zijn optioneel. Stuur alleen de velden die je hebt.

```html Lead with customer fields theme={null}
<script>
  whop.track("lead", {
    email: "visitor@example.com",
    first_name: "Jane",
    last_name: "Doe",
    name: "Jane Doe",
    phone: "+15551234567",
    external_id: "customer_123",
    city: "New York",
    state: "NY",
    postal_code: "10001",
    country: "US",
  });
</script>
```

| Veld | Beschrijving |
| - | - |
| `email` | E-mailadres van de bezoeker |
| `first_name` | Voornaam van de bezoeker |
| `last_name` | Achternaam van de bezoeker |
| `name` | Volledige weergavenaam van de bezoeker |
| `phone` | Telefoonnummer van de bezoeker |
| `external_id` | Je eigen gebruikers-/klant-ID |
| `city` | Woonplaats van de bezoeker |
| `state` | Staat of regio van de bezoeker |
| `postal_code` | Postcode van de bezoeker |
| `country` | Land van de bezoeker |

> [!WARNING]
>
> Stuur deze als platte tekst. Een gehasht e-mailadres wordt genegeerd omdat het geen geldig adres is. Een gehasht telefoonnummer wordt opgeslagen als betekenisloze cijfers en komt met niemand overeen.

> [!NOTE]
>
> **Track geen checkouts, abonnementen of proefperiodes van Whop.** Whop registreert elke checkoutweergave, aankoop, abonnement en start van een proefperiode in de eigen checkout server-side, zonder enige configuratie. De pixel accepteert geen duplicaten. Stuur alleen events die Whop niet kan zien: leads en boekingen op je eigen infrastructuur, en [verkopen in je eigen checkout](#track-sales-on-your-own-checkout).


## Related topics

- [De Whop Pixel installeren op Shopify](https://docs.whop.com/nl/developer/ads/platforms/shopify.md)
- [De Whop Pixel installeren op Kajabi](https://docs.whop.com/nl/developer/ads/platforms/kajabi.md)
- [De Whop Pixel installeren met Calendly](https://docs.whop.com/nl/developer/ads/platforms/calendly.md)
