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

# Haz seguimiento de los visitantes

> Los sitios en whop.site incluyen el píxel de Whop con seguimiento automático de visitas a páginas y del checkout. Añade llamadas a whop.track para leads, reservas y eventos personalizados.

Whop inyecta el píxel en cada página HTML que sirve tu sitio, vinculado al negocio de la app, y registra una visita a la página. No hay ningún fragmento que pegar ni ningún ID de cuenta que configurar.

| Se registra automáticamente | Añades una llamada a `whop.track` |
| - | - |
| Visitas a páginas | Formularios de leads, reservas de llamadas, solicitudes |
| Visitas al checkout de Whop | Cuestionarios, VSL completados, cualquier cosa en tus propias páginas |
| Compras, suscripciones, pruebas gratuitas | Pasos que los datos de pago de Whop no pueden ver |

## Registra tus propios eventos

`window.whop` existe antes de que se ejecute el código de tu app, así que llámalo directamente:

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

Los nombres de eventos estándar (`lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `initiate_checkout`) aceptan opcionalmente un `value` y una `currency`. Cualquier otro nombre también funciona y aparece con ese nombre en los informes.

Envía el evento donde se completa la acción: en el manejador de éxito si la página no cambia, o en la página de confirmación si redirige.

> [!TIP]
>
> Pasa un `event_id` en todo lo que pueda llegar dos veces: un reintento, una recarga o la misma conversión replicada desde tu servidor. Whop cuenta cada par de nombre e ID una sola vez. Usa un ID que tu sistema ya tenga para esa acción concreta, nunca una constante como `"lead"`.

## Registra productos y carritos

Las herramientas de seguimiento asocian una venta con el producto que vio un visitante. Indica al píxel a qué producto y variante de Whop corresponde cada visualización, cada adición al carrito y cada inicio de checkout. Las tiendas que crea Whop AI ya lo hacen en sus páginas de producto y de checkout. Un sitio que crees tú mismo o subas con la CLI añade tres llamadas y cuatro atributos.

Envía `view_content` cuando una página de producto muestra una variante, de nuevo cuando el comprador elige otra, `add_to_cart` cuando la añade e `initiate_checkout` cuando se abre el checkout:

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

* `variant_id` es el ID de la variante, con el prefijo `plan_`, y `product_id` es el ID de su producto, con el prefijo `prod_`.
* `value` es el precio que muestra la página, en las unidades principales de la moneda (`49` para 49,00 \$), y `currency` es su código ISO 4217. Omite ambos cuando la página no muestre ningún precio.
* Un checkout de varias variantes envía `initiate_checkout` con su total y omite `variant_id` y `product_id`.

Marca el elemento que muestra el producto con los mismos cuatro valores de la variante que aparece en pantalla, para que un script de seguimiento pueda leerlos en cualquier momento:

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

Actualiza los atributos cada vez que el comprador elija otra variante o cambie el precio mostrado. Las compras no requieren nada por tu parte: Whop las registra a partir de sus propios pagos.

## Dónde llegan los datos

Abre **Websites** en tu [panel](https://whop.com/dashboard) para ver visitantes, visitas a páginas e ingresos atribuidos por dominio, o el [panel del píxel](https://whop.com/dashboard) para ver el desglose completo de eventos. Los primeros eventos aparecen aproximadamente un minuto después de la visita.

> [!NOTE]
>
> Instalar tú mismo el fragmento del píxel sigue siendo compatible: el de la plataforma comprueba si ya existe `window.whop` y no hace nada, así que nada se cuenta dos veces. Hazlo cuando tu sitio necesite un ámbito distinto de su propio negocio.

Para un sitio en tu propio dominio en lugar de `whop.site`, instala el fragmento manualmente: [Instala el píxel de Whop](https://docs.whop.com/es/developer/ads/pixel.md).

## Próximos pasos

> [card] [Referencia del píxel](https://docs.whop.com/es/developer/ads/pixel.md)
>
> Todos los campos de eventos, la coincidencia de clientes y los envíos desde el servidor.

> [card] [Acepta pagos](https://docs.whop.com/es/developer/guides/accept-payments.md)
>
> Dale al píxel conversiones que atribuir.


## Related topics

- [Alojamiento de sitios web en Whop](https://docs.whop.com/es/developer/websites/hosting.md)
- [Crea un sitio web con la CLI](https://docs.whop.com/es/developer/websites/quickstart.md)
- [Implementa un negocio a partir de un blueprint](https://docs.whop.com/es/developer/websites/blueprints.md)
