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

# Rapportering

> En annoncekontos rapportering: hvad den har brugt, og hvad der kom tilbage, over et tidsvindue, på det niveau du afgrænser til. Montér `chart`, `table` eller begge – de læser det samme tidsvindue, den samme tilskrivningsregel og det samme udvalg, så to flader side om side aldrig kan være uenige om, hvad de viser. `ads`-handlets `links`-konfiguration forbinder tabellens klik- og resultattal med dine egne sider – dem, hvor du har monteret `tracking`-namespacets `people` og `events`.

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

*Siden `v1.0.0`.*

Monteres inde i [`Ads`](https://docs.whop.com/da/elements/latest/ads/overview). Opret den for at få et handle, og montér derefter dens elementer på det handle. Kald `destroy()` for at fjerne sub-controlleren. Opret den igen for at få et nyt handle.

## Forhåndsvisning

En live, interaktiv demo af denne sub-controllers standardopstilling med eksempeldata:

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

## Indstillinger

Send disse til `ads.create('reporting', { … })`, eller som props på `<Reporting>` i React. Props, der injiceres af forælderen, vises aldrig her.

**period** `string`

Det tidsvindue, alle flader rapporterer på: `today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days`, `all_time` eller `custom` (kombinér det med `customRange`). Diagrammet har vælgeren, og den ændrer dette – så en vært kan styre vinduet og læse det tilbage 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 vindue 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"`

Valg af tidszone for alle rapporterede tal. Brug `account` for kontoens `preferences.ads_scheduling_timezone` eller `local` for seerens browsertidszone. Det er de eneste valg, diagrammet tilbyder. En vilkårlig IANA-tidszone kunne få vælgeren til at mærke data forkert og ville gå tabt, når seeren ændrer valget. For at rapportere i en anden tidszone skal du ændre kontoindstillingen. `account` falder tilbage til seerens tidszone, når kontoen ikke har nogen indstilling. Standard er `"account"`.

**currency** `string`

Trebogstavs ISO 4217-valutakode med små bogstaver for omregnede beløb, såsom `usd` eller `eur`. Hvis den ikke er sat, bruges kontoens `preferences.ads_reporting_currency` som standard. Standard er `""`.

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

Hvilket kontaktpunkt i en købers rejse der får æren: `last_touch`, standarden, eller `first_touch`. Under begge vinder et Whop-kontaktpunkt hvor som helst i rejsen Whop-kategorien – modellen vælger kun endepunkterne. Tabellen har vælgeren og ændrer dette, så en vært kan styre det og læse det tilbage fra `attributionModelChanged`. Standard er `"last_touch"`.

**campaignIds** `string[]`

Afgræns rapporteringen til disse annoncekampagner (`adcamp_…`). Tom rapporterer på hele kontoen. Tilsidesættes af `adGroupIds` eller `adIds`, når en af dem er sat. **Send ét ID for et præcist tal:** rapporterings-API'et afgrænser efter en enkelt kildesti, så hvis der angives mere end ét, rapporterer diagrammet kun på det første. Standard er `[]`.

**adGroupIds** `string[]`

Afgræns rapporteringen til disse annoncegrupper (`adgrp_…`). Har forrang for `campaignIds`. Samme forbehold om ét ID. Standard er `[]`.

**adIds** `string[]`

Afgræns rapporteringen til disse annoncer (`ad_…`). Det snævreste filter – har forrang for begge de andre. Samme forbehold om ét ID. Standard er `[]`.

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

Hvilken tabel `table`-elementet åbner på: `campaigns`, `ad-groups`, `ads` eller `all` for trafikkildevisningen. `all` rapporterer altid for hele kontoen – kildeserien findes kun på det niveau – så et filter, der sættes sammen med det, afgrænser tabellen, men ikke diagrammet. Standard er `"campaigns"`.

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

Hvilken trafik diagrammet rapporterer på, som kildestier – `whop:*` for annoncering købt gennem Whop, `ext:*` og `ext:<platform>:*` for annoncer kørt andre steder, `referrer:*` for organisk, `direct`, `other`. `null`, standarden, rapporterer kun på Whop-annoncering; `[]` rapporterer på alle kilder; et ikke-tomt array rapporterer på dem. En ANDEN akse end `campaignIds` og lignende, som afgrænser inden for Whop-annoncering – forbrugsafledte forhold forbliver tilskrevet Whop, uanset hvad dette er sat til, fordi forbruget kun nogensinde har købt Whop-annoncer. `table`-elementets All-fane ændrer det. Standard er `null`.

## Hændelser

Send callbacks i create-indstillingerne eller React-props.

### `onEditRequested`

Seeren bad om at redigere noget – en rækkemenu, en kladderække eller Edit ad i detaljeoverlayet. `campaignId` er altid til stede; `adGroupId` og `adId` afgrænser det til det, der blev klikket på. Udløses kun, når `useCampaignCreator` er slået fra; når det er slået til, åbner builderen i stedet over siden, og dette forbliver stille.

**payload** `AdsEditTarget`

**egenskaber**

**campaignId** `string` *required*

**adGroupId** `string`

**adId** `string`

## Metoder

Kald disse på sub-handlet fra `ads.create('reporting', { … })`.

### `update`

Fletter nye props og callbacks ind i sub-controlleren.

**Parametre**

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

### `destroy`

Ødelægger sub-controlleren og dens elementer og frigiver derefter dens eksklusive slot. Et senere `create("reporting")` starter forfra.

## Elementer

De elementer, denne sub-controller monterer. Hvert har sin egen side:

> [card] [ChartElement](https://docs.whop.com/da/elements/latest/ads/reporting-chart.md)
>
> En kontos resultater over et tidsvindue med en vælger til, hvad der skal plottes – forbrug, visninger, klik eller enhver konvertering, kontoen registrerer. Skrivebeskyttet.

> [card] [TableElement](https://docs.whop.com/da/elements/latest/ads/reporting-table.md)
>
> En annoncekontos kampagner, annoncegrupper og annoncer i én tabel med faner til at skifte mellem dem: vælg rækker for at afgrænse niveauet nedenunder, søg, sortér, opdel tallene, vælg dine kolonner, og sæt på pause, genoptag, duplikér eller slet direkte fra en række. Det tidsvindue, den rapporterer på, og de rækker, den er filtreret til, ligger på handlet, så et diagram monteret ved siden af rapporterer på præcis det samme.


## Related topics

- [Whop API-oversigt](https://docs.whop.com/da/api-reference/overview.md)
- [Udbetalinger og pengebevægelser](https://docs.whop.com/da/developer/payouts/overview.md)
- [ChartElement](https://docs.whop.com/da/elements/latest/ads/reporting-chart.md)
