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

# EventsElement

> Elk event dat het account heeft gemeten — paginaweergaven, leads, aankopen en aangepaste pixel-events — als een ruwe, filterbare stroom. De rijen achter elke metriek: 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`.

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

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Tracking`](https://docs.whop.com/nl/elements/latest/tracking/overview). `accountId` en `accessToken` komen daarvandaan. Geef props en callbacks mee via de create-opties of als React-props.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Tracking /* options */>
        <EventsElement onPeriodChanged={(e) => console.log(e)} onAttributionModelChanged={(e) => console.log(e)} onFiltersChanged={(e) => console.log(e)} onPersonOpened={(e) => console.log(e)} />
      </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 */ });
  tracking.create('events', {
    onPeriodChanged: (e) => console.log(e),
    onAttributionModelChanged: (e) => console.log(e),
    onFiltersChanged: (e) => console.log(e),
    onPersonOpened: (e) => console.log(e)
  }).mount('#tracking-events');
</script>
```

Voorbeeldgegevens. [Open de Playground](https://docs.whop.com/nl/elements/latest/tracking/overview#playground).

## Props

**from** `string`

Zet het venster vast op een exact ISO 8601-tijdstip in plaats van de `period` van de handle — zo reproduceert een deeplink precies de rijen achter een metric. Stel zowel `from` als `to` in, of geen van beide. Standaard `""`.

**to** `string`

Het einde van het vastgezette venster, als ISO 8601-tijdstip. Standaard `""`.

**source** `string`

Beperk tot events die aan een verkeersbron zijn toegeschreven, als bronpad — `whop:adcamp_…:*` voor een van de campagnes van het account, `ext:*`, `referrer:*`, `direct`. Standaard `""`.

**utmSource** `string`

Beperk op de `utm_source` die het verkeer meedroeg. Standaard `""`.

**country** `string`

Beperk op ISO 3166-1 alpha-2-landcode, zoals `US` of `GB`. Standaard `""`.

**device** `string`

Beperk op apparaatklasse — `desktop`, `mobile`, `tablet`, `bot`. Standaard `""`.

**browser** `string`

Beperk op browsernaam. Standaard `""`.

**os** `string`

Beperk op naam van het besturingssysteem. Standaard `""`.

**identifier** `string`

Beperk tot het traject van één persoon — een persoons-ID, een e-mailadres of een bezoekerscookie. Als dit is ingesteld, negeert de lijst het venster en toont de hele geschiedenis. Het zoekvak past dit aan. Standaard `""`.

**event** `string`

Beperk op eventnaam — `payment.completed`, `pixel.lead`, `pixel.page` of `pixel.custom:<name>` voor een aangepast event. Dezelfde waarde waarmee de resultaataantallen in de advertentietabel linken. Standaard `""`.

## Events

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

### `onPeriodChanged`

De kijker heeft het venster verplaatst via de periodekiezer. Elk oppervlak onder dezelfde handle is al meegegaan; sla het op en geef het terug als `period`/`customRange` op de handle, anders wordt het venster bij de volgende mount gereset.

**payload** `object`

**eigenschappen**

**period** `string` *required*

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

**customRange** `object | null` *required*

**eigenschappen**

**from** `string` *required*

**to** `string` *required*

### `onAttributionModelChanged`

De kijker heeft via het menu Attribution in de filterrij gewijzigd welk contactmoment de toeschrijving krijgt. Elk oppervlak onder dezelfde handle heeft de toeschrijving al opnieuw berekend; sla het op en geef het terug als `attributionModel` op de handle, anders wordt het bij de volgende mount teruggezet.

**payload** `object`

**eigenschappen**

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

### `onFiltersChanged`

De kijker heeft een filter of de identifier-zoekopdracht gewijzigd. Bevat de volledige filterstatus, ongeacht wat er veranderde — spiegel deze in je eigen URL en geef hem terug als props om de weergave reproduceerbaar te maken.

**payload** `EventsFilterBag`

**eigenschappen**

**identifier** `string` *required*

**event** `string` *required*

**source** `string` *required*

**country** `string` *required*

**utmSource** `string` *required*

**device** `string` *required*

**browser** `string` *required*

**os** `string` *required*

**from** `string` *required*

**to** `string` *required*

### `onPersonOpened`

De kijker heeft op een persoonscel geklikt en de handle heeft geen `links.person` om te volgen. Toon er het `person`-element mee, bijvoorbeeld `createOverlay("person", { identifier: payload.personId })` (`personId` is de stabiele sleutel per persoon; `identifier` is de meest betekenisvolle voor mensen die het oppervlak heeft), of geef `links.person` mee op de handle om de cellen in plaats daarvan echte links te maken.

**payload** `object`

**eigenschappen**

**identifier** `string` *required*

**personId** `string` *required*

### `onLoaderStart`

Wordt uitgevoerd nadat het laadskelet voor het eerst is weergegeven en vóór `onReady`.

### `onReady`

Wordt uitgevoerd na de eerste volledige weergave van het element.

### `onError`

Wordt uitgevoerd wanneer het element niet kan laden of crasht. De fallback blijft zichtbaar. Gebruik `code` voor programmatische afhandeling. `sourceKey` identificeert een mislukte host-state-bron.

**e** `object`

**eigenschappen**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Methoden

Roep deze aan op de handle die `create` retourneert, of via een React-`ref`.

### `mount`

Mount het element in `target` en begint met laden. React-componenten mounten zichzelf.

**Parameters**

**target** `string | HTMLElement` *required*

### `destroy`

Verwijdert het element en geeft het frame en de abonnementen vrij. Je kunt het meerdere keren aanroepen. React verwijdert het element automatisch.

### `update`

Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de componentprops.

**Parameters**

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

## Styling

Dit element biedt geen klassenamen voor styling. Gebruik `appearance` (thema, accentkleur, variabelen) om het een andere stijl te geven.


## Related topics

- [Tracking](https://docs.whop.com/nl/elements/latest/tracking/overview.md)
- [Chat-element](https://docs.whop.com/nl/developer/guides/chat/chat-element.md)
- [ChatElement (Legacy)](https://docs.whop.com/nl/sdk/elements/chat-element.md)
