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

# CampaignCreatorElement

> Le builder de campagnes publicitaires : objectif et budget, groupes d'annonces avec leur ciblage et leur calendrier, et les annonces elles-mêmes avec leurs créations — tout le parcours jusqu'au lancement. S'ouvre vide pour créer une nouvelle campagne, ou sur une campagne existante lorsque vous transmettez `campaignId`. Il exécute également le vérificateur de pixel : un lancement est conditionné à ce que l'événement de conversion du groupe d'annonces soit actif sur l'URL de destination, et l'assistant `pixel-setup` s'ouvre dans cet élément pour corriger une installation manquante. Un lancement est aussi conditionné à la signature du contrat Whop Ads par le compte : si ce n'est pas le cas, le handle ouvre `ads-agreement` par-dessus le builder et le lancement se poursuit une fois le contrat signé. Les budgets sont saisis et affichés dans la `ads_reporting_currency` du compte — la devise déjà utilisée par ses rapports — puis convertis et facturés en USD au taux de change en vigueur. L'unique jeton que vous définissez sur le handle `ads` doit porter les scopes du pixel en plus des scopes de campagne — `ad_campaign:create` et `company:basic:read` — plutôt que d'utiliser un jeton distinct par élément.

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

*Depuis `v1.0.0`.*

S'ouvre sous forme de fenêtre modale depuis [`Ads`](https://docs.whop.com/fr/elements/latest/ads/overview) : `ads.createOverlay('campaign-creator')`. Transmettez les props et les callbacks dans les options de création.

> [!NOTE]
>
> Cet élément est **uniquement modal**. Ouvrez-le avec `createOverlay` ; il n'a pas de montage inline.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <CampaignCreatorElement onExited={(e) => console.log(e)} onLaunched={(e) => console.log(e)} />
      </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 */ });
  ads.createOverlay('campaign-creator', {
    onExited: (e) => console.log(e),
    onLaunched: (e) => console.log(e)
  }).open();
</script>
```

Données d'exemple. [Ouvrir le Playground](https://docs.whop.com/fr/elements/latest/ads/overview#playground).

## Props

**campaignId** `string`

La campagne (`adcamp_…`) à ouvrir. Une valeur vide crée une nouvelle campagne. Un brouillon s'ouvre là où il a été laissé ; une campagne lancée s'ouvre en mode édition. Par défaut : `""`.

**adGroupId** `string`

Le groupe d'annonces (`adgrp_…`) à mettre en avant à l'ouverture, au sein de `campaignId`. Ignoré lorsque la campagne ne contient pas ce groupe, et lorsque `campaignId` est vide. Par défaut : `""`.

**adId** `string`

L'annonce (`ad_…`) à mettre en avant à l'ouverture, au sein de `adGroupId`. Ignoré lorsque ce groupe ne contient pas cette annonce, et lorsque `adGroupId` est vide. Par défaut : `""`.

**initialStep** `"ads" | "ad-groups" | "campaign-settings"`

L'étape sur laquelle ouvrir : `campaign-settings`, `ad-groups` ou `ads`. Le tableau de bord la renseigne à partir de sa propre URL ; transmettez-la pour amener directement le propriétaire du compte sur la partie qu'il souhaite modifier. Lue une seule fois au montage — la modifier ensuite ne le fera pas changer d'étape. Par défaut : `"campaign-settings"`.

**externalMediaIds** `string[]`

ID de fichiers (`file_…`) téléversés par votre app via `POST /api/v1/files`, proposés dans la bibliothèque de créations du builder. Ils apparaissent en premier dans la liste de la bibliothèque, dans cet ordre, et tant qu'il y en a, les sélecteurs de médias s'ouvrent sur la bibliothèque plutôt que sur la zone de dépôt. Créez les fichiers avec la même clé API que celle qui émet l'`accessToken` du handle `ads` — le builder les relit en un seul lot (`GET /api/v1/files`), et la lecture de fichiers ne répond qu'à l'identifiant qui les a créés. Transmettez au maximum 250 ID, la limite de la lecture par lot. Un fichier apparaît une fois le traitement de son téléversement terminé ; un ID dont le traitement n'aboutit jamais, ou qui désigne autre chose qu'une image ou une vidéo, est ignoré. Transmettez de nouveaux ID avec `update({ externalMediaIds })` pour ajouter des médias à un builder déjà ouvert. Par défaut : `[]`.

## Événements

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

### `onExited`

Le propriétaire du compte a quitté le builder sans lancer de campagne. Rien n'a été supprimé — un brouillon de campagne, s'il a été commencé, est déjà enregistré. Un overlay s'est déjà fermé lorsque cet événement se déclenche ; réagissez-y si votre page en a besoin.

### `onLaunched`

Une campagne a été mise en ligne. `firstLaunch` signale la toute première campagne lancée par le compte, ce que le tableau de bord utilise pour afficher son état de bienvenue. Un overlay s'est déjà fermé ; c'est ici que vous redirigez vers la suite.

**payload** `object`

**propriétés**

**campaignId** `string` *required*

**firstLaunch** `boolean` *required*

### `onLoaderStart`

S'exécute après le premier affichage du squelette de chargement et avant `onReady`.

### `onReady`

S'exécute après le premier affichage complet de l'élément.

### `onError`

S'exécute lorsque l'élément ne parvient pas à se charger ou plante. L'affichage de repli reste visible. Utilisez `code` pour une gestion programmatique. `sourceKey` identifie une source d'état hôte en échec.

**e** `object`

**propriétés**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Méthodes

Appelez-les sur le handle renvoyé par `create`, ou via une `ref` React.

### `mount`

Monte l'élément dans `target` et démarre le chargement. Les composants React se montent eux-mêmes.

**Paramètres**

**target** `string | HTMLElement` *required*

### `destroy`

Supprime l'élément et libère son frame et ses abonnements. Vous pouvez l'appeler plusieurs fois. React supprime l'élément automatiquement.

### `update`

Fusionne de nouvelles props dans l'élément monté. Avec React, modifiez plutôt les props du composant.

**Paramètres**

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

## Style

Stylisez ces parties via `appearance.classes`. Utilisez le camel case ou le kebab case pour les noms de propriétés et incluez les unités. Les feuilles de style de la page ne peuvent pas atteindre le frame de l'élément. Le framework valide chaque déclaration avant de l'injecter.

| Classe | Cible |
| - | - |
| `.whop-PixelSetupSurface` | La racine de l'assistant de configuration du pixel — une étape à la fois |

```ts theme={null}
const ads = whop.ads.create({
  appearance: {
    classes: {
      'whop-PixelSetupSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

ads.update({
  appearance: {
    classes: { 'whop-PixelSetupSurface': { fontWeight: '700' } }
  }
});
```

Avec React, transmettez `appearance` à `<Ads>`. Définissez-la globalement avec `WhopElements({ appearance })`.


## Related topics

- [Ads](https://docs.whop.com/fr/elements/latest/ads/overview.md)
- [AdsAgreementElement](https://docs.whop.com/fr/elements/latest/ads/ads-agreement.md)
- [Reporting](https://docs.whop.com/fr/elements/latest/ads/reporting.md)
