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

# Tracking

> Het gevolgde publiek van een account: iedereen die de pixel heeft gezien, en elk event dat die personen hebben uitgevoerd. Beperk het tot een account met `accountId` en mount daarna `people`, `events` of beide. Ze lezen hetzelfde venster en dezelfde toeschrijvingsregel, dus twee oppervlakken naast elkaar kunnen het nooit oneens zijn over wat ze tonen. `person` is waar een klik op een van beide naartoe leidt: het volledige dossier van één persoon, inline te mounten of boven je pagina te tonen. `links` koppelt hun persoonslinks aan je eigen pagina's.

> [!NOTE]
>
> Deze pagina documenteert `@whop/elements@1.10.0` en `@whop/elements-react@1.10.0`.

*Sinds `v1.0.0`.*

## Playground

Stel de elementen samen met voorbeeldgegevens. Bedien de besturingselementen, voeg elementen toe en rangschik ze, en zie events live binnenkomen:

```tsx React theme={null}
import { WhopElements, Tracking } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Tracking /* options */>
        {/* mount elements here */}
      </Tracking>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const tracking = window.WhopElements().tracking.create({ /* options */ });
</script>
```

## Opties

Geef deze door aan `whop.tracking.create({ … })`, of als props op `<Tracking>` in React.

**accountId** `string`

Account-ID, met prefix `biz_`, waarvan dit de personen en events leest. Verplicht. Standaard `""`.

**accessToken** `string`

Een token met scopes waarmee beide oppervlakken lezen. Maak op je server één token aan voor de hele handle met `POST /api/v1/access_tokens` en stel met `update({ accessToken })` een nieuw token in voordat het verloopt. Het lezen van de lijsten vereist `member:basic:read` of `company:basic:read`; de optieaantallen in de filtermenu's gebruiken daarnaast `stats:read`, en het filter voor opgeslagen doelgroepen van de People-tabel gebruikt `audience:basic:read` — zonder die scopes tonen de menu's gewoon minder opties. Zonder token gebruiken de aanroepen de eigen sessie van de kijker, die alleen same-origin werkt.

**links** `CrossLinksConfig`

Waar persoonslinks op je site naartoe leiden. `person` is een sjabloon voor een absolute URL met twee placeholders, die per rij URL-gecodeerd worden vervangen: `{personId}` is de stabiele `prsn_…`-ID, identiek voor dezelfde persoon op elk oppervlak, dus baseer je pagina daarop en mount daar het `person`-element; `{identifier}` is de meest betekenisvolle identifier voor mensen die het oppervlak heeft (een gebruikers-ID of e-mailadres indien bekend), dus die kan per oppervlak verschillen. De URL moet absoluut zijn (`https://…`); een relatieve URL zou worden opgelost ten opzichte van het frame van het element en wordt daarom als niet ingesteld behandeld. Zonder instelling activeert een klik op een persoon in plaats daarvan `personOpened` op het element, het signaal om `person` over je pagina te tonen. Basis-URL's voor `people` en `events` worden geaccepteerd voor symmetrie met de ads-handle, maar niets onder deze handle geeft ze weer. Standaard `{}`.

**eigenschappen**

**people** `string`

**events** `string`

**person** `string`

**period** `string`

Het venster dat beide oppervlakken beslaan: `today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days`, `all_time` of `custom` (combineer dit met `customRange`). De elementen bevatten de kiezer en passen dit aan; lees het terug via `periodChanged`. Standaard `"last_14_days"`.

Een van `"today"`, `"yesterday"`, `"last_7_days"`, `"last_14_days"`, `"last_30_days"`, `"last_90_days"`, `"all_time"` of `"custom"`.

**customRange** `object | null`

Het expliciete venster, als ISO 8601-tijdstippen, gebruikt wanneer `period` `custom` is. Wordt anders genegeerd. Standaard `null`.

**eigenschappen**

**from** `string` *required*

**to** `string` *required*

**timezone** `"account" | "local"`

