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

# Instala el píxel de Whop

> Añade el píxel de Whop a cada página de tu embudo y luego envía eventos para que tus anuncios reciban el crédito por los leads y las ventas.

El píxel de Whop es un fragmento de JavaScript que añades a tu sitio web. Mide las visitas a páginas, vincula a los visitantes con sus compras y atribuye los eventos de conversión a tus anuncios. Una vez instalado, verás tu sitio web en la [página Websites](https://whop.com/dashboard/websites).

## Instala el píxel de Whop

## 1. Obtén el ID de tu cuenta de Whop

Encuéntralo en tu [panel de Whop](https://whop.com/dashboard/): es la parte de la URL después de `dashboard/`, que empieza por `biz_`. Tiene este aspecto: `biz_xxxxxxxxxxxxx`.

![URL del panel de Whop en la barra de direcciones del navegador, con el ID de cuenta después de dashboard subrayado](https://mintcdn.com/whop/i81Det37UaKELkrh/images/dashboard-url.png?fit=max\&auto=format\&n=i81Det37UaKELkrh\&q=85\&s=f8dce6ea378318d4c89f7bce9239605d)

## 2. Instala el fragmento

Pega este fragmento dentro del `<head>` de **cada página** de tu embudo: páginas de destino, publirreportajes, páginas de pago y páginas de agradecimiento, no solo tu página de inicio. Reemplaza `biz_xxxxxxxxxxxxx` por el ID de tu propia cuenta.

```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 publicas anuncios desde más de una cuenta de Whop**, añade todos los ID de cuenta a `setScope`. El píxel envía cada evento a todas las cuentas indicadas, de modo que cada panel recibe las visitas a páginas que necesita para atribuir conversiones a sus campañas.

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

Whop mantiene los datos separados por cuenta. Una cuenta que no esté en `setScope` no recibe eventos de esta página. Si también [envías eventos desde tu servidor](https://docs.whop.com/es/developer/ads/events-api.md), envía cada uno una vez por cuenta, con el ID de esa cuenta.

¿Construyes tu embudo en una plataforma en lugar de HTML puro? Usa la guía de instalación específica en lugar de pegar el fragmento en un bloque de texto del creador de páginas.

| Si usas | Sigue |
| - | - |
| ClickFunnels | [Instala el píxel de Whop en ClickFunnels](https://docs.whop.com/es/developer/ads/platforms/clickfunnels.md) |
| GoHighLevel | [Instala el píxel de Whop en GoHighLevel](https://docs.whop.com/es/developer/ads/platforms/gohighlevel.md) |
| Kajabi | [Instala el píxel de Whop en Kajabi](https://docs.whop.com/es/developer/ads/platforms/kajabi.md) |
| WordPress | [Instala el píxel de Whop en WordPress](https://docs.whop.com/es/developer/ads/platforms/wordpress.md) |
| WooCommerce | [Instala el píxel de Whop en WooCommerce](https://docs.whop.com/es/developer/ads/platforms/woocommerce.md) |
| Shopify | [Instala el píxel de Whop en Shopify](https://docs.whop.com/es/developer/ads/platforms/shopify.md) |
| WebinarJam | [Instala el píxel de Whop en WebinarJam](https://docs.whop.com/es/developer/ads/platforms/webinarjam.md) |
| iClosed | [Instala el píxel de Whop con iClosed](https://docs.whop.com/es/developer/ads/platforms/iclosed.md) |
| Calendly | [Instala el píxel de Whop con Calendly](https://docs.whop.com/es/developer/ads/platforms/calendly.md) |

## 3. Registra eventos

Si tu embudo tiene pasos importantes fuera del checkout de Whop, como un formulario de leads, la reserva de una llamada o una solicitud, añade llamadas a `whop.track` para registrar esos eventos.

```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>
```

Dónde colocar la llamada depende de lo que ocurra después de la acción:

**a. La acción redirige** (un formulario que envía al visitante a una página de agradecimiento)

Dispara el evento en la página a la que llega. La llamada va en el HTML de esa página, o en un campo de código del creador de páginas, así que envuélvela en etiquetas `<script>`. El fragmento del píxel también debe estar instalado en esa página.

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

**b. La acción permanece en la misma página** (un formulario que muestra un mensaje de éxito en línea)

Dispara el evento en el manejador de éxito de la acción. Ya estás dentro de JavaScript, así que no necesitas etiquetas `<script>`.

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

**Es importante incluir toda la información que tengas sobre el cliente en cada etapa del embudo.** Si recibes un lead con nombre, correo electrónico y número de teléfono, inclúyelos en el evento enviado a Whop.

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

## Eventos estándar

El píxel de Whop incluye un conjunto de nombres de eventos estándar para las etapas habituales de un embudo. Cada uno acepta un `value` (número) y una `currency` (código ISO 4217) opcionales. La excepción es `purchase`, que requiere un `value` positivo.

| Evento | Cuándo dispararlo |
| - | - |
| `lead` | Un visitante envía información de contacto o un formulario de suscripción |
| `schedule` | Un visitante reserva una llamada o cita |
| `submit_application` | Un visitante envía una solicitud |
| `contact` | Un visitante inicia una conversación o solicitud de contacto |
| `complete_registration` | Finaliza un alta o registro |
| `view_content` | Un visitante ve una página o contenido clave |
| `add_to_cart` | Un visitante añade un artículo al carrito |
| `initiate_checkout` | Un visitante llega al checkout |
| `purchase` | Se completa una venta en [tu propio checkout](#track-sales-on-your-own-checkout), solo para pagos que ocurren fuera de Whop. Whop registra su propio checkout automáticamente |

Pasa `variant_id` (con prefijo `plan_`) y `product_id` (con prefijo `prod_`) para indicar a qué variante y producto de Whop se refiere un evento, normalmente en `view_content` y `add_to_cart` ([Registrar productos y carritos](https://docs.whop.com/es/developer/websites/tracking.md#track-products-and-carts) muestra una página de producto que hace ambas cosas):

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

## Eventos personalizados

Si los eventos estándar de Whop no cubren las necesidades de tu embudo, o quieres registrar etapas específicas del recorrido del cliente, puedes disparar eventos personalizados.

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

Mantén los nombres cortos y estables, y reutiliza un conjunto reducido. Whop almacena nombres de hasta 250 caracteres.

Los eventos personalizados siguen las mismas reglas de ubicación que los eventos estándar; consulta [Registra eventos](#track-events).

## Registra ventas en tu propio checkout

Si vendes a través de tu propio checkout en lugar del de Whop, dispara un evento `purchase` cuando se complete una venta. `value` es obligatorio: Whop rechaza un evento de compra que no tenga un valor positivo, porque las plataformas publicitarias no pueden optimizar hacia una venta sin importe. `currency` es opcional y su valor predeterminado es USD.

```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 los reenvía a las plataformas publicitarias como su evento Purchase estándar, de modo que una campaña optimizada para compras aprende de ellos. En los informes de Whop aparecen como compras externas, separadas de las compras: las compras y el ROAS solo cuentan los pagos que procesa Whop.

> [!WARNING]
>
> Nunca dispares `purchase` para una venta que haya procesado Whop. Whop ya informa esa venta a la plataforma publicitaria, por lo que la tuya la contaría dos veces.

## Asigna un ID a cada evento

Pasa un `event_id` con cualquier evento que pueda llegar a Whop más de una vez. Por ejemplo, si disparas un evento al llegar a una página de agradecimiento, asegúrate de que ese evento se dispare una vez por conversión real, no una vez por visita a la página. Whop cuenta cada par de `event_name` y `event_id` una sola vez, por lo que un reintento, una recarga de la página o la misma conversión enviada desde dos lugares se consolidan en un único evento.

```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>
```

**El ID identifica un único evento, no el tipo de evento.** Cada lead necesita el suyo. Si envías `"lead"` como ID para todos los leads, Whop los trata a todos como un solo evento, de modo que cientos de leads aparecen como uno.

Usa un valor que tu propio sistema ya tenga para esa acción concreta: un ID de lead, un número de pedido o un ID de envío de formulario. Reutiliza ese valor solo cuando vuelvas a enviar esa misma acción. Un reintento cuenta como la misma acción. También la misma conversión replicada desde tu servidor. Un valor inventado en el momento del disparo es nuevo cada vez, por lo que no evitará duplicados.

Si la misma conversión puede llegar tanto desde tu sitio web como desde tu servidor, envía el mismo `event_id` desde ambos para que se registre como un solo evento.

## Adjunta información del cliente

Envía siempre toda la información del cliente que tengas disponible. Esto ayuda a Whop a asociar eventos con clientes y a mejorar el seguimiento de conversiones.

Estos campos se pueden adjuntar a cualquier tipo de evento y son opcionales. Envía solo los campos que tengas.

```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>
```

| Campo | Descripción |
| - | - |
| `email` | Dirección de correo electrónico del visitante |
| `first_name` | Nombre del visitante |
| `last_name` | Apellido del visitante |
| `name` | Nombre completo visible del visitante |
| `phone` | Número de teléfono del visitante |
| `external_id` | Tu propio ID de usuario/cliente |
| `city` | Ciudad del visitante |
| `state` | Estado o región del visitante |
| `postal_code` | Código postal del visitante |
| `country` | País del visitante |

> [!WARNING]
>
> Envíalos como texto sin formato. Un correo electrónico con hash se descarta porque no es una dirección válida. Un número de teléfono con hash se almacena como dígitos sin sentido y no coincide con nadie.

> [!NOTE]
>
> **No registres los checkouts, suscripciones ni pruebas de Whop.** Whop registra en el servidor cada vista de checkout, compra, suscripción e inicio de prueba en su propio checkout sin ninguna configuración. El píxel no aceptará duplicados. Envía solo los eventos que Whop no puede ver: leads y reservas en tu propia infraestructura, y [ventas en tu propio checkout](#track-sales-on-your-own-checkout).


## Related topics

- [Instala el píxel de Whop en Shopify](https://docs.whop.com/es/developer/ads/platforms/shopify.md)
- [Instala el píxel de Whop con Calendly](https://docs.whop.com/es/developer/ads/platforms/calendly.md)
- [Instala el píxel de Whop en Kajabi](https://docs.whop.com/es/developer/ads/platforms/kajabi.md)
