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

# Informes

> Los informes de una cuenta publicitaria: lo que gastó y lo que obtuvo, en un periodo, al nivel al que lo acotes. Monta `chart`, `table` o ambos: leen el mismo periodo, la misma regla de atribución y la misma selección, así que dos superficies una al lado de la otra nunca pueden discrepar sobre lo que muestran. La configuración `links` del handle `ads` conecta los recuentos de clics y resultados de la tabla con tus propias páginas, aquellas en las que montaste `people` y `events` del namespace `tracking`.

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

*Desde `v1.0.0`.*

Se monta dentro de [`Ads`](https://docs.whop.com/es/elements/latest/ads/overview). Créalo para obtener un handle y después monta sus elementos en ese handle. Llama a `destroy()` para eliminar el subcontrolador. Vuelve a crearlo para obtener un handle nuevo.

## Vista previa

Una demostración en vivo e interactiva de la disposición predeterminada de este subcontrolador con datos de ejemplo:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <Reporting>
          <ChartElement />
          <TableElement />
        </Reporting>
      </Ads>
    </WhopElements>
  );
}
```

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

## Opciones

Pásalas a `ads.create('reporting', { … })`, o como props de `<Reporting>` en React. Las props inyectadas por el elemento padre nunca aparecen aquí.

**period** `string`

El periodo sobre el que informan todas las superficies: `today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days`, `all_time` o `custom` (combínalo con `customRange`). El gráfico incluye el selector y es el que lo cambia, así que un host puede controlar el periodo y leerlo de nuevo 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`

El periodo explícito, como instantes ISO 8601, que se usa cuando `period` es `custom`. En caso contrario, se ignora. Por defecto es `null`.

**propiedades**

**from** `string` *required*

**to** `string` *required*

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

Zona horaria para todas las cifras de los informes. Usa `account` para la `preferences.ads_scheduling_timezone` de la cuenta o `local` para la zona horaria del navegador del visitante. Son las únicas opciones que ofrece el gráfico. Una zona horaria IANA libre podría hacer que el selector etiquetara los datos incorrectamente y se perdería cuando el visitante cambiara la selección. Para informar en otra zona horaria, cambia el ajuste de la cuenta. `account` recurre a la zona horaria del visitante cuando la cuenta no tiene ningún ajuste. Por defecto es `"account"`.

**currency** `string`

Código de moneda ISO 4217 de tres letras en minúsculas para los importes convertidos, como `usd` o `eur`. Si no se establece, usa por defecto la `preferences.ads_reporting_currency` de la cuenta. Por defecto es `""`.

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

Qué punto de contacto del recorrido de un comprador recibe la atribución: `last_touch`, el predeterminado, o `first_touch`. Con ambos, un punto de contacto de Whop en cualquier parte del recorrido se lleva la atribución a Whop; el modelo solo elige los extremos. La tabla incluye el selector y es la que lo cambia, así que un host puede controlarlo y leerlo de nuevo desde `attributionModelChanged`. Por defecto es `"last_touch"`.

**campaignIds** `string[]`

Acota los informes a estas campañas publicitarias (`adcamp_…`). Si está vacío, informa sobre toda la cuenta. `adGroupIds` o `adIds` lo anulan cuando se establece cualquiera de ellos. **Pasa un solo ID para obtener una cifra exacta:** la API de informes acota por una única ruta de origen, así que cuando se pasa más de uno el gráfico informa solo sobre el primero. Por defecto es `[]`.

**adGroupIds** `string[]`

Acota los informes a estos grupos de anuncios (`adgrp_…`). Tiene prioridad sobre `campaignIds`. Se aplica la misma advertencia sobre un solo ID. Por defecto es `[]`.

**adIds** `string[]`

Acota los informes a estos anuncios (`ad_…`). Es el filtro más restrictivo: tiene prioridad sobre los otros dos. Se aplica la misma advertencia sobre un solo ID. Por defecto es `[]`.

**tab** `"ads" | "all" | "businesses" | "campaigns" | "ad-groups"`

En qué tabla se abre el elemento `table`: `campaigns`, `ad-groups`, `ads` o `all` para la vista de fuentes de tráfico. `all` siempre informa sobre toda la cuenta (la serie de fuentes solo existe a ese nivel), así que un filtro establecido junto a él acota la tabla, pero no el gráfico. Por defecto es `"campaigns"`.

**sources** `string[] | null`

Sobre qué tráfico informa el gráfico, como rutas de origen: `whop:*` para la publicidad comprada a través de Whop, `ext:*` y `ext:<platform>:*` para anuncios publicados en otros sitios, `referrer:*` para el tráfico orgánico, `direct`, `other`. `null`, el valor predeterminado, informa solo sobre la publicidad de Whop; `[]` informa sobre todas las fuentes; un array no vacío informa sobre esas. Es un eje DISTINTO de `campaignIds` y similares, que acotan dentro de la publicidad de Whop: las ratios derivadas del gasto siguen atribuidas a Whop sea cual sea este valor, porque el gasto solo compra anuncios de Whop. La pestaña All del elemento `table` lo cambia. Por defecto es `null`.

## Eventos

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

### `onEditRequested`

El visitante pidió editar algo: un menú de fila, una fila en borrador o Edit ad en el overlay de detalles. `campaignId` siempre está presente; `adGroupId` y `adId` lo acotan a lo que pulsó. Solo se emite cuando `useCampaignCreator` está desactivado; si está activado, el creador se abre sobre la página y este evento no se emite.

**payload** `AdsEditTarget`

**propiedades**

**campaignId** `string` *required*

**adGroupId** `string`

**adId** `string`

## Métodos

Llámalos en el subhandle obtenido de `ads.create('reporting', { … })`.

### `update`

Combina nuevas props y callbacks en el subcontrolador.

**Parámetros**

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

### `destroy`

Destruye el subcontrolador y sus elementos y después libera su ranura exclusiva. Un `create("reporting")` posterior empieza de cero.

## Elementos

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

> [card] [ChartElement](https://docs.whop.com/es/elements/latest/ads/reporting-chart.md)
>
> El rendimiento de una cuenta en un periodo, con un selector de lo que se representa: gasto, impresiones, clics o cualquier conversión que registre la cuenta. Solo lectura.

> [card] [TableElement](https://docs.whop.com/es/elements/latest/ads/reporting-table.md)
>
> Las campañas, los grupos de anuncios y los anuncios de una cuenta publicitaria en una sola tabla, con las pestañas para moverse entre ellos: elige filas para acotar el nivel inferior, busca, ordena, desglosa las cifras, elige tus columnas y pausa, reanuda, duplica o elimina directamente desde una fila. El periodo sobre el que informa y las filas a las que está filtrada residen en el handle, así que un gráfico montado a su lado informa exactamente sobre lo mismo.


## Related topics

- [Informes](https://docs.whop.com/es/elements/latest/wallet/reports.md)
- [API de actividad financiera](https://docs.whop.com/es/api-reference/ledgers/ledger-activity.md)
- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