In welke van twee zones het venster wordt bepaald: `account`, de eigen planningszone van het account, of `local`, de zone waarin de browser van de kijker zich bevindt. `account` valt terug op de eigen zone van de kijker wanneer het account er geen heeft ingesteld. Standaard `"account"`.

**attributionModel** `"last_touch" | "first_touch"`

Welk contactmoment in het traject van een persoon de toeschrijving krijgt bij filteren op bron: `last_touch`, de standaard, of `first_touch`. De elementen bevatten de kiezer en passen dit aan, zodat een host het kan aansturen en terug kan lezen via `attributionModelChanged`. Standaard `"last_touch"`.

**appearance** `Appearance`

Visuele aanpassing voor de elementen van deze groep. Overschrijft de globale `WhopElements({ appearance })`. Wijzig het live met `update({ appearance })`.

**locale** `WhopElementsLocale`

Locale voor de UI-tekst van de elementen in deze groep. Stel deze in op een van de ingebouwde locales van de app om de globale configuratie te overschrijven. Elke andere waarde valt terug op de standaardlocale.

## Events

Geef callbacks mee in de create-opties of als React-props.

### `onLoadingChange`

Wordt uitgevoerd wanneer de gegroepeerde laadstatus verandert. De waarde is `true` zolang een van de gemounte elementen nog laadt.

**loading** `boolean`

## Methoden

Roep deze aan op de Tracking-handle uit `whop.tracking.create({ … })` of `useTracking()`.

### `update`

Voegt nieuwe handle-opties samen in elk gemount element. Wijzig in React in plaats daarvan de props van de namespace.

**Parameters**

**options** `Partial\<TrackingOptions\>` *required*

### `destroy`

Vernietigt elk element en elke sub-controller die deze handle heeft aangemaakt, verwijdert het controllerframe en geeft de abonnementen ervan vrij. Je kunt dit meer dan eens aanroepen, maar een vernietigde handle weigert elke andere aanroep — maak een nieuwe handle aan om opnieuw te beginnen. React verwijdert de groep automatisch wanneer de provider wordt unmount.

## Elementen

De elementen die deze groep mount. Elk element heeft een eigen pagina:

> [card] [PeopleElement](https://docs.whop.com/nl/elements/latest/tracking/people.md)
>
> Iedereen die het account heeft gezien — bezoekers en klanten die uit pixelactiviteit zijn herleid, met hun bron, uitgaven en activiteitstellers. Zoek, filter op bron, event, geografie of apparaat, sorteer elke kolom en blader door de pagina's. Een klik op een rij volgt `links.person` wanneer de handle dat configureert, en komt anders bij jou terug als `personOpened`.

> [card] [EventsElement](https://docs.whop.com/nl/elements/latest/tracking/events.md)
>
> Elk event dat het account heeft gemeten — paginaweergaven, leads, aankopen en aangepaste pixel-events — als een ruwe, filterbare stroom. De rijen achter elke metric: filter op event, bron, geografie of apparaat binnen het venster van de handle, of zoek op de identifier van één persoon om diens hele traject te lezen. Een persoonscel volgt `links.person` wanneer de handle dat configureert, en komt anders bij jou terug als `personOpened`.

> [card] [PersonElement](https://docs.whop.com/nl/elements/latest/tracking/person.md)
>
> Alles wat het account over één persoon weet: wie die persoon is, waar die vandaan kwam, wat die heeft uitgegeven en elk event dat die heeft uitgevoerd, op volgorde. De weergave waar een klik op een persoon naartoe leidt: mount deze op de pagina waarnaar `links.person` verwijst, of toon deze over je eigen pagina wanneer `people` of `events` `personOpened` activeren. `identifier` accepteert elke identifier waaronder een persoon is gezien, zodat een `personOpened`-payload hier ongewijzigd wordt opgelost.


## Related topics

- [TrackingElement](https://docs.whop.com/nl/elements/latest/delivery/tracking.md)
- [Retrieve Account Customer Tracking](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-customer-tracking.md)
- [Look Up Shipment](https://docs.whop.com/nl/api-reference/shipments/look-up-shipment.md)
