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

# PixelSetupElement

> Installe le Whop Pixel et configure les événements de conversion : copiez le snippet, vérifiez sa présence sur une page, confirmez que les événements se déclenchent. Montez-le inline, ou dans votre propre overlay.

> [!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 [`Websites`](https://docs.whop.com/fr/elements/latest/websites/overview). Transmettez les props et les callbacks via les options de création ou les props React.

> [!NOTE]
>
> Vous pouvez monter cet élément **inline** (`create`) ou l'ouvrir sous forme d'overlay **modal** (`createOverlay`).

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Websites /* options */>
        <PixelSetupElement onRedirectUrlChanged={(e) => console.log(e)} onScanned={(e) => console.log(e)} onFinished={(e) => console.log(e)} onUrlSubmitted={(e) => console.log(e)} onVerifyLaunched={(e) => console.log(e)} onVerifyConnected={(e) => console.log(e)} onVerdict={(e) => console.log(e)} onEventVerified={(e) => console.log(e)} />
      </Websites>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const websites = window.WhopElements().websites.create({ /* options */ });
  websites.create('pixel-setup', {
    onRedirectUrlChanged: (e) => console.log(e),
    onScanned: (e) => console.log(e),
    onFinished: (e) => console.log(e),
    onUrlSubmitted: (e) => console.log(e),
    onVerifyLaunched: (e) => console.log(e),
    onVerifyConnected: (e) => console.log(e),
    onVerdict: (e) => console.log(e),
    onEventVerified: (e) => console.log(e)
  }).mount('#websites-pixel-setup');
</script>
```

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

## Props

**accountId** `string`

ID du compte, préfixé `biz_`, auquel appartient ce pixel. Obligatoire ; le snippet, les analyses et les invitations s'exécutent tous sur ce compte. Par défaut : `""`.

**accessToken** `string`

Un jeton à portée limitée pour les analyses et l'invitation de développeur. Les analyses nécessitent `company:basic:read` ; « Invite a developer » nécessite en plus `authorized_user:create`, et les préréglages d'événements lisent le compte avec `company:balance:read` (sans ce scope, l'assistant fonctionne quand même, avec une liste de préréglages générique). Lorsqu'aucune `destinationUrl` n'est transmise, le champ d'URL vide suggère aussi des pages issues des annonces et du trafic pixel du compte — ces lectures nécessitent `ad_campaign:basic:read` et `stats:read`, et sans elles le champ reste simplement vide. Générez-le sur votre serveur avec `POST /api/v1/access_tokens` et définissez-en un nouveau avant son expiration. Un autre élément qui ouvre cet assistant en son sein — comme le fait le `campaign-creator` des annonces — exécute ces appels avec son propre jeton : ajoutez donc ces scopes à cet unique jeton plutôt que d'en générer un second, car cet élément n'a aucun moyen de lire un identifiant défini ailleurs. S'il est omis, les appels utilisent la session du spectateur, qui ne répond qu'en same-origin.

**destinationUrl** `string`

La page à vérifier, analysée au montage. Laissez-la vide et l'assistant en demandera une. C'est aussi ce qui conditionne « Verify live » à l'étape des événements — ce bouton guide le propriétaire du compte à travers son propre funnel pour capter les événements qu'une analyse côté serveur ne peut pas voir, il n'apparaît donc qu'une fois une destination connue, définie ici ou indiquée dans l'assistant. Lue une seule fois au démarrage, donc `update()` ne changera pas de cible en cours de parcours — créez un nouveau montage pour une autre page. Par défaut : `""`.

**eventName** `string`

Facultatif. Un événement qui doit se déclencher sur cette page (`lead`, `schedule`, `view_content`, …) ; l'étape des événements reste bloquée jusqu'à ce qu'il soit détecté. S'il n'est pas défini, tous les événements sont proposés et aucun n'est obligatoire. Les événements que Whop enregistre côté serveur (`purchase`, `subscribe`, essais, étapes de checkout) sont ignorés. Lu une seule fois au démarrage. Par défaut : `""`.

**redirectUrl** `string`

Une URL vers laquelle la destination redirige, lorsque l'événement s'y déclenche à la place. Le propriétaire du compte peut aussi en définir une dans l'assistant — écoutez `redirectUrlChanged` et renvoyez-la la fois suivante. Par défaut : `""`.

**initialStep** `"events" | "install"`

L'étape à laquelle l'assistant s'ouvre : l'étape d'installation, ou directement `events` lorsque le pixel est déjà présent et que seul l'événement de conversion manque. Par défaut : `"install"`.

**showIntro** `boolean`

S'ouvrir sur l'écran d'accueil « pourquoi un pixel ». Désactivez-le lorsque le propriétaire du compte sait déjà pourquoi il est là — un parcours de campagne qui l'y envoie en plein lancement — et l'assistant s'ouvre directement sur l'étape d'installation. Par défaut : `true`.

**showInviteDeveloper** `boolean`

Proposer l'option « Invite a developer to install it ». Masquez-la lorsque les personnes utilisant votre intégration ne doivent pas inviter de membres dans l'équipe Whop qui se trouve derrière. Par défaut : `true`.

**showOptimizePrompt** `boolean`

Afficher l'écran « your pixel is live » après la validation d'une page, qui propose les événements de conversion comme étape suivante. Désactivez-le lorsque le propriétaire du compte est venu pour les événements eux-mêmes — une vérification réussie y mène alors directement au lieu de s'arrêter sur un écran qu'il passerait d'un clic. Par défaut : `true`.

**verifyFirst** `boolean`

Commencer par la vérification de la page plutôt que par les instructions d'installation : le champ d'URL (et ses suggestions) se trouve en haut, les options d'installation sont repliées sous un bouton « Pixel not installed yet? », et l'en-tête indique « Verify your pixel ». Destiné à un propriétaire de compte qui a déjà un pixel et cherche à comprendre pourquoi rien n'est attribué. Associez-le à `showIntro: false`. Par défaut : `false`.

## Événements

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

### `onRedirectUrlChanged`

Le propriétaire du compte a défini ou effacé une URL de redirection dans l'assistant. Enregistrez-la et renvoyez-la en tant que `redirectUrl` la fois suivante.

**payload** `object`

**propriétés**

**url** `string` *required*

### `onScanned`

Une analyse du pixel s'est terminée. Se déclenche pour chaque URL que l'assistant vérifie, afin que votre propre badge d'installation puisse la suivre. `primary` indique la page en cours de configuration : le vérificateur de funnel analyse tout ce que le propriétaire du compte liste d'autre, y compris d'autres noms d'hôte, alors filtrez sur ce champ avant de considérer qu'un résultat concerne son site. Vous n'en avez pas besoin pour garder un tableau `websites` à jour — monté sous ce handle, un site dont la mise en ligne est prouvée obtient déjà sa ligne en attente.

**payload** `object`

**propriétés**

**url** `string` *required*

**status** `"installed" | "missing" | "unreachable"` *required*

**installed** `boolean` *required*

**primary** `boolean` *required*

### `onFinished`

« Done » a été pressé. Revérifiez la page vous-même — cela indique que l'assistant est terminé, pas que vos exigences sont remplies.

### `onUrlSubmitted`

Le propriétaire du compte a indiqué la page à vérifier depuis l'assistant — saisie à la main ou choisie parmi les pages suggérées. Accessible uniquement lorsqu'aucune destination n'a été fournie au montage.

**payload** `object`

**propriétés**

**url** `string` *required*

**source** `"typed" | "suggested"` *required*

### `onVerifyLaunched`

« Verify live » a été pressé. `popupBlocked` signifie que le navigateur a refusé la fenêtre du funnel, de sorte que le parcours n'a jamais commencé.

**payload** `object`

**propriétés**

**url** `string` *required*

**popupBlocked** `boolean` *required*

### `onVerifyConnected`

La page du funnel a renvoyé un signal à l'assistant — le pixel y est chargé et le parcours est en cours.

**payload** `object`

**propriétés**

**url** `string` *required*

### `onVerdict`

Le parcours de vérification en direct est terminé. `ok` signifie qu'il n'y a aucune lacune de tracking ; sinon, `gaps` contient les codes des lacunes détectées par le parcours.

**payload** `object`

**propriétés**

**url** `string` *required*

**ok** `boolean` *required*

**gaps** `string[]` *required*

**eventsCaptured** `number` *required*

### `onEventVerified`

Le propriétaire du compte a parcouru son funnel avec « Verify live » et cet événement s'est déclenché — la preuve qu'il est configuré là où une analyse côté serveur ne peut pas accéder.

**payload** `object`

**propriétés**

**url** `string` *required*

**event** `string` *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\<PixelSetupElementProps\>` *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 websites = whop.websites.create({
  appearance: {
    classes: {
      'whop-PixelSetupSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

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

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


## Related topics

- [Sites web](https://docs.whop.com/fr/elements/latest/websites/overview.md)
- [CampaignCreatorElement](https://docs.whop.com/fr/elements/latest/ads/campaign-creator.md)
- [Premiers pas avec Elements](https://docs.whop.com/fr/elements/latest/getting-started.md)
