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

# Ad Groups API

> En Ad Group ligger inde i en annoncekampagne og styrer levering af annoncer. Den angiver målgruppen, tidsplanen og budgettet for sine annoncer.

En Ad Group ligger inde i en [annoncekampagne](https://docs.whop.com/da/api-reference/ad-campaigns/ad-campaign) og styrer levering af [annoncer](https://docs.whop.com/da/api-reference/ads/ad). Den angiver målgruppen, tidsplanen og budgettet for sine annoncer.

Brug Ad Groups API'et til at oprette annoncegrupper i kampagner, vise eller hente målretnings- og leveringsindstillinger, opdatere budgetter eller målretning, slette grupper, der skal stoppe med at køre, og sætte levering på pause eller genoptage den.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis Ad Groups](https://docs.whop.com/da/api-reference/ad-groups/list-ad-groups.md) | GET `/ad_groups` |
| [Hent en Ad Group](https://docs.whop.com/da/api-reference/ad-groups/retrieve-an-ad-group.md) | GET `/ad_groups/{id}` |
| [Opret en Ad Group](https://docs.whop.com/da/api-reference/ad-groups/create-an-ad-group.md) | POST `/ad_groups` |
| [Duplikér en Ad Group](https://docs.whop.com/da/api-reference/ad-groups/duplicate-an-ad-group.md) | POST `/ad_groups/{id}/duplicate` |
| [Sæt en Ad Group på pause](https://docs.whop.com/da/api-reference/ad-groups/pause-an-ad-group.md) | POST `/ad_groups/{id}/pause` |
| [Genoptag en Ad Group](https://docs.whop.com/da/api-reference/ad-groups/unpause-an-ad-group.md) | POST `/ad_groups/{id}/unpause` |
| [Opdater en Ad Group](https://docs.whop.com/da/api-reference/ad-groups/update-an-ad-group.md) | PATCH `/ad_groups/{id}` |
| [Slet en Ad Group](https://docs.whop.com/da/api-reference/ad-groups/delete-an-ad-group.md) | DELETE `/ad_groups/{id}` |

## Målretningsbegrænsninger

Annoncegrupper kan ikke målrette de [lande, der er angivet i annonceguiden](https://docs.whop.com/da/developer/ads/overview.md#countries-you-cannot-target). Anmodninger om at oprette en annoncegruppe eller opdatere dens målrettede lande afvises, hvis de indeholder et blokeret land i `regions.include.countries`.

## Attributter

**id** `string` *required*

Unik identifikator for annoncegruppen med præfikset `adgrp_`.

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

Den annoncekampagne, som denne annoncegruppe tilhører.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Den refererede enheds id.

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

USD-værdi tilskrevet add-to-cart-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

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

Whop-pixel-tilskrevne add-to-cart-hændelser, last-click.

**audiences** `object` *required*

Gemte audiences, som denne annoncegruppe leverer til eller udelukker.

> [accordion] Egenskaber
>
> **exclude** `string[]` *required*
>
> ID'er for gemte audiences, der er udelukket fra levering, med præfikset `adaud_`.
>
> **include** `string[]` *required*
>
> ID'er for gemte audiences, som annoncegruppen leverer til, med præfikset `adaud_`.

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

Hvordan leveringsbud fastsættes i annonceauktionen. Målbaserede strategier bruger `desired_cost_per_result`.

Tilgængelige muligheder: `minimum_cost`, `average_target`, `maximum_target`

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

Denne annoncegruppes budget i USD, som er den valuta, det gemmes og faktureres i. `null`, når budgettet i stedet er angivet på kampagnen.

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

Det samme budget angivet i `budget_currency` til dagens vekselkurs, til visning i kontoens rapporteringsvaluta for annoncer. `null`, når `budget_amount` er det.

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

ISO 4217-koden, som `budget_amount_local` er i: kontoens `ads_reporting_currency`-præference. `usd`, medmindre kontoen har ændret den.

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

Om `budget_amount` bruges pr. dag (`daily`) eller over annoncegruppens samlede løbetid (`lifetime`). En `lifetime`-annoncegruppe kræver også `ends_at`, mindst 24 timer efter at den starter.

Tilgængelige muligheder: `daily`, `lifetime`

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

Klik divideret med visninger, mellem 0 og 1.

**clicks** `number` *required*

Antallet af klik.

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

USD-værdi tilskrevet complete-registration-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

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

Whop-pixel-tilskrevne complete-registration-hændelser, last-click.

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

USD-værdi tilskrevet contact-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**contacts** `number` *required*

Whop-pixel-tilskrevne contact-hændelser, last-click.

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

Den pixelhændelse, der optimeres efter. En standardhændelse eller en vilkårlig brugerdefineret pixelhændelse
name.

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

Forbrug divideret med tilskrevne add-to-cart-hændelser; null, når de ikke er målet, og ingen er tilskrevet.

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

Forbrug divideret med klik; 0, når der ikke er nogen klik.

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

Forbrug divideret med tilskrevne complete-registration-hændelser; null, når de ikke er målet, og ingen er tilskrevet.

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

Forbrug divideret med tilskrevne contact-hændelser; null, når kontakter ikke er målet, og ingen er tilskrevet.

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

Forbrug divideret med tilskrevne leads; null, når leads ikke er et mål, og ingen er tilskrevet.

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

Forbrug pr. 1.000 visninger; 0, når der ikke er nogen visninger.

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

Forbrug divideret med tilskrevne køb; null, når køb ikke er et mål, og ingen er tilskrevet.

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

Forbrug divideret med Whop-pixel-tilskrevne resultater; null, når der ikke optimeres efter noget, Whop kan tilskrive.

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

Forbrug divideret med tilskrevne schedule-hændelser; null, når bookinger ikke er målet, og ingen er tilskrevet.

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

Forbrug divideret med tilskrevne submit-application-hændelser; null, når de ikke er målet, og ingen er tilskrevet.

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

Forbrug divideret med unikke klik; null, når der ikke er nogen unikke klik.

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

Forbrug divideret med tilskrevne view-content-hændelser; null, når de ikke er målet, og ingen er tilskrevet.

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

Hvornår annoncegruppen blev oprettet, som et ISO 8601-tidsstempel.

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

Whop-pixel-tilskrevne brugerdefinerede (forhandlerdefinerede) konverteringshændelser, last-click, på tværs af alle brugerdefinerede hændelsesnavne.

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

Whop-pixel-tilskrevne brugerdefinerede konverteringer med dit hændelsesnavn som nøgle og dets last-click-antal som værdi. Tom, når ingen navngivne brugerdefinerede hændelser er tilskrevet. Brugerdefinerede hændelser, der udløses uden et navn, tælles med i custom\_conversions, men udelades her, så disse værdier summerer til højst custom\_conversions.

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

Konverteringsværdi tilskrevet hver brugerdefineret hændelse med hændelsesnavnet som nøgle ligesom custom\_event\_counts. Summerer den værdi, der sendes til whop.track, normaliseret til USD; hændelser, der udløses uden en værdi, bidrager med 0.

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

Timer, hvor annoncegruppen leverer hver uge, med dagen som nøgle. Dage, hvor den ikke leverer, udelades. `null`, når den leverer alle timer. Nogle platforme kræver en lifetime-`budget_type` for en tidsplan, på annoncegruppen eller på dens kampagne, når kampagnen har budgettet.

> [accordion] Egenskaber
>
> **friday** `object[]`
>
> Tidsvinduer, hvor annoncegruppen leverer om fredagen, i tidsrækkefølge. Udeladt, når den ikke leverer den dag.
>
> > [accordion] Egenskaber
> >
> > **end** `string` *required*
> >
> > Hvornår levering stopper, som et 24-timers `HH:00`-tidspunkt op til `24:00` for midnat. Senere end `start`; et vindue efter midnat deles over to dage.
> >
> > **start** `string` *required*
> >
> > Hvornår levering starter, som et 24-timers `HH:00`-tidspunkt fra `00:00` til `23:00`.
>
> **monday** `object[]`
>
> Tidsvinduer, hvor annoncegruppen leverer om mandagen, i tidsrækkefølge. Udeladt, når den ikke leverer den dag.
>
> > [accordion] Egenskaber
> >
> > **end** `string` *required*
> >
> > Hvornår levering stopper, som et 24-timers `HH:00`-tidspunkt op til `24:00` for midnat. Senere end `start`; et vindue efter midnat deles over to dage.
> >
> > **start** `string` *required*
> >
> > Hvornår levering starter, som et 24-timers `HH:00`-tidspunkt fra `00:00` til `23:00`.
>
> **saturday** `object[]`
>
> Tidsvinduer, hvor annoncegruppen leverer om lørdagen, i tidsrækkefølge. Udeladt, når den ikke leverer den dag.
>
> > [accordion] Egenskaber
> >
> > **end** `string` *required*
> >
> > Hvornår levering stopper, som et 24-timers `HH:00`-tidspunkt op til `24:00` for midnat. Senere end `start`; et vindue efter midnat deles over to dage.
> >
> > **start** `string` *required*
> >
> > Hvornår levering starter, som et 24-timers `HH:00`-tidspunkt fra `00:00` til `23:00`.
>
> **sunday** `object[]`
>
> Tidsvinduer, hvor annoncegruppen leverer om søndagen, i tidsrækkefølge. Udeladt, når den ikke leverer den dag.
>
> > [accordion] Egenskaber
> >
> > **end** `string` *required*
> >
> > Hvornår levering stopper, som et 24-timers `HH:00`-tidspunkt op til `24:00` for midnat. Senere end `start`; et vindue efter midnat deles over to dage.
> >
> > **start** `string` *required*
> >
> > Hvornår levering starter, som et 24-timers `HH:00`-tidspunkt fra `00:00` til `23:00`.
>
> **thursday** `object[]`
>
> Tidsvinduer, hvor annoncegruppen leverer om torsdagen, i tidsrækkefølge. Udeladt, når den ikke leverer den dag.
>
> > [accordion] Egenskaber
> >
> > **end** `string` *required*
> >
> > Hvornår levering stopper, som et 24-timers `HH:00`-tidspunkt op til `24:00` for midnat. Senere end `start`; et vindue efter midnat deles over to dage.
> >
> > **start** `string` *required*
> >
> > Hvornår levering starter, som et 24-timers `HH:00`-tidspunkt fra `00:00` til `23:00`.
>
> **tuesday** `object[]`
>
> Tidsvinduer, hvor annoncegruppen leverer om tirsdagen, i tidsrækkefølge. Udeladt, når den ikke leverer den dag.
>
> > [accordion] Egenskaber
> >
> > **end** `string` *required*
> >
> > Hvornår levering stopper, som et 24-timers `HH:00`-tidspunkt op til `24:00` for midnat. Senere end `start`; et vindue efter midnat deles over to dage.
> >
> > **start** `string` *required*
> >
> > Hvornår levering starter, som et 24-timers `HH:00`-tidspunkt fra `00:00` til `23:00`.
>
> **wednesday** `object[]`
>
> Tidsvinduer, hvor annoncegruppen leverer om onsdagen, i tidsrækkefølge. Udeladt, når den ikke leverer den dag.
>
> > [accordion] Egenskaber
> >
> > **end** `string` *required*
> >
> > Hvornår levering stopper, som et 24-timers `HH:00`-tidspunkt op til `24:00` for midnat. Senere end `start`; et vindue efter midnat deles over to dage.
> >
> > **start** `string` *required*
> >
> > Hvornår levering starter, som et 24-timers `HH:00`-tidspunkt fra `00:00` til `23:00`.

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

Om annoncer i denne annoncegruppe leveres lige nu, og hvis ikke, hvorfor. Når flere tilstande gælder på én gang, returneres den med højest prioritet.

Tilgængelige muligheder: `all_ads_rejected`, `rejected`, `draft`, `campaign_paused`, `paused`, `in_review`, `processing`, `revise_content`, `issues`, `scheduled`, `completed`, `learning`, `active`

**demographics** `object` *required*

Målretning efter alder, køn og automatisk målgruppe.

> [accordion] Egenskaber
>
> **automatic** `boolean` *required*
>
> Om automatisk målgruppemålretning er slået til. Når den er `true`, kan levering nå ud over de aldre og køn, du angiver, idet de behandles som forslag.
>
> **gender** `string` *required*
>
> Målrettet køn.
>
> Tilgængelige muligheder: `all`, `male`, `female`
>
> **maximum\_age** `number | null` *required*
>
> Højeste målrettede alder. `null`, når der ikke er angivet et maksimum.
>
> **minimum\_age** `number | null` *required*
>
> Laveste målrettede alder. `null`, når der ikke er angivet et minimum.

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

Pris pr. resultat, der skal sigtes efter (`average_target`) eller aldrig overskrides (`maximum_target`). `null` for `minimum_cost`-budgivning.

**devices** `object` *required*

Målrettede enhedsplatforme og operativsystemer.

> [accordion] Egenskaber
>
> **operating\_systems** `object[]` *required*
>
> Målrettede operativsystemer. Tom målretter alle operativsystemer.
>
> > [accordion] Egenskaber
> >
> > **minimum\_version** `string`
> >
> > Laveste målrettede OS-version, såsom `18.0`. Fraværende, når enhver version kvalificerer.
> >
> > **os** `string` *required*
> >
> > Målrettet operativsystem.
> >
> > Tilgængelige muligheder: `ios`, `android`
>
> **platforms** `string[]` *required*
>
> Målrettede enhedstyper. Tom målretter alle enheder.
>
> Tilgængelige muligheder: `mobile`, `desktop`

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

Hvornår annoncegruppen stopper med at levere, som et ISO 8601-tidsstempel. `null`, når den kører, indtil den sættes på pause.

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

Visninger divideret med rækkevidde.

**impressions** `number` *required*

Antallet af visninger.

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

Åbne problemer, der påvirker denne annoncegruppe og dens annoncer. Tom, når der ikke er nogen.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Unik identifikator for problemet.
>
> **category** `string` *required*
>
> Problemets type: information om levering, en advarsel eller en fejl, der kræver opmærksomhed.
>
> Tilgængelige muligheder: `information`, `warning`, `error`
>
> **message** `string` *required*
>
> En beskrivelse af, hvad problemet er, og hvordan det kan løses.
>
> **resource\_id** `string | null` *required*
>
> ID'et for den kampagne, annoncegruppe eller annonce, som problemet er knyttet til.
>
> **resource\_type** `string` *required*
>
> Typen af den ressource, som problemet er knyttet til.
>
> Tilgængelige muligheder: `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> En kort titel til skaberen for problemet: den regel, en afvisning ved indholdsgennemgang nævner, eller en generisk etiket.

**keywords** `object[]`

Søgetermer, som denne annoncegruppes annoncer kan vises for, og termer, de aldrig vises for. Kun søgekampagner, hvor hver annoncegruppe skal have mindst én før lancering.

> [accordion] Egenskaber
>
> **match\_type** `string` *required*
>
> Hvor tæt en søgning skal matche: `broad` når også relaterede søgninger, `phrase` kræver frasens betydning, og `exact` kræver samme betydning som termen. Standard er `broad`.
>
> Tilgængelige muligheder: `broad`, `phrase`, `exact`
>
> **negative** `boolean` *required*
>
> Om denne term forhindrer annoncerne i at blive vist i stedet for at gøre dem berettigede. Standard er `false`.
>
> **text** `string` *required*
>
> Søgetermen, op til 80 tegn og 10 ord.

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

Målrettede sprog som ISO 639-koder, såsom `en` eller `es`. En regionsspecifik locale uden ISO-kode vises som en numerisk locale-nøgle. Tom målretter alle sprog.

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

USD-værdi tilskrevet lead-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**leads** `number` *required*

Whop-pixel-tilskrevne leads, last-click.

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

Fremskridt mod de konverteringer, som denne annoncegruppes læringsfase kræver. Null, medmindre den er i læring eller begrænset læring, og gyldige antal er tilgængelige. At nå tærsklen afgør ikke leveringsstatus.

> [accordion] Egenskaber
>
> **conversion\_threshold** `integer` *required*
>
> De konverteringer, som denne annoncegruppes læringsfase kræver. Det kan ændre sig under levering.
>
> **conversions** `integer` *required*
>
> Konverteringer talt siden den seneste væsentlige redigering i denne annoncegruppes læringsfase.
>
> **progress\_percent** `number` *required*
>
> Konverteringer divideret med tærsklen, som en procentdel begrænset til 0–100. Annoncegruppens `delivery_status` er fortsat afgørende.

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

Sidevisninger på din destination fra personer, der klikkede på annoncen, registreret af Whop-pixelen. Tælles på samme måde på alle annonceplatforme.

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

USD-værdi af pixel-tilskrevne køb.

**purchases** `number` *required*

Whop-pixel-tilskrevne køb, last-click.

**reach** `number` *required*

Antallet af unikke personer, der så dette.

**regions** `object` *required*

Målrettede og udelukkede lokationer.

> [accordion] Egenskaber
>
> **exclude** `object` *required*
>
> Lokationer, der er udelukket fra målretning. Landegrupper kan ikke udelukkes.
>
> > [accordion] Egenskaber
> >
> > **cities** `object[]` *required*
> >
> > Byer med lokationstaksonomien som nøgle.
> >
> > > [accordion] Egenskaber
> > >
> > > **key** `string` *required*
> > >
> > > Byens nøgle i lokationstaksonomien.
> > >
> > > **name** `string`
> > >
> > > Bynavn, såsom `Austin`. Fraværende, når lokationstaksonomien ikke har et.
> >
> > **countries** `string[]` *required*
> >
> > Lande som ISO 3166-1 alpha-2-koder, såsom `US`.
> >
> > **country\_groups** `string[]` *required*
> >
> > Grupper af flere lande, såsom `worldwide` eller `europe`.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Cirkulære områder, hver en koordinat plus en radius.
> >
> > > [accordion] Egenskaber
> > >
> > > **country\_code** `string`
> > >
> > > ISO 3166-1 alpha-2-landet, som punktet ligger i. Send det under en særlig annoncekategori, hvor kampagnen skal erklære de lande, dens annoncesæt når.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > Enhed for `radius`.
> > >
> > > Tilgængelige muligheder: `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Centrumpunktets breddegrad.
> > >
> > > **longitude** `number` *required*
> > >
> > > Centrumpunktets længdegrad.
> > >
> > > **name** `string`
> > >
> > > Etiket for lokationen, såsom en by eller adresse. Fraværende, når lokationen ikke har en etiket.
> > >
> > > **radius** `number` *required*
> > >
> > > Radius omkring centrumpunktet i `distance_unit`.
> >
> > **regions** `string[]` *required*
> >
> > Amerikanske delstater og DC som ISO 3166-2-koder, såsom `US-CA`. Amerikanske territorier (`PR`, `GU`, `VI`, `AS`, `MP`) og alt uden for USA målrettes via `countries`.
> >
> > **zips** `string[]` *required*
> >
> > Post- og ZIP-koder med nøglen `COUNTRY:CODE`, såsom `US:78756`.
>
> **include** `object` *required*
>
> Lokationer, som annoncegruppen målretter.
>
> > [accordion] Egenskaber
> >
> > **cities** `object[]` *required*
> >
> > Byer med lokationstaksonomien som nøgle.
> >
> > > [accordion] Egenskaber
> > >
> > > **key** `string` *required*
> > >
> > > Byens nøgle i lokationstaksonomien.
> > >
> > > **name** `string`
> > >
> > > Bynavn, såsom `Austin`. Fraværende, når lokationstaksonomien ikke har et.
> >
> > **countries** `string[]` *required*
> >
> > Lande som ISO 3166-1 alpha-2-koder, såsom `US`.
> >
> > **country\_groups** `string[]` *required*
> >
> > Grupper af flere lande, såsom `worldwide` eller `europe`.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Cirkulære områder, hver en koordinat plus en radius.
> >
> > > [accordion] Egenskaber
> > >
> > > **country\_code** `string`
> > >
> > > ISO 3166-1 alpha-2-landet, som punktet ligger i. Send det under en særlig annoncekategori, hvor kampagnen skal erklære de lande, dens annoncesæt når.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > Enhed for `radius`.
> > >
> > > Tilgængelige muligheder: `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Centrumpunktets breddegrad.
> > >
> > > **longitude** `number` *required*
> > >
> > > Centrumpunktets længdegrad.
> > >
> > > **name** `string`
> > >
> > > Etiket for lokationen, såsom en by eller adresse. Fraværende, når lokationen ikke har en etiket.
> > >
> > > **radius** `number` *required*
> > >
> > > Radius omkring centrumpunktet i `distance_unit`.
> >
> > **regions** `string[]` *required*
> >
> > Amerikanske delstater og DC som ISO 3166-2-koder, såsom `US-CA`. Amerikanske territorier (`PR`, `GU`, `VI`, `AS`, `MP`) og alt uden for USA målrettes via `countries`.
> >
> > **zips** `string[]` *required*
> >
> > Post- og ZIP-koder med nøglen `COUNTRY:CODE`, såsom `US:78756`.

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

Den Whop-pixel-konverteringshændelse, hvis tilskrevne antal repræsenterer resultater — optimeringsmålet eller den tilskrevne hændelse med størst volumen for kampagner, der budgetterer pr. annoncegruppe. Null, når målet ikke er en Whop-tilskrevet hændelse.

Tilgængelige muligheder: `purchase`, `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `custom`, `messaging_conversation`

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

Det forhandlerdefinerede hændelsesnavn, når result\_event er custom; null for standardhændelserne.

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

Det Whop-pixel-tilskrevne antal bag result\_event. Når en kampagnes annoncegrupper optimerer efter forskellige mål, er der ingen enkelt result\_event (den er null), og dette er i stedet summen af hver annoncegruppes egne tilskrevne resultater. Null, når der ikke optimeres efter noget, Whop kan tilskrive.

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

Købsværdi divideret med forbrug, begge i USD (et valutaneutralt forhold); 0, når der ikke er noget forbrug.

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

USD-værdi tilskrevet schedule-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**schedules** `number` *required*

Whop-pixel-tilskrevne schedule-hændelser, last-click.

**spend** `number` *required*

Det opkrævede beløb i spend\_currency.

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

ISO 4217-valutakoden for alle monetære målinger.

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

Hvornår annoncegruppen begynder at levere, som et ISO 8601-tidsstempel. `null`, når den starter, så snart den er aktiv.

**status** `string` *required*

Om annoncegruppen er aktiveret. `active` og `paused` angives af dig; `rejected` betyder, at den ikke bestod annoncegennemgangen; `duplicating` er en kopi, der stadig udfyldes.

Tilgængelige muligheder: `active`, `paused`, `rejected`, `duplicating`

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

USD-værdi tilskrevet submit-application-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

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

Whop-pixel-tilskrevne submit-application-hændelser, last-click.

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

Annoncegruppens visningsnavn.

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

Unikke klik divideret med visninger, mellem 0 og 1.

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

Personer, der klikkede, rapporteret af Whop-pixelen, talt én gang pr. person.

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

Hvornår annoncegruppen sidst blev opdateret, som et ISO 8601-tidsstempel.

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

USD-værdi tilskrevet view-content-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

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

Whop-pixel-tilskrevne view-content-hændelser, last-click.

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