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

# Bezoekers tracken

> Sites op whop.site bevatten de Whop-pixel met automatische tracking van paginaweergaven en checkouts. Voeg whop.track-aanroepen toe voor leads, boekingen en aangepaste events.

Whop injecteert de pixel in elke HTML-pagina die je site serveert, afgestemd op het bedrijf van de app, en verstuurt een paginaweergave. Er is geen fragment om te plakken en geen account-ID om te configureren.

| Automatisch getrackt | Jij voegt een `whop.track`-aanroep toe |
| - | - |
| Paginaweergaven | Leadformulieren, belafspraken, aanvragen |
| Weergaven van de Whop-checkout | Quizzen, voltooide VSL's, alles op je eigen pagina's |
| Aankopen, abonnementen, proefperiodes | Stappen die de betalingsgegevens van Whop niet kunnen zien |

## Je eigen events tracken

`window.whop` bestaat al voordat je appcode draait, dus roep het direct aan:

```javascript theme={null}
whop.track("lead");
whop.track("schedule", { value: 50, currency: "USD" });
whop.track("watched_vsl");
```

Standaard eventnamen — `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `initiate_checkout` — accepteren elk optioneel een `value` en een `currency`. Elke andere naam werkt ook en verschijnt onder die naam in de rapportage.

Verstuur het event waar de actie wordt voltooid: in de succeshandler als de pagina blijft staan, of op de bevestigingspagina als er een redirect plaatsvindt.

> [!TIP]
>
> Geef een `event_id` mee bij alles wat twee keer kan binnenkomen — een retry, een refresh of dezelfde conversie die ook vanaf je server wordt gespiegeld. Whop telt elk paar van naam en ID één keer. Gebruik een ID dat je systeem al heeft voor die ene actie, nooit een constante zoals `"lead"`.

## Producten en winkelwagens tracken

Trackingtools koppelen een verkoop terug aan het product dat een bezoeker heeft bekeken. Vertel de pixel voor welk Whop-product en welke variant elke weergave, elke toevoeging aan de winkelwagen en elke start van een checkout is. Winkels die Whop AI bouwt, doen dit al op hun product- en checkoutpagina's. Een site die je zelf bouwt of met de CLI uploadt, voegt drie aanroepen en vier attributen toe.

Verstuur `view_content` wanneer een productpagina een variant toont, opnieuw wanneer de shopper een andere kiest, `add_to_cart` wanneer de shopper hem toevoegt, en `initiate_checkout` wanneer de checkout opent:

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

* `variant_id` is het ID van de variant, met voorvoegsel `plan_`, en `product_id` is het ID van het bijbehorende product, met voorvoegsel `prod_`.
* `value` is de prijs die de pagina toont, in de hoofdeenheden van de valuta (`49` voor \$ 49,00), en `currency` is de ISO 4217-code. Laat beide weg als de pagina geen prijs toont.
* Een checkout voor meerdere varianten verstuurt `initiate_checkout` met het totaalbedrag en laat `variant_id` en `product_id` weg.

Markeer het element dat het product toont met dezelfde vier waarden voor de variant op het scherm, zodat een trackingscript ze op elk moment kan uitlezen:

```html theme={null}
<section
  data-whop-product-id="prod_xxxxxxxxxxxxx"
  data-whop-variant-id="plan_xxxxxxxxxxxxx"
  data-whop-price="49"
  data-whop-currency="USD"
>
```

Werk de attributen bij wanneer de shopper een andere variant kiest of de getoonde prijs verandert. Voor aankopen hoef je niets te doen: Whop registreert ze op basis van de eigen betalingen.

## Waar de gegevens terechtkomen

Open **Websites** in je [dashboard](https://whop.com/dashboard) voor bezoekers, paginaweergaven en toegeschreven omzet per domein, of het [pixeldashboard](https://whop.com/dashboard) voor de volledige uitsplitsing per event. De eerste events verschijnen ongeveer een minuut na het bezoek.

> [!NOTE]
>
> Het pixelfragment zelf installeren wordt nog steeds ondersteund — de pixel van het platform controleert of er al een `window.whop` bestaat en doet dan niets, zodat er niets dubbel wordt geteld. Doe dat wanneer je site een andere scope nodig heeft dan het eigen bedrijf.

Voor een site op je eigen domein in plaats van `whop.site` installeer je het fragment handmatig: [De Whop-pixel installeren](https://docs.whop.com/nl/developer/ads/pixel.md).

## Volgende stappen

> [card] [Pixelreferentie](https://docs.whop.com/nl/developer/ads/pixel.md)
>
> Elk eventveld, klantmatching en server-side verzending.

> [card] [Betalingen accepteren](https://docs.whop.com/nl/developer/guides/accept-payments.md)
>
> Geef de pixel conversies om toe te schrijven.


## Related topics

- [Websitehosting op Whop](https://docs.whop.com/nl/developer/websites/hosting.md)
- [Een website bouwen met de CLI](https://docs.whop.com/nl/developer/websites/quickstart.md)
- [Een blueprint-bedrijf deployen](https://docs.whop.com/nl/developer/websites/blueprints.md)
