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

# Tracking

> La audiencia rastreada de una cuenta: todas las personas que ha visto su píxel y cada evento que realizaron. Limítalo a una cuenta con `accountId` y luego monta `people`, `events` o ambos. Leen la misma ventana y la misma regla de crédito, así que dos superficies una al lado de la otra nunca pueden discrepar sobre lo que muestran. `person` es adonde lleva un clic en cualquiera de ellas: el registro completo de una persona, que se puede montar en línea o presentar sobre tu página. `links` conecta sus enlaces de persona con tus propias páginas.

> [!NOTE]
>
> Esta página documenta `@whop/elements@1.10.0` y `@whop/elements-react@1.10.0`.

*Desde `v1.0.0`.*

## Playground

Combina los elementos con datos de ejemplo. Usa los controles, añade y organiza elementos, y observa cómo se disparan los eventos en vivo:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Tracking /* options */>
        {/* mount elements here */}
      </Tracking>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const tracking = window.WhopElements().tracking.create({ /* options */ });
</script>
```

## Opciones

Pásalas a `whop.tracking.create({ … })`, o como props de `<Tracking>` en React.

**accountId** `string`

ID de la cuenta, con el prefijo `biz_`, cuyas personas y eventos se leen. Obligatorio. Por defecto es `""`.

**accessToken** `string`

Un token con alcance limitado con el que leen ambas superficies. Genera un token para todo el handle en tu servidor con `POST /api/v1/access_tokens` y establece uno nuevo con `update({ accessToken })` antes de que caduque. Leer las listas requiere `member:basic:read` o `company:basic:read`; los recuentos de opciones de los menús de filtro usan además `stats:read`, y el filtro de audiencias guardadas de la tabla People usa `audience:basic:read`; sin ellos, los menús simplemente muestran menos opciones. Si se omite, las llamadas llevan la sesión propia del usuario, que solo responde en el mismo origen.

**links** `CrossLinksConfig`

Adónde llevan los enlaces de persona en tu sitio. `person` es una plantilla de URL absoluta con dos marcadores, cada uno sustituido por fila con codificación URL: `{personId}` es el ID estable `prsn_…`, idéntico para la misma persona en todas las superficies, así que usa ese valor como clave de tu página y monta allí el elemento `person`; `{identifier}` es el identificador más significativo para una persona que tiene la superficie (un ID de usuario o un email cuando se conoce), por lo que puede variar entre superficies. Debe ser absoluta (`https://…`); una URL relativa se resolvería respecto al frame del elemento, así que se trata como no establecida. Si no se establece, un clic en una persona emite `personOpened` en su elemento, que es la señal para presentar `person` sobre tu página. Las URL base `people` y `events` se aceptan por simetría con el handle de anuncios, pero nada bajo este handle las renderiza. Por defecto es `{}`.

**propiedades**

**people** `string`

**events** `string`

**person** `string`

**period** `string`

La ventana que cubren ambas superficies: `today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days`, `all_time` o `custom` (combínalo con `customRange`). Los elementos incluyen el selector y modifican este valor; léelo de vuelta desde `periodChanged`. Por defecto es `"last_14_days"`.

Uno de `"today"`, `"yesterday"`, `"last_7_days"`, `"last_14_days"`, `"last_30_days"`, `"last_90_days"`, `"all_time"` o `"custom"`.

**customRange** `object | null`

La ventana explícita, como instantes ISO 8601, que se usa cuando `period` es `custom`. Se ignora en otro caso. Por defecto es `null`.

**propiedades**

**from** `string` *required*

**to** `string` *required*

**timezone** `"account" | "local"`

En cuál de las dos zonas horarias se resuelve la ventana: `account`, la zona horaria de programación de la propia cuenta, o `local`, la zona horaria en la que esté el navegador del usuario. `account` recurre a la del propio usuario cuando la cuenta no ha establecido ninguna. Por defecto es `"account"`.

**attributionModel** `"last_touch" | "first_touch"`

Qué punto de contacto del recorrido de una persona recibe el crédito al filtrar por fuente: `last_touch`, el predeterminado, o `first_touch`. Los elementos incluyen el selector y modifican este valor, así que un host puede controlarlo y leerlo de vuelta desde `attributionModelChanged`. Por defecto es `"last_touch"`.

**appearance** `Appearance`

Personalización visual para los elementos de este grupo. Anula el `WhopElements({ appearance })` global. Cámbiala en vivo con `update({ appearance })`.

**locale** `WhopElementsLocale`

Configuración regional para el texto de la interfaz de los elementos de este grupo. Establécela en una de las configuraciones regionales incluidas en la app para anular la configuración global. Cualquier otro valor recurre a la configuración regional predeterminada.

## Eventos

Pasa los callbacks en las opciones de creación o como props de React.

### `onLoadingChange`

Se ejecuta cuando cambia el estado de carga agrupado. El valor es `true` mientras algún elemento montado todavía se está cargando.

**loading** `boolean`

## Métodos

Llámalos en el handle de Tracking obtenido de `whop.tracking.create({ … })` o `useTracking()`.

### `update`

Combina nuevas opciones del handle en todos los elementos montados. En React, cambia las props del namespace en su lugar.

**Parámetros**

**options** `Partial\<TrackingOptions\>` *required*

### `destroy`

Destruye todos los elementos y subcontroladores que creó este handle, elimina el frame del controlador y libera sus suscripciones. Puedes llamarlo más de una vez, pero un handle destruido rechaza cualquier otra llamada: crea un nuevo handle para empezar de nuevo. React elimina el grupo automáticamente cuando el provider se desmonta.

## Elementos

Los elementos que monta este grupo. Cada uno tiene su propia página:

> [card] [PeopleElement](https://docs.whop.com/es/elements/latest/tracking/people.md)
>
> Todas las personas que ha visto la cuenta: visitantes y clientes resueltos a partir de la actividad del píxel, con su fuente, su gasto y sus contadores de actividad. Busca, filtra por fuente, evento, geografía o dispositivo, ordena cualquier columna y pasa de página. Un clic en una fila sigue `links.person` cuando el handle lo configura y, si no, te llega como `personOpened`.

> [card] [EventsElement](https://docs.whop.com/es/elements/latest/tracking/events.md)
>
> Cada evento que midió la cuenta (vistas de página, leads, compras y eventos personalizados del píxel) como un flujo sin procesar y filtrable. Las filas que hay detrás de cualquier métrica: filtra por evento, fuente, geografía o dispositivo dentro de la ventana del handle, o busca el identificador de una persona para leer todo su recorrido. Una celda de persona sigue `links.person` cuando el handle lo configura y, si no, te llega como `personOpened`.

> [card] [PersonElement](https://docs.whop.com/es/elements/latest/tracking/person.md)
>
> Todo lo que la cuenta sabe sobre una persona: quién es, de dónde vino, cuánto ha gastado y cada evento que ha realizado, en orden. Es la vista a la que lleva un clic en una persona: móntala en la página a la que apunta `links.person`, o preséntala sobre tu propia página cuando `people` o `events` emitan `personOpened`. `identifier` acepta cualquier identificador con el que se haya visto a una persona, así que un payload de `personOpened` se resuelve aquí sin cambios.


## Related topics

- [TrackingElement](https://docs.whop.com/es/elements/latest/delivery/tracking.md)
- [Retrieve Account Customer Tracking](https://docs.whop.com/es/api-reference/accounts/retrieve-account-customer-tracking.md)
- [Look Up Shipment](https://docs.whop.com/es/api-reference/shipments/look-up-shipment.md)
