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

# Installer le pixel Whop

> Ajoutez le pixel Whop à chaque page de votre tunnel, puis envoyez des événements pour que vos publicités soient créditées des prospects et des ventes.

Le pixel Whop est un extrait JavaScript que vous ajoutez à votre site web. Il mesure les pages vues, relie les visiteurs à leurs achats et attribue les événements de conversion à vos publicités. Une fois installé, votre site web apparaîtra sur la [page Websites](https://whop.com/dashboard/websites).

## Installer le pixel Whop

## 1. Obtenez l'ID de votre compte Whop

Trouvez-le depuis votre [tableau de bord Whop](https://whop.com/dashboard/) : il s'agit de la partie de l'URL qui suit `dashboard/` et commence par `biz_`. Il ressemble à `biz_xxxxxxxxxxxxx`.

![URL du tableau de bord Whop dans la barre d'adresse du navigateur, avec l'ID du compte souligné après dashboard](https://mintcdn.com/whop/i81Det37UaKELkrh/images/dashboard-url.png?fit=max\&auto=format\&n=i81Det37UaKELkrh\&q=85\&s=f8dce6ea378318d4c89f7bce9239605d)

## 2. Installez l'extrait

Collez cet extrait dans le `<head>` de **chaque page** de votre tunnel — pages de destination, publireportages, pages de paiement et pages de remerciement, pas seulement votre page d'accueil. Remplacez `biz_xxxxxxxxxxxxx` par l'ID de votre propre compte.

```html Pixel snippet theme={null}
<script>
!function(w,d,s,u,n,a,b){if(w[n])return;a=w[n]={q:[],t:+new Date,s:[],o:u,track:function(){a.q.push([+new Date].concat([].slice.call(arguments)))},setScope:function(){a.s=[].slice.call(arguments).filter(function(x){return typeof x==="string"});a.q.push([+new Date,"setScope"].concat(a.s))},scope:function(){var c=[].slice.call(arguments);return{track:function(){a.q.push([+new Date].concat([].slice.call(arguments)).concat([{__scope:c}]))}}}};b=d.createElement(s);b.async=1;b.src=u+"/s.js";d.getElementsByTagName(s)[0].parentNode.insertBefore(b,d.getElementsByTagName(s)[0])}(window,document,"script","https://t.whop.tw","whop");
whop.setScope("biz_xxxxxxxxxxxxx");
whop.track("page");
</script>
```

**Si vous diffusez des publicités depuis plusieurs comptes Whop**, ajoutez chaque ID de compte à `setScope`. Le pixel envoie chaque événement à tous les comptes listés, de sorte que chaque tableau de bord reçoit les pages vues dont il a besoin pour attribuer les conversions à ses campagnes.

```javascript Send events to multiple accounts theme={null}
whop.setScope("biz_xxxxxxxxxxxxx", "biz_yyyyyyyyyyyyy", "biz_zzzzzzzzzzzzz");
```

Whop conserve les données séparément pour chaque compte. Un compte absent de `setScope` ne reçoit aucun événement de cette page. Si vous [envoyez également des événements depuis votre serveur](https://docs.whop.com/fr/developer/ads/events-api.md), envoyez chacun d'eux une fois par compte, avec l'ID de ce compte.

Vous construisez votre tunnel sur une plateforme plutôt qu'en HTML brut ? Utilisez le guide d'installation dédié au lieu de coller l'extrait dans un bloc de texte du constructeur de pages.

| Si vous utilisez | Suivez |
| - | - |
| ClickFunnels | [Installer le pixel Whop sur ClickFunnels](https://docs.whop.com/fr/developer/ads/platforms/clickfunnels.md) |
| GoHighLevel | [Installer le pixel Whop sur GoHighLevel](https://docs.whop.com/fr/developer/ads/platforms/gohighlevel.md) |
| Kajabi | [Installer le pixel Whop sur Kajabi](https://docs.whop.com/fr/developer/ads/platforms/kajabi.md) |
| WordPress | [Installer le pixel Whop sur WordPress](https://docs.whop.com/fr/developer/ads/platforms/wordpress.md) |
| WooCommerce | [Installer le pixel Whop sur WooCommerce](https://docs.whop.com/fr/developer/ads/platforms/woocommerce.md) |
| Shopify | [Installer le pixel Whop sur Shopify](https://docs.whop.com/fr/developer/ads/platforms/shopify.md) |
| WebinarJam | [Installer le pixel Whop sur WebinarJam](https://docs.whop.com/fr/developer/ads/platforms/webinarjam.md) |
| iClosed | [Installer le pixel Whop avec iClosed](https://docs.whop.com/fr/developer/ads/platforms/iclosed.md) |
| Calendly | [Installer le pixel Whop avec Calendly](https://docs.whop.com/fr/developer/ads/platforms/calendly.md) |

## 3. Suivez les événements

Si votre tunnel comporte des étapes importantes en dehors du paiement Whop, comme un formulaire de prospect, une prise de rendez-vous ou une candidature, ajoutez des appels `whop.track` pour suivre ces événements.

```html Tracking events theme={null}
<script>
  whop.track("lead");                                      // a standard event
  whop.track("schedule", { value: 50, currency: "USD" });  // optionally with a value
  whop.track("quiz_completed");                            // or your own event name
</script>
```

L'emplacement de l'appel dépend de ce qui se passe après l'action :

**a. L'action redirige** (un formulaire qui envoie le visiteur vers une page de remerciement)

Déclenchez l'événement sur la page où il arrive. L'appel se place dans le HTML de cette page — ou dans le champ de code d'un constructeur de pages — encadrez-le donc avec des balises `<script>`. L'extrait du pixel doit également être installé sur cette page.

```html Track on a thank-you page theme={null}
<script>
  whop.track("lead");
</script>
```

**b. L'action reste sur la même page** (un formulaire qui affiche un message de réussite intégré)

Déclenchez l'événement dans le gestionnaire de réussite de l'action. Vous êtes déjà dans du JavaScript, donc pas de balises `<script>`.

```javascript Track on submit (no redirect) theme={null}
form.addEventListener("submit", async (e) => {
  e.preventDefault();
  await submitForm();
  whop.track("lead");
});
```

**Il est important d'inclure toutes les informations dont vous disposez sur le client à chaque étape du tunnel.** Si vous recueillez un prospect avec un nom, une adresse e-mail et un numéro de téléphone, incluez-les dans l'événement envoyé à Whop.

```html Lead with customer details theme={null}
<script>
  whop.track("lead", { name: "John Doe", email: "johndoe@example.com", phone: "555-555-1234" });
</script>
```

## Événements standard

Le pixel Whop inclut un ensemble de noms d'événements standard pour les étapes courantes d'un tunnel. Chacun accepte une `value` (nombre) et une `currency` (code ISO 4217) facultatives. L'exception est `purchase`, qui exige une `value` positive.

| Événement | Quand le déclencher |
| - | - |
| `lead` | Un visiteur soumet ses coordonnées ou un formulaire d'inscription |
| `schedule` | Un visiteur réserve un appel ou un rendez-vous |
| `submit_application` | Un visiteur soumet une candidature |
| `contact` | Un visiteur démarre une conversation ou une demande de contact |
| `complete_registration` | Une inscription ou un enregistrement est finalisé |
| `view_content` | Un visiteur consulte une page ou un contenu clé |
| `add_to_cart` | Un visiteur ajoute un article à un panier |
| `initiate_checkout` | Un visiteur arrive sur la page de paiement |
| `purchase` | Une vente est finalisée sur [votre propre page de paiement](#track-sales-on-your-own-checkout) — uniquement pour les paiements effectués en dehors de Whop. Whop suit automatiquement son propre paiement |

Passez `variant_id` (préfixé par `plan_`) et `product_id` (préfixé par `prod_`) pour indiquer la variante et le produit Whop concernés par un événement, généralement sur `view_content` et `add_to_cart` ([Suivre les produits et les paniers](https://docs.whop.com/fr/developer/websites/tracking.md#track-products-and-carts) montre une page produit qui fait les deux) :

```javascript theme={null}
whop.track("add_to_cart", {
  variant_id: "plan_xxxxxxxxxxxxx",
  product_id: "prod_xxxxxxxxxxxxx",
  value: 49,
  currency: "USD",
});
```

## Événements personnalisés

Si les événements standard de Whop ne couvrent pas les besoins de votre tunnel, ou si vous souhaitez suivre des étapes spécifiques du parcours client, vous pouvez déclencher des événements personnalisés.

```html Custom event theme={null}
<script>
  whop.track("watched_vsl");
  whop.track("quiz_completed", { value: 25, currency: "USD" });
</script>
```

Choisissez des noms courts et stables, et réutilisez un petit ensemble. Whop enregistre les noms jusqu'à 250 caractères.

Les événements personnalisés suivent les mêmes règles d'emplacement que les événements standard — voir [Suivez les événements](#track-events).

## Suivre les ventes sur votre propre page de paiement

Si vous vendez via votre propre page de paiement plutôt que celle de Whop, déclenchez un événement `purchase` lorsqu'une vente est finalisée. `value` est obligatoire — Whop rejette un événement d'achat sans valeur positive, car les plateformes publicitaires ne peuvent pas optimiser vers une vente sans montant. `currency` est facultatif et vaut USD par défaut.

```html Purchase on your own checkout theme={null}
<script>
  whop.track("purchase", {
    value: 149.99,
    currency: "USD",
    event_id: "order_8412",
    email: "visitor@example.com",
  });
</script>
```

Whop les transmet aux plateformes publicitaires en tant qu'événement Purchase standard, afin qu'une campagne optimisée pour les achats en tire des enseignements. Dans les rapports Whop, ils apparaissent comme des achats externes, séparés des achats — les achats et le ROAS ne comptabilisent que les paiements traités par Whop.

> [!WARNING]
>
> Ne déclenchez jamais `purchase` pour une vente traitée par Whop. Whop signale déjà cette vente à la plateforme publicitaire, elle serait donc comptée deux fois.

## Attribuer un ID à chaque événement

Passez un `event_id` avec tout événement susceptible d'atteindre Whop plus d'une fois. Par exemple, si vous déclenchez un événement à l'arrivée sur une page de remerciement, assurez-vous que cet événement est déclenché une fois par conversion réelle, et non une fois par page vue. Whop compte chaque paire `event_name` et `event_id` une seule fois : une nouvelle tentative, une actualisation de la page ou la même conversion envoyée depuis deux endroits sont fusionnées en un seul événement.

```html Event with an ID theme={null}
<script>
  whop.track("lead", { event_id: "lead_8f21c0" }); // one visitor's form submission
  whop.track("lead", { event_id: "lead_2b94de" }); // a different visitor's
</script>
```

**L'ID identifie un seul événement, pas le type d'événement.** Chaque prospect a besoin du sien. Si vous envoyez `"lead"` comme ID pour chaque prospect, Whop les traite tous comme un seul événement, et des centaines de prospects apparaissent comme un seul.

Utilisez une valeur dont votre propre système dispose déjà pour cette action précise — un ID de prospect, un numéro de commande ou un ID de soumission de formulaire. Ne réutilisez cette valeur que lorsque vous renvoyez cette même action. Une nouvelle tentative compte comme la même action. Il en va de même pour la même conversion reproduite depuis votre serveur. Une valeur inventée au moment du déclenchement est nouvelle à chaque fois et n'empêchera donc pas les doublons.

Si la même conversion peut provenir à la fois de votre site web et de votre serveur, envoyez le même `event_id` depuis les deux afin qu'elle soit enregistrée comme un seul événement.

## Joindre les informations client

Envoyez toujours autant d'informations client que vous en avez. Cela aide Whop à associer les événements aux clients et à améliorer le suivi des conversions.

Ces champs peuvent être joints à n'importe quel type d'événement et sont facultatifs. N'envoyez que les champs dont vous disposez.

```html Lead with customer fields theme={null}
<script>
  whop.track("lead", {
    email: "visitor@example.com",
    first_name: "Jane",
    last_name: "Doe",
    name: "Jane Doe",
    phone: "+15551234567",
    external_id: "customer_123",
    city: "New York",
    state: "NY",
    postal_code: "10001",
    country: "US",
  });
</script>
```

| Champ | Description |
| - | - |
| `email` | Adresse e-mail du visiteur |
| `first_name` | Prénom du visiteur |
| `last_name` | Nom de famille du visiteur |
| `name` | Nom complet affiché du visiteur |
| `phone` | Numéro de téléphone du visiteur |
| `external_id` | Votre propre ID d'utilisateur/de client |
| `city` | Ville du visiteur |
| `state` | État ou région du visiteur |
| `postal_code` | Code postal du visiteur |
| `country` | Pays du visiteur |

> [!WARNING]
>
> Envoyez-les en texte brut. Une adresse e-mail hachée est ignorée, car ce n'est pas une adresse valide. Un numéro de téléphone haché est enregistré sous forme de chiffres sans signification et ne correspond à personne.

> [!NOTE]
>
> **Ne suivez pas les paiements, abonnements ou essais Whop.** Whop enregistre côté serveur, sans aucune configuration, chaque consultation de page de paiement, achat, abonnement et début d'essai sur sa propre page de paiement. Le pixel n'accepte pas les doublons. N'envoyez que les événements que Whop ne peut pas voir : les prospects et les réservations sur votre propre infrastructure, et les [ventes sur votre propre page de paiement](#track-sales-on-your-own-checkout).


## Related topics

- [Installer le pixel Whop sur Shopify](https://docs.whop.com/fr/developer/ads/platforms/shopify.md)
- [Installer le pixel Whop avec Calendly](https://docs.whop.com/fr/developer/ads/platforms/calendly.md)
- [Installer le pixel Whop sur Kajabi](https://docs.whop.com/fr/developer/ads/platforms/kajabi.md)
