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

# Reporting

> Les rapports d'un compte publicitaire : ce qu'il a dépensé et ce que cela a rapporté, sur une période, au niveau de détail que vous choisissez. Montez `chart`, `table` ou les deux — ils lisent la même période, la même règle d'attribution et la même sélection, de sorte que deux surfaces côte à côte ne peuvent jamais être en désaccord sur ce qu'elles affichent. La configuration `links` du handle `ads` relie les nombres de clics et de résultats du tableau à vos propres pages — celles où vous avez monté les éléments `people` et `events` du namespace `tracking`.

> [!NOTE]
>
> Cette page documente `@whop/elements@1.10.0` et `@whop/elements-react@1.10.0`.

*Depuis `v1.0.0`.*

Se monte à l'intérieur de [`Ads`](https://docs.whop.com/fr/elements/latest/ads/overview). Créez-le pour obtenir un handle, puis montez ses éléments sur ce handle. Appelez `destroy()` pour supprimer le sous-contrôleur. Créez-le à nouveau pour obtenir un nouveau handle.

## Aperçu

Une démo interactive en direct de la disposition par défaut de ce sous-contrôleur, avec des données d'exemple :

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

## Options

Transmettez-les à `ads.create('reporting', { … })`, ou comme props sur `<Reporting>` avec React. Les props injectées par le parent n'apparaissent jamais ici.

**period** `string`

La période couverte par chaque surface : `today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days`, `all_time` ou `custom` (à associer à `customRange`). Le graphique porte le sélecteur, qui modifie cette valeur — un hôte peut donc piloter la période et la relire via `periodChanged`. Par défaut : `"last_14_days"`.

L'une des valeurs `"today"`, `"yesterday"`, `"last_7_days"`, `"last_14_days"`, `"last_30_days"`, `"last_90_days"`, `"all_time"` ou `"custom"`.

**customRange** `object | null`

La période explicite, sous forme d'instants ISO 8601, utilisée lorsque `period` vaut `custom`. Ignorée sinon. Par défaut : `null`.

**propriétés**

**from** `string` *required*

**to** `string` *required*

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

Choix du fuseau horaire pour tous les chiffres rapportés. Utilisez `account` pour le `preferences.ads_scheduling_timezone` du compte ou `local` pour le fuseau horaire du navigateur du visiteur. Ce sont les seuls choix proposés par le graphique. Un fuseau IANA libre pourrait amener le sélecteur à étiqueter les données de manière incorrecte et serait perdu lorsque le visiteur modifie la sélection. Pour produire des rapports dans un autre fuseau horaire, modifiez le paramètre du compte. `account` revient au fuseau horaire du visiteur lorsque le compte n'a pas de paramètre. Par défaut : `"account"`.

**currency** `string`

Code de devise ISO 4217 à trois lettres en minuscules pour les montants convertis, comme `usd` ou `eur`. S'il n'est pas défini, il prend la valeur `preferences.ads_reporting_currency` du compte. Par défaut : `""`.

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

Le point de contact du parcours d'un acheteur qui reçoit l'attribution : `last_touch`, la valeur par défaut, ou `first_touch`. Dans les deux cas, un point de contact Whop situé n'importe où dans le parcours remporte la catégorie Whop — le modèle ne choisit que les extrémités. Le tableau porte le sélecteur et modifie cette valeur : un hôte peut donc la piloter et la relire via `attributionModelChanged`. Par défaut : `"last_touch"`.

**campaignIds** `string[]`

Limite les rapports à ces campagnes publicitaires (`adcamp_…`). Vide, les rapports portent sur l'ensemble du compte. Remplacé par `adGroupIds` ou `adIds` lorsque l'un d'eux est défini. **Transmettez un seul ID pour un chiffre exact :** l'API de reporting filtre selon un seul chemin de source, donc lorsque plusieurs ID sont fournis, le graphique ne porte que sur le premier. Par défaut : `[]`.

