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

# Suivre les visiteurs

> Les sites sur whop.site incluent le pixel Whop avec un suivi automatique des pages vues et du checkout. Ajoutez des appels whop.track pour les leads, les réservations et les événements personnalisés.

Whop injecte le pixel dans chaque page HTML servie par votre site, limité à l'entreprise de l'app, et déclenche une page vue. Il n'y a aucun extrait de code à coller ni aucun ID de compte à configurer.

| Suivi automatiquement | Vous ajoutez un appel `whop.track` |
| - | - |
| Pages vues | Formulaires de lead, réservations d'appels, candidatures |
| Vues du checkout Whop | Quiz, VSL visionnées jusqu'au bout, tout ce qui se trouve sur vos propres pages |
| Achats, abonnements, essais | Étapes que les données de paiement de Whop ne peuvent pas voir |

## Suivre vos propres événements

`window.whop` existe avant que le code de votre app ne s'exécute : appelez-le donc directement :

```javascript theme={null}
whop.track("lead");
whop.track("schedule", { value: 50, currency: "USD" });
whop.track("watched_vsl");
```

Les noms d'événements standard — `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `initiate_checkout` — acceptent chacun, de manière facultative, une `value` et une `currency`. Tout autre nom fonctionne également, et apparaît sous ce nom dans les rapports.

Déclenchez l'événement là où l'action se termine : dans le gestionnaire de succès si la page reste affichée, ou sur la page de confirmation s'il y a une redirection.

> [!TIP]
>
> Transmettez un `event_id` pour tout ce qui pourrait arriver deux fois — une nouvelle tentative, une actualisation, ou la même conversion reproduite depuis votre serveur. Whop compte chaque paire nom-ID une seule fois. Utilisez un ID dont votre système dispose déjà pour cette action précise, jamais une constante comme `"lead"`.

## Suivre les produits et les paniers

Les outils de suivi rattachent une vente au produit qu'un visiteur a consulté. Indiquez au pixel à quels produit et variante Whop correspond chaque vue, ajout au panier et début de checkout. Les boutiques créées par Whop AI le font déjà sur leurs pages produit et de checkout. Un site que vous créez vous-même ou téléversez avec la CLI ajoute trois appels et quatre attributs.

Déclenchez `view_content` lorsqu'une page produit affiche une variante, puis à nouveau lorsque l'acheteur en choisit une autre, `add_to_cart` lorsqu'il l'ajoute, et `initiate_checkout` lorsque le checkout s'ouvre :

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

* `variant_id` est l'ID de la variante, préfixé par `plan_`, et `product_id` est l'ID de son produit, préfixé par `prod_`.
* `value` est le prix affiché sur la page, dans l'unité principale de la devise (`49` pour 49,00 \$), et `currency` est son code ISO 4217. Omettez les deux lorsque la page n'affiche aucun prix.
* Un checkout portant sur plusieurs variantes envoie `initiate_checkout` avec son total, et omet `variant_id` et `product_id`.

Marquez l'élément qui affiche le produit avec les mêmes quatre valeurs pour la variante affichée à l'écran, afin qu'un script de suivi puisse les lire à tout moment :

```html theme={null}
<section
  data-whop-product-id="prod_xxxxxxxxxxxxx"
  data-whop-variant-id="plan_xxxxxxxxxxxxx"
  data-whop-price="49"
  data-whop-currency="USD"
>
```

Mettez à jour les attributs chaque fois que l'acheteur choisit une autre variante ou que le prix affiché change. Les achats ne nécessitent rien de votre part : Whop les enregistre à partir de ses propres paiements.

## Où arrivent les données

Ouvrez **Websites** dans votre [tableau de bord](https://whop.com/dashboard) pour consulter les visiteurs, les pages vues et le revenu attribué par domaine, ou le [tableau de bord du pixel](https://whop.com/dashboard) pour le détail complet des événements. Les premiers événements apparaissent environ une minute après la visite.

> [!NOTE]
>
> L'installation manuelle de l'extrait du pixel reste prise en charge — celui de la plateforme détecte un `window.whop` existant et ne fait rien, de sorte que rien n'est compté deux fois. Faites-le lorsque votre site a besoin d'une portée différente de sa propre entreprise.

Pour un site sur votre propre domaine plutôt que sur `whop.site`, installez l'extrait manuellement : [Installer le pixel Whop](https://docs.whop.com/fr/developer/ads/pixel.md).

## Étapes suivantes

> [card] [Référence du pixel](https://docs.whop.com/fr/developer/ads/pixel.md)
>
> Tous les champs d'événement, la correspondance client et les envois côté serveur.

> [card] [Accepter des paiements](https://docs.whop.com/fr/developer/guides/accept-payments.md)
>
> Fournissez au pixel des conversions à attribuer.


## Related topics

- [Hébergement de sites web sur Whop](https://docs.whop.com/fr/developer/websites/hosting.md)
- [Créer un site web avec la CLI](https://docs.whop.com/fr/developer/websites/quickstart.md)
- [Déployer une entreprise à partir d'un blueprint](https://docs.whop.com/fr/developer/websites/blueprints.md)
