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

> En kontos sporede målgruppe: alle, som dens pixel har set, og hver event, de har udført. Afgræns den til en konto med `accountId`, og montér derefter `people`, `events` eller begge. De læser det samme tidsvindue og den samme kreditregel, så to flader side om side aldrig kan være uenige om, hvad de viser. `person` er dér, et klik på en af dem fører hen: én persons samlede profil, som kan monteres inline eller vises oven på din side. `links` kobler deres personlinks til dine egne sider.

> [!NOTE]
>
> Denne side dokumenterer `@whop/elements@1.10.0` og `@whop/elements-react@1.10.0`.

*Siden `v1.0.0`.*

## Playground

Sæt elementerne sammen med eksempeldata. Betjen kontrollerne, tilføj og arrangér elementer, og se events blive udløst live:

```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>
```

## Indstillinger

Angiv disse til `whop.tracking.create({ … })` eller som props på `<Tracking>` i React.

**accountId** `string`

Konto-ID med præfikset `biz_`, hvis personer og events dette læser. Påkrævet. Standard er `""`.

**accessToken** `string`

Et afgrænset token, som begge flader læser med. Udsted ét token til hele handlet på din server med `POST /api/v1/access_tokens`, og sæt et nyt med `update({ accessToken })`, før det udløber. Læsning af listerne kræver `member:basic:read` eller `company:basic:read`; filtermenuernes antal pr. valgmulighed bruger desuden `stats:read`, og People-tabellens filter for gemte målgrupper bruger `audience:basic:read` — uden dem viser menuerne blot færre valgmuligheder. Udeladt bærer kaldene seerens egen session, som kun besvares fra samme origin.

**links** `CrossLinksConfig`

Hvor personlinks fører hen på dit website. `person` er en skabelon for en absolut URL med to pladsholdere, som hver erstattes URL-kodet pr. række: `{personId}` er det stabile `prsn_…`-ID, identisk for den samme person på alle flader, så byg din side op omkring det og montér `person`-elementet dér; `{identifier}` er den mest menneskeligt meningsfulde identifikator, fladen har (et bruger-ID eller en e-mail, hvor den kendes), så den kan variere mellem flader. Den skal være absolut (`https://…`); en relativ URL ville blive opløst i forhold til elementets frame, så en sådan behandles som ikke sat. Hvis den ikke er sat, udløser et klik på en person i stedet `personOpened` på sit element, hvilket er signalet til at vise `person` oven på din side. Basis-URL'er for `people` og `events` accepteres for symmetri med ads-handlet, men intet under dette handle renderer dem. Standard er `{}`.

**egenskaber**

**people** `string`

**events** `string`

**person** `string`

**period** `string`

Det tidsvindue, begge flader dækker: `today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days`, `all_time` eller `custom` (kombinér det med `customRange`). Elementerne indeholder vælgeren og ændrer denne værdi; aflæs den igen fra `periodChanged`. Standard er `"last_14_days"`.

Én af `"today"`, `"yesterday"`, `"last_7_days"`, `"last_14_days"`, `"last_30_days"`, `"last_90_days"`, `"all_time"` eller `"custom"`.

**customRange** `object | null`

Det eksplicitte tidsvindue som ISO 8601-tidspunkter, der bruges, når `period` er `custom`. Ignoreres ellers. Standard er `null`.

**egenskaber**

**from** `string` *required*

**to** `string` *required*

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

Hvilken af to tidszoner tidsvinduet opløses i: `account`, kontoens egen planlægningszone, eller `local`, den zone, seerens browser befinder sig i. `account` falder tilbage til seerens egen, når kontoen ikke har angivet nogen. Standard er `"account"`.

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

Hvilket berøringspunkt i en persons rejse der får krediteringen ved filtrering efter kilde: `last_touch`, standarden, eller `first_touch`. Elementerne indeholder vælgeren og ændrer denne værdi, så en host kan styre den og aflæse den igen fra `attributionModelChanged`. Standard er `"last_touch"`.

**appearance** `Appearance`

Visuel tilpasning af denne gruppes elementer. Tilsidesætter den globale `WhopElements({ appearance })`. Ændr den live med `update({ appearance })`.

**locale** `WhopElementsLocale`

Sprog for UI-teksten i denne gruppes elementer. Sæt den til et af appens indbyggede sprog for at tilsidesætte den globale konfiguration. Enhver anden værdi falder tilbage til standardsproget.

## Events

Angiv callbacks i create-indstillingerne eller som React-props.

### `onLoadingChange`

Kører, når den samlede indlæsningstilstand ændres. Værdien er `true`, så længe et monteret element stadig indlæses.

**loading** `boolean`

## Metoder

Kald disse på Tracking-handlet fra `whop.tracking.create({ … })` eller `useTracking()`.

### `update`

Fletter nye handle-indstillinger ind i alle monterede elementer. I React ændrer du i stedet namespace-props.

**Parametre**

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

### `destroy`

Ødelægger alle elementer og sub-controllere, som dette handle har oprettet, fjerner controller-framen og frigiver dens abonnementer. Du kan kalde den mere end én gang, men et ødelagt handle afviser alle andre kald — opret et nyt handle for at starte forfra. React fjerner gruppen automatisk, når provideren afmonteres.

## Elementer

De elementer, som denne gruppe monterer. Hvert element har sin egen side:

> [card] [PeopleElement](https://docs.whop.com/da/elements/latest/tracking/people.md)
>
> Alle, kontoen har set — besøgende og kunder identificeret ud fra pixelaktivitet, med deres kilde, forbrug og aktivitetstællere. Søg, filtrér efter kilde, event, geografi eller enhed, sortér enhver kolonne, og bladr igennem. Et klik på en række følger `links.person`, når handlet konfigurerer det, og kommer ellers tilbage til dig som `personOpened`.

> [card] [EventsElement](https://docs.whop.com/da/elements/latest/tracking/events.md)
>
> Hver event, kontoen har målt — sidevisninger, leads, køb og brugerdefinerede pixel-events — som en rå, filtrerbar strøm. Rækkerne bag enhver metrik: filtrér efter event, kilde, geografi eller enhed inden for handlets tidsvindue, eller søg på én persons identifikator for at læse hele deres rejse. En personcelle følger `links.person`, når handlet konfigurerer det, og kommer ellers tilbage til dig som `personOpened`.

> [card] [PersonElement](https://docs.whop.com/da/elements/latest/tracking/person.md)
>
> Alt, hvad kontoen ved om én person: hvem de er, hvor de kom fra, hvad de har brugt, og hver event, de har udført, i rækkefølge. Den visning, et klik på en person fører til: montér den på den side, som `links.person` peger på, eller vis den oven på din egen side, når `people` eller `events` udløser `personOpened`. `identifier` accepterer enhver identifikator, en person er set under, så en `personOpened`-payload kan slås op her uændret.


## Related topics

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