**adGroupIds** `string[]`

Limite les rapports à ces groupes d'annonces (`adgrp_…`). Prioritaire sur `campaignIds`. Même réserve concernant l'ID unique. Par défaut : `[]`.

**adIds** `string[]`

Limite les rapports à ces annonces (`ad_…`). Le filtre le plus restreint — prioritaire sur les deux autres. Même réserve concernant l'ID unique. Par défaut : `[]`.

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

Le tableau sur lequel s'ouvre l'élément `table` : `campaigns`, `ad-groups`, `ads`, ou `all` pour la vue par source de trafic. `all` porte toujours sur l'ensemble du compte — la série par source n'existe qu'à ce niveau — de sorte qu'un filtre défini en parallèle restreint le tableau mais pas le graphique. Par défaut : `"campaigns"`.

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

Le trafic sur lequel porte le graphique, sous forme de chemins de source — `whop:*` pour la publicité achetée via Whop, `ext:*` et `ext:<platform>:*` pour les annonces diffusées ailleurs, `referrer:*` pour l'organique, `direct`, `other`. `null`, la valeur par défaut, ne porte que sur la publicité Whop ; `[]` porte sur toutes les sources ; un tableau non vide porte sur celles-ci. Un axe DIFFÉRENT de `campaignIds` et consorts, qui filtrent au sein de la publicité Whop — les ratios dérivés des dépenses restent attribués à Whop quelle que soit cette valeur, car les dépenses n'ont jamais acheté que des annonces Whop. L'onglet All de l'élément `table` la modifie. Par défaut : `null`.

## Événements

Transmettez les callbacks dans les options de création ou dans les props React.

### `onEditRequested`

Le visiteur a demandé à modifier quelque chose — via un menu de ligne, une ligne de brouillon ou Edit ad dans l'overlay de détails. `campaignId` est toujours présent ; `adGroupId` et `adId` précisent l'élément cliqué. Émis uniquement lorsque `useCampaignCreator` est désactivé ; s'il est activé, le builder s'ouvre par-dessus la page et cet événement ne se déclenche pas.

**payload** `AdsEditTarget`

**propriétés**

**campaignId** `string` *required*

**adGroupId** `string`

**adId** `string`

## Méthodes

Appelez-les sur le sous-handle obtenu via `ads.create('reporting', { … })`.

### `update`

Fusionne de nouvelles props et de nouveaux callbacks dans le sous-contrôleur.

**Paramètres**

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

### `destroy`

Détruit le sous-contrôleur et ses éléments, puis libère son emplacement exclusif. Un `create("reporting")` ultérieur repart de zéro.

## Éléments

Les éléments montés par ce sous-contrôleur. Chacun a sa propre page :

> [card] [ChartElement](https://docs.whop.com/fr/elements/latest/ads/reporting-chart.md)
>
> Les performances d'un compte sur une période, avec un sélecteur de ce qu'il faut tracer — dépenses, impressions, clics ou toute conversion enregistrée par le compte. En lecture seule.

> [card] [TableElement](https://docs.whop.com/fr/elements/latest/ads/reporting-table.md)
>
> Les campagnes, groupes d'annonces et annonces d'un compte publicitaire dans un seul tableau, avec les onglets permettant de passer de l'un à l'autre : sélectionnez des lignes pour filtrer le niveau inférieur, recherchez, triez, ventilez les chiffres, choisissez vos colonnes, et mettez en pause, reprenez, dupliquez ou supprimez directement depuis une ligne. La période couverte et les lignes filtrées sont conservées sur le handle, de sorte qu'un graphique monté à côté porte exactement sur les mêmes données.


## Related topics

- [ChartElement](https://docs.whop.com/fr/elements/latest/ads/reporting-chart.md)
- [Versements et flux d'argent](https://docs.whop.com/fr/developer/payouts/overview.md)
- [TableElement](https://docs.whop.com/fr/elements/latest/ads/reporting-table.md)
