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

# Rapportage

> De rapportage van een advertentieaccount: wat het heeft uitgegeven en wat het heeft opgeleverd, over een tijdvenster, op elk niveau waarop je filtert. Mount `chart`, `table` of beide — ze lezen hetzelfde tijdvenster, dezelfde toeschrijvingsregel en dezelfde selectie, zodat twee oppervlakken naast elkaar het nooit oneens kunnen zijn over wat ze tonen. De configuratie `links` van de handle `ads` koppelt de klik- en resultaataantallen van de tabel aan je eigen pagina's — de pagina's waar je `people` en `events` uit de namespace `tracking` hebt gemount.

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

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Ads`](https://docs.whop.com/nl/elements/latest/ads/overview). Maak het aan om een handle te krijgen en mount daarna de elementen ervan op die handle. Roep `destroy()` aan om de sub-controller te verwijderen. Maak het opnieuw aan om een nieuwe handle te krijgen.

## Voorbeeld

Een live, interactieve demo van de standaardindeling van deze sub-controller met voorbeeldgegevens:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <Reporting>
          <ChartElement />
          <TableElement />
        </Reporting>
      </Ads>
    </WhopElements>
  );
}
```

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

## Opties

Geef deze door aan `ads.create('reporting', { … })`, of als props op `<Reporting>` in React. Props die door de parent worden geïnjecteerd, staan hier nooit.

**period** `string`

Het tijdvenster waarover elk oppervlak rapporteert: `today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days`, `all_time` of `custom` (combineer dat met `customRange`). De grafiek bevat de kiezer en die wijzigt deze waarde — zo kan een host het tijdvenster aansturen en het teruglezen 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 tijdvenster, als ISO 8601-tijdstippen, gebruikt wanneer `period` `custom` is. Wordt anders genegeerd. Standaard: `null`.

**properties**

**from** `string` *required*

**to** `string` *required*

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

Tijdzonekeuze voor elk gerapporteerd cijfer. Gebruik `account` voor de `preferences.ads_scheduling_timezone` van het account of `local` voor de browsertijdzone van de kijker. Dit zijn de enige keuzes die de grafiek biedt. Een vrij ingevulde IANA-tijdzone zou de kiezer gegevens verkeerd kunnen laten labelen en zou verloren gaan wanneer de kijker de selectie wijzigt. Wil je in een andere tijdzone rapporteren, wijzig dan de accountinstelling. `account` valt terug op de tijdzone van de kijker als het account geen instelling heeft. Standaard: `"account"`.

**currency** `string`

ISO 4217-valutacode van drie kleine letters voor omgerekende bedragen, zoals `usd` of `eur`. Als deze niet is ingesteld, wordt de `preferences.ads_reporting_currency` van het account gebruikt. Standaard: `""`.

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

Welk contactmoment in de klantreis van een koper de toeschrijving krijgt: `last_touch`, de standaard, of `first_touch`. Bij beide wint een Whop-contactmoment ergens in de klantreis de Whop-categorie — het model kiest alleen de eindpunten. De tabel bevat de kiezer en wijzigt deze waarde, zodat een host die kan aansturen en teruglezen via `attributionModelChanged`. Standaard: `"last_touch"`.

**campaignIds** `string[]`

Beperk de rapportage tot deze advertentiecampagnes (`adcamp_…`). Leeg rapporteert over het hele account. Wordt overschreven door `adGroupIds` of `adIds` als een van beide is ingesteld. **Geef één ID door voor een exact cijfer:** de rapportage-API filtert op één bronpad, dus als er meer dan één is opgegeven, rapporteert de grafiek alleen over de eerste. Standaard: `[]`.

**adGroupIds** `string[]`

Beperk de rapportage tot deze advertentiegroepen (`adgrp_…`). Heeft voorrang op `campaignIds`. Hetzelfde voorbehoud over één ID geldt. Standaard: `[]`.

**adIds** `string[]`

Beperk de rapportage tot deze advertenties (`ad_…`). Het smalste filter — heeft voorrang op beide andere. Hetzelfde voorbehoud over één ID geldt. Standaard: `[]`.

**tab** `"ads" | "all" | "businesses" | "campaigns" | "ad-groups"`

Op welke tabel het element `table` opent: `campaigns`, `ad-groups`, `ads` of `all` voor de weergave per verkeersbron. `all` rapporteert altijd accountbreed — de bronreeks bestaat alleen op dat niveau — dus een filter dat ernaast is ingesteld, beperkt de tabel maar niet de grafiek. Standaard: `"campaigns"`.

**sources** `string[] | null`

Over welk verkeer de grafiek rapporteert, als bronpaden — `whop:*` voor advertenties die via Whop zijn ingekocht, `ext:*` en `ext:<platform>:*` voor advertenties die elders draaien, `referrer:*` voor organisch, `direct`, `other`. `null`, de standaard, rapporteert alleen over Whop-advertenties; `[]` rapporteert over elke bron; een niet-lege array rapporteert over die bronnen. Dit is een ANDERE as dan `campaignIds` en verwante opties, die binnen Whop-advertenties filteren — ratio's die van uitgaven zijn afgeleid, blijven aan Whop toegeschreven, ongeacht deze instelling, omdat uitgaven alleen Whop-advertenties hebben ingekocht. Het tabblad All van het element `table` wijzigt deze waarde. Standaard: `null`.

## Events

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

### `onEditRequested`

De kijker wilde iets bewerken — via een rijmenu, een conceptrij of Edit ad in de detailoverlay. `campaignId` is altijd aanwezig; `adGroupId` en `adId` beperken het tot waarop is geklikt. Wordt alleen geactiveerd wanneer `useCampaignCreator` uit staat; staat het aan, dan opent in plaats daarvan de builder boven de pagina en blijft dit event stil.

**payload** `AdsEditTarget`

**properties**

**campaignId** `string` *required*

**adGroupId** `string`

**adId** `string`

## Methoden

Roep deze aan op de sub-handle uit `ads.create('reporting', { … })`.

### `update`

Voegt nieuwe props en callbacks samen in de sub-controller.

**Parameters**

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

### `destroy`

Vernietigt de sub-controller en de elementen ervan, en geeft daarna het exclusieve slot vrij. Een latere `create("reporting")` begint opnieuw.

## Elementen

De elementen die deze sub-controller mount. Elk element heeft een eigen pagina:

> [card] [ChartElement](https://docs.whop.com/nl/elements/latest/ads/reporting-chart.md)
>
> De prestaties van een account over een tijdvenster, met een kiezer voor wat er wordt geplot — uitgaven, impressies, klikken of elke conversie die het account registreert. Alleen-lezen.

> [card] [TableElement](https://docs.whop.com/nl/elements/latest/ads/reporting-table.md)
>
> De campagnes, advertentiegroepen en advertenties van een advertentieaccount in één tabel, met tabbladen om ertussen te wisselen: kies rijen om het onderliggende niveau te filteren, zoek, sorteer, splits de cijfers uit, kies je kolommen, en pauzeer, hervat, dupliceer of verwijder direct vanuit een rij. Het tijdvenster waarover gerapporteerd wordt en de rijen waarop gefilterd is, staan op de handle, zodat een grafiek die ernaast is gemount over precies hetzelfde rapporteert.


## Related topics

- [ChartElement](https://docs.whop.com/nl/elements/latest/ads/reporting-chart.md)
- [TableElement](https://docs.whop.com/nl/elements/latest/ads/reporting-table.md)
- [Uitbetalingen & geldbewegingen](https://docs.whop.com/nl/developer/payouts/overview.md)
