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

# Ads

> Een advertentieaccount. Koppel het aan een Whop-account met `accountId` — het onderliggende advertentieaccount wordt server-side toegewezen en is hier nooit zichtbaar — en mount daarna `reporting` voor wat het account heeft uitgegeven en wat het heeft opgeleverd, `campaign-creator` om een campagne te bouwen, of `ads-agreement` om de Whop Ads-overeenkomst te ondertekenen die voor een lancering vereist is.

> [!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, Ads } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        {/* mount elements here */}
      </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 */ });
</script>
```

## Opties

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

**accountId** `string`

Whop-account-ID, met voorvoegsel `biz_`, waarvan de advertenties worden gelezen. Verplicht; dit is geen advertentieaccount-ID. Standaard: `""`.

**accessToken** `string`

Een token met scopes waarmee elk oppervlak onder deze handle leest en schrijft. **Maak één token aan voor de hele handle, niet één per element.** Bepaal de scopes van elk element dat je gaat mounten, vraag ze aan op één token en stel dat hier in — de handle projecteert die ene set inloggegevens in het frame van elk element, dus een tweede token per oppervlak levert niets op en geeft je meerdere vervaldatums om bij te houden in plaats van één. Maak het aan op je server met `POST /api/v1/access_tokens` en stel met `update({ accessToken })` een nieuw token in voordat het verloopt. Alles mounten vereist `ad_campaign:read`/`:create`, `ad_group:read`, `ad:read`, `stats:read`, de scopes `:update`/`:delete` die de rijacties van de tabel gebruiken, `company:basic:read` voor de pixelcontroles die `campaign-creator` uitvoert, en `payment:charge` plus `user:email:read` om een kaart voor advertentie-uitgaven toe te voegen; de factureringsslots tonen opgeslagen kaarten en besteedbare wallets met `member:payment_methods:read`. Minder oppervlakken mounten kan met minder scopes — nog steeds op dat ene token. Zonder token gebruiken de aanroepen de eigen sessie van de kijker, die alleen same-origin werkt.

**links** `CrossLinksConfig`

Waarnaar de klik- en resultaataantallen van de rapportage-`table` op je site linken — meestal de pagina's waar je de elementen `people` en `events` uit de namespace `tracking` hebt gemount. `people` en `events` zijn absolute basis-URL's (`https://…`); de tabel voegt dezelfde queryparameters toe die die elementen als props accepteren (`?source=whop:adcamp_…:*&event=…&from=…&to=…`), zodat de doelpagina het element direct vanuit de URL kan hydrateren. Een relatieve URL zou worden opgelost ten opzichte van het frame van het element en wordt daarom als niet ingesteld behandeld; zonder ingestelde links worden de aantallen als gewone getallen weergegeven. Standaard: `{}`.

**properties**

**people** `string`

**events** `string`

**person** `string`

**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 door in de create-opties of als React-props.

### `onBillingChanged`

De betaalmethoden voor advertentie-uitgaven van het account zijn gewijzigd en de wijziging is opgeslagen. De slotwaarden zijn de ID's van de methoden zelf — `payt_…` voor een kaart, `ldgr_…` voor een saldo; een lege `backup` betekent dat er geen is ingesteld.

**payload** `object`

**properties**

**primary** `string` *required*

**backup** `string` *required*

### `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 Ads-handle uit `whop.ads.create({ … })` of `useAds()`.

### `update`

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

**Parameters**

**options** `Partial\<AdsOptions\>` *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] [Rapportage](https://docs.whop.com/nl/elements/latest/ads/reporting)
>
> 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. *(sub-controller, 3 elementen)*

> [card] [BillingSetupElement](https://docs.whop.com/nl/elements/latest/ads/billing-setup.md)
>
> Op welke betaalmethoden advertentie-uitgaven worden gefactureerd: een primaire methode die eerst wordt gebruikt, en een optionele back-up voor als die mislukt. Beide worden gekozen uit de methoden die al op het account zijn opgeslagen, en een keuze wordt direct opgeslagen — er is geen aparte verzendknop. Een kaart toevoegen opent een kaartformulier boven je pagina en keert daarna terug naar het slot dat erom vroeg. Het eigen saldo van het account verschijnt naast de kaarten, als het account een saldo heeft.

> [card] [CampaignCreatorElement](https://docs.whop.com/nl/elements/latest/ads/campaign-creator.md)
>
> De builder voor advertentiecampagnes: doel en budget, advertentiegroepen met hun targeting en planning, en de advertenties zelf met hun creatives — de hele flow tot aan de lancering. Opent leeg om een nieuwe campagne te bouwen, of op een bestaande campagne wanneer je `campaignId` doorgeeft. Het voert ook de pixelcontrole uit: een lancering kan pas doorgaan als het conversie-event van de advertentiegroep live is op de bestemmings-URL, en de wizard `pixel-setup` opent binnen dit element om een ontbrekende installatie te herstellen. Een lancering vereist ook dat het account de Whop Ads-overeenkomst heeft ondertekend: is dat niet zo, dan opent de handle `ads-agreement` boven de builder en gaat de lancering verder zodra die is ondertekend. Budgetten worden ingevoerd en weergegeven in de `ads_reporting_currency` van het account — de valuta die de rapporten al gebruiken — en omgerekend naar en gefactureerd in USD tegen de actuele wisselkoers. Het ene token dat je op de handle `ads` instelt, moet naast de campagnescopes ook de pixelscopes bevatten — `ad_campaign:create` en `company:basic:read` — in plaats van een apart token per element te gebruiken.

> [card] [AdsAgreementElement](https://docs.whop.com/nl/elements/latest/ads/ads-agreement.md)
>
> Ondertekent de Whop Ads Services and Payment Authorization Agreement voor een account. Het opslaan van de facturering voor advertentie-uitgaven van het account opent de overeenkomst; totdat een bevoegde vertegenwoordiger die ondertekent, kan er geen campagne worden gelanceerd. De ondertekenaar typt zijn volledige wettelijke naam en optioneel zijn functietitel, accepteert de voorwaarden, en de getypte handtekening wordt bij de overeenkomst gearchiveerd. Na ondertekening toont dit element wie heeft getekend en wanneer; zolang de facturering niet is ingesteld, valt er niets te ondertekenen en meldt het element dat. `campaign-creator` opent dit element zelf boven de builder wanneer een lancering een handtekening vereist, dus mount het alleen zelf als je vooraf ondertekening wilt aanbieden — bijvoorbeeld op een instellingen- of onboardingpagina.


## Related topics

- [Ads API](https://docs.whop.com/nl/api-reference/ads/ad.md)
- [List Ads](https://docs.whop.com/nl/api-reference/ads/list-ads.md)
- [AdsAgreementElement](https://docs.whop.com/nl/elements/latest/ads/ads-agreement.md)
