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

# API de Ad Groups

> Un Ad Group se encuentra dentro de una campaña publicitaria y controla la entrega de los anuncios. Define la audiencia, la programación y el presupuesto de sus anuncios.

Un Ad Group se encuentra dentro de una [campaña publicitaria](https://docs.whop.com/es/api-reference/ad-campaigns/ad-campaign) y controla la entrega de los [anuncios](https://docs.whop.com/es/api-reference/ads/ad). Define la audiencia, la programación y el presupuesto de sus anuncios.

Usa la API de Ad Groups para crear grupos de anuncios en campañas, listar u obtener la configuración de segmentación y entrega, actualizar presupuestos o segmentación, eliminar grupos que deban dejar de ejecutarse y pausar o reanudar la entrega.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Ad Groups](https://docs.whop.com/es/api-reference/ad-groups/list-ad-groups.md) | GET `/ad_groups` |
| [Obtener un Ad Group](https://docs.whop.com/es/api-reference/ad-groups/retrieve-an-ad-group.md) | GET `/ad_groups/{id}` |
| [Crear un Ad Group](https://docs.whop.com/es/api-reference/ad-groups/create-an-ad-group.md) | POST `/ad_groups` |
| [Duplicar un Ad Group](https://docs.whop.com/es/api-reference/ad-groups/duplicate-an-ad-group.md) | POST `/ad_groups/{id}/duplicate` |
| [Pausar un Ad Group](https://docs.whop.com/es/api-reference/ad-groups/pause-an-ad-group.md) | POST `/ad_groups/{id}/pause` |
| [Reanudar un Ad Group](https://docs.whop.com/es/api-reference/ad-groups/unpause-an-ad-group.md) | POST `/ad_groups/{id}/unpause` |
| [Actualizar un Ad Group](https://docs.whop.com/es/api-reference/ad-groups/update-an-ad-group.md) | PATCH `/ad_groups/{id}` |
| [Eliminar un Ad Group](https://docs.whop.com/es/api-reference/ad-groups/delete-an-ad-group.md) | DELETE `/ad_groups/{id}` |

## Restricciones de segmentación

Los grupos de anuncios no pueden segmentar los [países indicados en la guía de publicidad](https://docs.whop.com/es/developer/ads/overview.md#countries-you-cannot-target). Las solicitudes para crear un grupo de anuncios o actualizar sus países segmentados se rechazan si incluyen un país bloqueado en `regions.include.countries`.

## Atributos

**id** `string` *required*

Identificador único del grupo de anuncios, con el prefijo `adgrp_`.

**ad\_campaign** `object` *required*

La campaña publicitaria a la que pertenece este grupo de anuncios.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El id de la entidad referenciada.

**added\_to\_cart\_value** `number` *required*

Valor en USD atribuido a los eventos de añadir al carrito. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**added\_to\_carts** `number` *required*

Eventos de añadir al carrito atribuidos por el píxel de Whop, último clic.

**audiences** `object` *required*

Audiencias guardadas a las que este grupo de anuncios entrega o que excluye.

> [accordion] Propiedades
>
> **exclude** `string[]` *required*
>
> IDs de las audiencias guardadas excluidas de la entrega, con el prefijo `adaud_`.
>
> **include** `string[]` *required*
>
> IDs de las audiencias guardadas a las que entrega el grupo de anuncios, con el prefijo `adaud_`.

**bid\_type** `string | null` *required*

Cómo se establecen las pujas de entrega en la subasta de anuncios. Las estrategias basadas en objetivos usan `desired_cost_per_result`.

Opciones disponibles: `minimum_cost`, `average_target`, `maximum_target`

**budget\_amount** `number | null` *required*

El presupuesto de este grupo de anuncios en USD, la moneda en la que se almacena y se factura. `null` cuando el presupuesto se establece en la campaña.

**budget\_amount\_local** `number | null` *required*

El mismo presupuesto expresado en `budget_currency` al tipo de cambio de hoy, para mostrarlo en la moneda de informes de anuncios de la cuenta. `null` cuando `budget_amount` lo es.

**budget\_currency** `string` *required*

El código ISO 4217 en el que está `budget_amount_local`: la preferencia `ads_reporting_currency` de la cuenta. `usd` a menos que la cuenta la haya cambiado.

**budget\_type** `string | null` *required*

Si `budget_amount` se gasta por día (`daily`) o durante toda la duración del grupo de anuncios (`lifetime`). Un grupo de anuncios `lifetime` también necesita `ends_at`, al menos 24 horas después de su inicio.

Opciones disponibles: `daily`, `lifetime`

**click\_through\_rate** `number` *required*

Clics divididos entre impresiones, entre 0 y 1.

**clicks** `number` *required*

El número de clics.

**completed\_registration\_value** `number` *required*

Valor en USD atribuido a los eventos de registro completado. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**completed\_registrations** `number` *required*

Eventos de registro completado atribuidos por el píxel de Whop, último clic.

**contact\_value** `number` *required*

Valor en USD atribuido a los eventos de contacto. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**contacts** `number` *required*

Eventos de contacto atribuidos por el píxel de Whop, último clic.

**conversion\_event** `string | null` *required*

El evento del píxel para el que se optimiza. Un evento estándar, o cualquier nombre de evento personalizado del píxel.

**cost\_per\_added\_to\_cart** `number | null` *required*

Gasto dividido entre los eventos de añadir al carrito atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_click** `number` *required*

Gasto dividido entre clics; 0 cuando no hay clics.

**cost\_per\_completed\_registration** `number | null` *required*

Gasto dividido entre los eventos de registro completado atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_contact** `number | null` *required*

Gasto dividido entre los eventos de contacto atribuidos; null cuando los contactos no son el objetivo y no hay ninguno atribuido.

**cost\_per\_lead** `number | null` *required*

Gasto dividido entre los leads atribuidos; null cuando los leads no son un objetivo y no hay ninguno atribuido.

**cost\_per\_mille** `number` *required*

Gasto por cada 1.000 impresiones; 0 cuando no hay impresiones.

**cost\_per\_purchase** `number | null` *required*

Gasto dividido entre las compras atribuidas; null cuando las compras no son un objetivo y no hay ninguna atribuida.

**cost\_per\_result** `number | null` *required*

Gasto dividido entre los resultados atribuidos por el píxel de Whop; null cuando no se está optimizando para nada atribuible por Whop.

**cost\_per\_schedule** `number | null` *required*

Gasto dividido entre los eventos de agendamiento atribuidos; null cuando los agendamientos no son el objetivo y no hay ninguno atribuido.

**cost\_per\_submitted\_application** `number | null` *required*

Gasto dividido entre los eventos de envío de solicitud atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_unique\_click** `number | null` *required*

Gasto dividido entre clics únicos; null cuando no hay clics únicos.

**cost\_per\_viewed\_content** `number | null` *required*

Gasto dividido entre los eventos de visualización de contenido atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**created\_at** `string` *required*

Cuándo se creó el grupo de anuncios, como marca de tiempo ISO 8601.

**custom\_conversions** `number` *required*

Eventos de conversión personalizados (definidos por el comerciante) atribuidos por el píxel de Whop, último clic, en todos los nombres de eventos personalizados.

**custom\_event\_counts** `object` *required*

Conversiones personalizadas atribuidas por el píxel de Whop, indexadas por el nombre de tu evento, con su recuento de último clic como valor. Vacío cuando no hay eventos personalizados con nombre atribuidos. Los eventos personalizados disparados sin nombre se cuentan en custom\_conversions pero se omiten aquí, por lo que estos valores suman como máximo custom\_conversions.

**custom\_event\_values** `object` *required*

Valor de conversión atribuido a cada evento personalizado, indexado por nombre de evento como custom\_event\_counts. Suma el valor pasado a whop.track, normalizado a USD; los eventos disparados sin valor aportan 0.

**delivery\_schedule** `object | null` *required*

Horas en las que el grupo de anuncios entrega cada semana, indexadas por día. Se omiten los días en que no entrega. `null` cuando entrega a todas horas. Algunas plataformas necesitan un `budget_type` lifetime para una programación, en el grupo de anuncios o en su campaña cuando la campaña tiene el presupuesto.

> [accordion] Propiedades
>
> **friday** `object[]`
>
> Franjas en las que el grupo de anuncios entrega el viernes, en orden cronológico. Se omite cuando no entrega ese día.
>
> > [accordion] Propiedades
> >
> > **end** `string` *required*
> >
> > Cuándo se detiene la entrega, como hora en formato de 24 horas `HH:00` hasta `24:00` para la medianoche. Posterior a `start`; una franja que pasa de la medianoche se divide en dos días.
> >
> > **start** `string` *required*
> >
> > Cuándo empieza la entrega, como hora en formato de 24 horas `HH:00` de `00:00` a `23:00`.
>
> **monday** `object[]`
>
> Franjas en las que el grupo de anuncios entrega el lunes, en orden cronológico. Se omite cuando no entrega ese día.
>
> > [accordion] Propiedades
> >
> > **end** `string` *required*
> >
> > Cuándo se detiene la entrega, como hora en formato de 24 horas `HH:00` hasta `24:00` para la medianoche. Posterior a `start`; una franja que pasa de la medianoche se divide en dos días.
> >
> > **start** `string` *required*
> >
> > Cuándo empieza la entrega, como hora en formato de 24 horas `HH:00` de `00:00` a `23:00`.
>
> **saturday** `object[]`
>
> Franjas en las que el grupo de anuncios entrega el sábado, en orden cronológico. Se omite cuando no entrega ese día.
>
> > [accordion] Propiedades
> >
> > **end** `string` *required*
> >
> > Cuándo se detiene la entrega, como hora en formato de 24 horas `HH:00` hasta `24:00` para la medianoche. Posterior a `start`; una franja que pasa de la medianoche se divide en dos días.
> >
> > **start** `string` *required*
> >
> > Cuándo empieza la entrega, como hora en formato de 24 horas `HH:00` de `00:00` a `23:00`.
>
> **sunday** `object[]`
>
> Franjas en las que el grupo de anuncios entrega el domingo, en orden cronológico. Se omite cuando no entrega ese día.
>
> > [accordion] Propiedades
> >
> > **end** `string` *required*
> >
> > Cuándo se detiene la entrega, como hora en formato de 24 horas `HH:00` hasta `24:00` para la medianoche. Posterior a `start`; una franja que pasa de la medianoche se divide en dos días.
> >
> > **start** `string` *required*
> >
> > Cuándo empieza la entrega, como hora en formato de 24 horas `HH:00` de `00:00` a `23:00`.
>
> **thursday** `object[]`
>
> Franjas en las que el grupo de anuncios entrega el jueves, en orden cronológico. Se omite cuando no entrega ese día.
>
> > [accordion] Propiedades
> >
> > **end** `string` *required*
> >
> > Cuándo se detiene la entrega, como hora en formato de 24 horas `HH:00` hasta `24:00` para la medianoche. Posterior a `start`; una franja que pasa de la medianoche se divide en dos días.
> >
> > **start** `string` *required*
> >
> > Cuándo empieza la entrega, como hora en formato de 24 horas `HH:00` de `00:00` a `23:00`.
>
> **tuesday** `object[]`
>
> Franjas en las que el grupo de anuncios entrega el martes, en orden cronológico. Se omite cuando no entrega ese día.
>
> > [accordion] Propiedades
> >
> > **end** `string` *required*
> >
> > Cuándo se detiene la entrega, como hora en formato de 24 horas `HH:00` hasta `24:00` para la medianoche. Posterior a `start`; una franja que pasa de la medianoche se divide en dos días.
> >
> > **start** `string` *required*
> >
> > Cuándo empieza la entrega, como hora en formato de 24 horas `HH:00` de `00:00` a `23:00`.
>
> **wednesday** `object[]`
>
> Franjas en las que el grupo de anuncios entrega el miércoles, en orden cronológico. Se omite cuando no entrega ese día.
>
> > [accordion] Propiedades
> >
> > **end** `string` *required*
> >
> > Cuándo se detiene la entrega, como hora en formato de 24 horas `HH:00` hasta `24:00` para la medianoche. Posterior a `start`; una franja que pasa de la medianoche se divide en dos días.
> >
> > **start** `string` *required*
> >
> > Cuándo empieza la entrega, como hora en formato de 24 horas `HH:00` de `00:00` a `23:00`.

**delivery\_status** `string` *required*

Si los anuncios de este grupo se están entregando ahora mismo y, si no, por qué. Cuando se aplican varios estados a la vez, se devuelve el de mayor precedencia.

Opciones disponibles: `all_ads_rejected`, `rejected`, `draft`, `campaign_paused`, `paused`, `in_review`, `processing`, `revise_content`, `issues`, `scheduled`, `completed`, `learning`, `active`

**demographics** `object` *required*

Segmentación por edad, género y audiencia automática.

> [accordion] Propiedades
>
> **automatic** `boolean` *required*
>
> Si la segmentación automática de audiencia está activada. Cuando es `true`, la entrega puede ir más allá de las edades y géneros que estableces, tratándolos como sugerencias.
>
> **gender** `string` *required*
>
> Género segmentado.
>
> Opciones disponibles: `all`, `male`, `female`
>
> **maximum\_age** `number | null` *required*
>
> Edad máxima segmentada. `null` cuando no hay máximo establecido.
>
> **minimum\_age** `number | null` *required*
>
> Edad mínima segmentada. `null` cuando no hay mínimo establecido.

**desired\_cost\_per\_result** `number | null` *required*

Costo por resultado al que apuntar (`average_target`) o que nunca se debe superar (`maximum_target`). `null` para pujas `minimum_cost`.

**devices** `object` *required*

Plataformas de dispositivo y sistemas operativos segmentados.

> [accordion] Propiedades
>
> **operating\_systems** `object[]` *required*
>
> Sistemas operativos segmentados. Vacío segmenta todos los sistemas operativos.
>
> > [accordion] Propiedades
> >
> > **minimum\_version** `string`
> >
> > Versión mínima del sistema operativo segmentada, como `18.0`. Ausente cuando cualquier versión es válida.
> >
> > **os** `string` *required*
> >
> > Sistema operativo segmentado.
> >
> > Opciones disponibles: `ios`, `android`
>
> **platforms** `string[]` *required*
>
> Tipos de dispositivo segmentados. Vacío segmenta todos los dispositivos.
>
> Opciones disponibles: `mobile`, `desktop`

**ends\_at** `string | null` *required*

Cuándo deja de entregarse el grupo de anuncios, como marca de tiempo ISO 8601. `null` cuando se ejecuta hasta que se pausa.

**frequency** `number | null` *required*

Impresiones divididas entre el alcance.

**impressions** `number` *required*

El número de impresiones.

**issues** `object[]` *required*

Problemas abiertos que afectan a este grupo de anuncios y a sus anuncios. Vacío cuando no hay ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> Identificador único del problema.
>
> **category** `string` *required*
>
> El tipo de problema: información sobre la entrega, una advertencia o un error que requiere atención.
>
> Opciones disponibles: `information`, `warning`, `error`
>
> **message** `string` *required*
>
> Una descripción de en qué consiste el problema y cómo puede resolverse.
>
> **resource\_id** `string | null` *required*
>
> El ID de la campaña, el grupo de anuncios o el anuncio al que está asociado el problema.
>
> **resource\_type** `string` *required*
>
> El tipo de recurso al que está asociado el problema.
>
> Opciones disponibles: `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> Un título breve del problema, orientado al creador: la regla que indica un rechazo de la revisión de contenido, o una etiqueta genérica.

**keywords** `object[]`

Términos de búsqueda para los que pueden mostrarse los anuncios de este grupo, y términos para los que nunca se muestran. Solo campañas de búsqueda, donde cada grupo de anuncios necesita al menos uno antes del lanzamiento.

> [accordion] Propiedades
>
> **match\_type** `string` *required*
>
> Qué tan exacta debe ser la coincidencia de una búsqueda: `broad` también alcanza búsquedas relacionadas, `phrase` requiere el significado de la frase y `exact` requiere el mismo significado que el término. El valor predeterminado es `broad`.
>
> Opciones disponibles: `broad`, `phrase`, `exact`
>
> **negative** `boolean` *required*
>
> Si este término impide que se muestren los anuncios en lugar de hacerlos elegibles. El valor predeterminado es `false`.
>
> **text** `string` *required*
>
> El término de búsqueda, de hasta 80 caracteres y 10 palabras.

**languages** `string[]` *required*

Idiomas segmentados, como códigos ISO 639 como `en` o `es`. Una configuración regional específica de una región sin código ISO aparece como una clave de configuración regional numérica. Vacío segmenta todos los idiomas.

**lead\_value** `number` *required*

Valor en USD atribuido a los eventos de lead. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**leads** `number` *required*

Leads atribuidos por el píxel de Whop, último clic.

**learning\_progress** `object | null` *required*

Progreso hacia las conversiones que necesita la fase de aprendizaje de este grupo de anuncios. Null salvo que esté en aprendizaje o en aprendizaje limitado y haya recuentos válidos disponibles. Alcanzar el umbral no determina el estado de entrega.

> [accordion] Propiedades
>
> **conversion\_threshold** `integer` *required*
>
> Las conversiones que necesita la fase de aprendizaje de este grupo de anuncios. Puede cambiar durante la entrega.
>
> **conversions** `integer` *required*
>
> Conversiones contadas desde la última edición significativa durante la fase de aprendizaje de este grupo de anuncios.
>
> **progress\_percent** `number` *required*
>
> Conversiones divididas entre el umbral, como porcentaje limitado a 0–100. El `delivery_status` del grupo de anuncios sigue siendo la referencia.

**link\_clicks** `number` *required*

Vistas de página en tu destino de personas que hicieron clic en el anuncio, registradas por el píxel de Whop. Se cuentan de la misma forma en todas las plataformas de anuncios.

**purchase\_value** `number` *required*

Valor en USD de las compras atribuidas por el píxel.

**purchases** `number` *required*

Compras atribuidas por el píxel de Whop, último clic.

**reach** `number` *required*

El número de personas únicas que vieron esto.

**regions** `object` *required*

Ubicaciones segmentadas y excluidas.

> [accordion] Propiedades
>
> **exclude** `object` *required*
>
> Ubicaciones excluidas de la segmentación. Los grupos de países no se pueden excluir.
>
> > [accordion] Propiedades
> >
> > **cities** `object[]` *required*
> >
> > Ciudades, indexadas por la taxonomía de ubicaciones.
> >
> > > [accordion] Propiedades
> > >
> > > **key** `string` *required*
> > >
> > > La clave de la ciudad en la taxonomía de ubicaciones.
> > >
> > > **name** `string`
> > >
> > > Nombre de la ciudad, como `Austin`. Ausente cuando la taxonomía de ubicaciones no tiene ninguno.
> >
> > **countries** `string[]` *required*
> >
> > Países, como códigos ISO 3166-1 alfa-2 como `US`.
> >
> > **country\_groups** `string[]` *required*
> >
> > Grupos de varios países, como `worldwide` o `europe`.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Áreas circulares, cada una formada por una coordenada y un radio.
> >
> > > [accordion] Propiedades
> > >
> > > **country\_code** `string`
> > >
> > > País ISO 3166-1 alfa-2 en el que se encuentra el punto. Envíalo en una categoría especial de anuncios, donde la campaña debe declarar los países a los que llegan sus conjuntos de anuncios.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > Unidad de `radius`.
> > >
> > > Opciones disponibles: `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Latitud del punto central.
> > >
> > > **longitude** `number` *required*
> > >
> > > Longitud del punto central.
> > >
> > > **name** `string`
> > >
> > > Etiqueta de la ubicación, como una ciudad o una dirección. Ausente cuando la ubicación no tiene etiqueta.
> > >
> > > **radius** `number` *required*
> > >
> > > Radio alrededor del punto central, en `distance_unit`.
> >
> > **regions** `string[]` *required*
> >
> > Estados de EE. UU. y DC, como códigos ISO 3166-2 como `US-CA`. Los territorios de EE. UU. (`PR`, `GU`, `VI`, `AS`, `MP`) y cualquier lugar fuera de EE. UU. se segmentan mediante `countries`.
> >
> > **zips** `string[]` *required*
> >
> > Códigos ZIP y postales, indexados como `COUNTRY:CODE`, como `US:78756`.
>
> **include** `object` *required*
>
> Ubicaciones que segmenta el grupo de anuncios.
>
> > [accordion] Propiedades
> >
> > **cities** `object[]` *required*
> >
> > Ciudades, indexadas por la taxonomía de ubicaciones.
> >
> > > [accordion] Propiedades
> > >
> > > **key** `string` *required*
> > >
> > > La clave de la ciudad en la taxonomía de ubicaciones.
> > >
> > > **name** `string`
> > >
> > > Nombre de la ciudad, como `Austin`. Ausente cuando la taxonomía de ubicaciones no tiene ninguno.
> >
> > **countries** `string[]` *required*
> >
> > Países, como códigos ISO 3166-1 alfa-2 como `US`.
> >
> > **country\_groups** `string[]` *required*
> >
> > Grupos de varios países, como `worldwide` o `europe`.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Áreas circulares, cada una formada por una coordenada y un radio.
> >
> > > [accordion] Propiedades
> > >
> > > **country\_code** `string`
> > >
> > > País ISO 3166-1 alfa-2 en el que se encuentra el punto. Envíalo en una categoría especial de anuncios, donde la campaña debe declarar los países a los que llegan sus conjuntos de anuncios.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > Unidad de `radius`.
> > >
> > > Opciones disponibles: `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Latitud del punto central.
> > >
> > > **longitude** `number` *required*
> > >
> > > Longitud del punto central.
> > >
> > > **name** `string`
> > >
> > > Etiqueta de la ubicación, como una ciudad o una dirección. Ausente cuando la ubicación no tiene etiqueta.
> > >
> > > **radius** `number` *required*
> > >
> > > Radio alrededor del punto central, en `distance_unit`.
> >
> > **regions** `string[]` *required*
> >
> > Estados de EE. UU. y DC, como códigos ISO 3166-2 como `US-CA`. Los territorios de EE. UU. (`PR`, `GU`, `VI`, `AS`, `MP`) y cualquier lugar fuera de EE. UU. se segmentan mediante `countries`.
> >
> > **zips** `string[]` *required*
> >
> > Códigos ZIP y postales, indexados como `COUNTRY:CODE`, como `US:78756`.

**result\_event** `string | null` *required*

El evento de conversión del píxel de Whop cuyo recuento atribuido representa los resultados: el objetivo de optimización, o el evento atribuido de mayor volumen en las campañas con presupuesto por grupo de anuncios. Null cuando el objetivo no es un evento atribuido por Whop.

Opciones disponibles: `purchase`, `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `custom`, `messaging_conversation`

**result\_event\_name** `string | null` *required*

El nombre del evento definido por el comerciante cuando result\_event es custom; null para los eventos estándar.

**results** `number | null` *required*

El recuento atribuido por el píxel de Whop detrás de result\_event. Cuando los grupos de anuncios de una campaña optimizan objetivos distintos no hay un único result\_event (es null), y esto es en cambio la suma de los resultados atribuidos de cada grupo de anuncios. Null cuando no se está optimizando para nada atribuible por Whop.

**return\_on\_ad\_spend** `number` *required*

Valor de compra dividido entre el gasto, ambos en USD (una proporción independiente de la moneda); 0 cuando no hay gasto.

**schedule\_value** `number` *required*

Valor en USD atribuido a los eventos de agendamiento. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**schedules** `number` *required*

Eventos de agendamiento atribuidos por el píxel de Whop, último clic.

**spend** `number` *required*

El importe cobrado, en spend\_currency.

**spend\_currency** `string | null` *required*

El código de moneda ISO 4217 de todas las métricas monetarias.

**starts\_at** `string | null` *required*

Cuándo empieza a entregarse el grupo de anuncios, como marca de tiempo ISO 8601. `null` cuando empieza en cuanto está activo.

**status** `string` *required*

Si el grupo de anuncios está habilitado. `active` y `paused` los estableces tú; `rejected` significa que no superó la revisión de anuncios; `duplicating` es una copia que todavía se está completando.

Opciones disponibles: `active`, `paused`, `rejected`, `duplicating`

**submitted\_application\_value** `number` *required*

Valor en USD atribuido a los eventos de envío de solicitud. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**submitted\_applications** `number` *required*

Eventos de envío de solicitud atribuidos por el píxel de Whop, último clic.

**title** `string | null` *required*

Nombre visible del grupo de anuncios.

**unique\_click\_through\_rate** `number | null` *required*

Clics únicos divididos entre impresiones, entre 0 y 1.

**unique\_clicks** `number` *required*

Personas que hicieron clic, informadas por el píxel de Whop, contadas una vez por persona.

**updated\_at** `string` *required*

Cuándo se actualizó el grupo de anuncios por última vez, como marca de tiempo ISO 8601.

**viewed\_content\_value** `number` *required*

Valor en USD atribuido a los eventos de visualización de contenido. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**viewed\_contents** `number` *required*

Eventos de visualización de contenido atribuidos por el píxel de Whop, último clic.

```json AdGroup theme={null}
{
	"id": "adgrp_xxxxxxxxxxx",
	"ad_campaign": {
		"id": "adcamp_xxxxxxxxxx"
	},
	"added_to_cart_value": 1050,
	"added_to_carts": 24,
	"audiences": {
		"exclude": [],
		"include": ["adaud_xxxxxxxxxxx"]
	},
	"bid_type": "minimum_cost",
	"budget_amount": 100,
	"budget_amount_local": 100,
	"budget_currency": "usd",
	"budget_type": "daily",
	"click_through_rate": 0.036,
	"clicks": 720,
	"completed_registration_value": 0,
	"completed_registrations": 16,
	"contact_value": 0,
	"contacts": 10,
	"conversion_event": "purchase",
	"cost_per_added_to_cart": 8.33,
	"cost_per_click": 0.28,
	"cost_per_completed_registration": 12.5,
	"cost_per_contact": 20,
	"cost_per_lead": 13.33,
	"cost_per_mille": 10,
	"cost_per_purchase": 25,
	"cost_per_result": 25,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.33,
	"cost_per_viewed_content": 0.67,
	"created_at": "2026-06-01T12:00:00Z",
	"custom_conversions": 5,
	"custom_event_counts": {
		"QualifiedCall": 4,
		"BookedDemo": 1
	},
	"custom_event_values": {
		"QualifiedCall": 2000,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"learning_progress": null,
	"demographics": {
		"automatic": false,
		"minimum_age": 21,
		"maximum_age": 45,
		"gender": "all"
	},
	"delivery_schedule": {
		"monday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"tuesday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"wednesday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"thursday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"friday": [
			{
				"start": "09:00",
				"end": "12:00"
			},
			{
				"start": "16:00",
				"end": "20:00"
			}
		],
		"saturday": [
			{
				"start": "10:00",
				"end": "14:00"
			}
		],
		"sunday": [
			{
				"start": "12:00",
				"end": "16:00"
			}
		]
	},
	"desired_cost_per_result": 30,
	"devices": {
		"platforms": ["mobile", "desktop"],
		"operating_systems": [
			{
				"os": "ios",
				"minimum_version": "18.0"
			}
		]
	},
	"ends_at": "2026-07-01T12:00:00Z",
	"frequency": 1.6,
	"impressions": 20000,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"category": "error",
			"title": "Ad issue",
			"message": "The audience is too narrow to deliver. Broaden the targeting to reach more people.",
			"resource_id": "adgrp_xxxxxxxxxxx",
			"resource_type": "ad_group"
		}
	],
	"languages": ["en"],
	"lead_value": 750,
	"leads": 15,
	"link_clicks": 576,
	"purchase_value": 5200,
	"purchases": 8,
	"reach": 12500,
	"regions": {
		"include": {
			"countries": ["US"],
			"country_groups": [],
			"regions": ["US-CA"],
			"cities": [
				{
					"key": "2418779",
					"name": "Miami"
				}
			],
			"zips": [],
			"custom_locations": [
				{
					"latitude": 30.2672,
					"longitude": -97.7431,
					"radius": 10,
					"distance_unit": "mile",
					"name": "Austin, TX"
				}
			]
		},
		"exclude": {
			"countries": [],
			"country_groups": [],
			"regions": [],
			"cities": [
				{
					"key": "2421215",
					"name": "Anchorage"
				}
			],
			"zips": [],
			"custom_locations": [
				{
					"latitude": 40.758,
					"longitude": -73.9855,
					"radius": 2,
					"distance_unit": "mile",
					"name": "Times Square"
				}
			]
		}
	},
	"result_event": "purchase",
	"result_event_name": null,
	"results": 8,
	"return_on_ad_spend": 26,
	"schedule_value": 0,
	"schedules": 0,
	"spend": 200,
	"spend_currency": "usd",
	"starts_at": "2026-06-01T12:00:00Z",
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"title": "US founders",
	"unique_click_through_rate": 0.03,
	"unique_clicks": 600,
	"updated_at": "2026-06-02T12:00:00Z",
	"viewed_content_value": 0,
	"viewed_contents": 300
}
```


## Related topics

- [API de Ad Campaigns](https://docs.whop.com/es/api-reference/ad-campaigns/ad-campaign.md)
- [API de Ad Pixels](https://docs.whop.com/es/api-reference/ad-pixels/ad-pixel.md)
- [Delete an Ad Group](https://docs.whop.com/es/api-reference/ad-groups/delete-an-ad-group.md)
