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

# Annoncér med Whop Ads

> Køb annoncer på eksterne annoncenetværk via din Whop-konto, med fakturering håndteret på kontoniveau.

Annoncering lader dig købe annoncer på eksterne annoncenetværk fra din Whop-konto. Whop ejer annoncekontoen, gennemgangs- og lanceringsforløbet samt faktureringsforholdet. Du opretter en kampagne via API'et i stedet for at forbinde en annoncekonto, du selv administrerer.

## Hvad du kan bygge

* **Kør kampagner** med et mål, et budget og en tidsplan.
* **Målret et publikum** efter placering, demografi, interesser, enheder og sprog, eller upload en kundeliste som et [publikum](https://docs.whop.com/da/api-reference/audiences/audience).
* **Generér kreativer** som AI-billeder eller -video ud fra en prompt, lever dine egne aktiver, eller promovér et opslag, der allerede findes på en forbundet ekstern konto.
* **Læs attribueret performance**: forbrug, resultater, pris pr. resultat og afkast på annonceforbrug, alt sammen direkte på kampagneobjektet.

## Lande, du ikke kan målrette

Whop tillader ikke kampagner, der målretter disse lande:

| Land | Landekode |
| - | - |
| Sudan | `SD` |
| Rusland | `RU` |
| Cuba | `CU` |
| Iran | `IR` |
| Nordkorea | `KP` |

Anmodninger om at oprette en annoncegruppe eller opdatere dens målrettede lande afvises, hvis de indeholder nogen af disse koder. Fjern dem fra dine målrettede placeringer, før du sender anmodningen.

## Før du bruger penge

To ting skal være på plads, før en annonce kan gå live, og begge er engangsopsætning:

* **En betalingsmetode** forbundet i dashboardet, enten din Whop-saldo eller et kort. Kladder fungerer uden.
* **Whop-pixlen** på din destination, medmindre du sender trafik til en butiksside på whop.com. Enhver ekstern landingsside skal først have [pixlen](https://docs.whop.com/da/developer/ads/pixel.md).

[Oversigten over Ads API'et](https://docs.whop.com/da/api-reference/ads/overview.md) dækker hver af disse med de præcise kald, de krævede scopes og de fejlstrenge, du får, når en af dem mangler.

## Kerneobjekter

Annoncekampagne, annoncegruppe, annonce, publikum. Hver af dem er defineret i [Kernebegreber](https://docs.whop.com/da/developer/concepts.md).

Annoncering har ét hierarki, og hvert objekt hører til niveauet over det.

**ad campaign** `adcamp_`

Indeholder målet og budgetstrategien. Se [Annoncekampagner](https://docs.whop.com/da/api-reference/ad-campaigns/ad-campaign).

**ad group** `adgrp_`

Indeholder målretning, optimeringsmålet, tidsplanen og som standard sit eget budget. Se [Annoncegrupper](https://docs.whop.com/da/api-reference/ad-groups/ad-group).

**ad** `ad_`

Indeholder kreativerne, tekstvarianterne, call to action og destinations-URL'en. Se [Annoncer](https://docs.whop.com/da/api-reference/ads/ad).

[`POST /ads`](https://docs.whop.com/da/api-reference/ads/create-an-ad) accepterer en inline `ad_group`, som accepterer en inline `ad_campaign`, så én anmodning opretter hele træet i en enkelt transaktion. Angiv i stedet `ad_group_id` for at knytte annoncen til en annoncegruppe, der allerede findes.

For at lancere senere i stedet for nu skal du sætte `status` til `draft` på den inline `ad_campaign` og derefter aktivere den med [`PATCH /ad_campaigns/{id}`](https://docs.whop.com/da/api-reference/ad-campaigns/update-an-ad-campaign).

Budgettet ligger på præcis ét niveau, aldrig begge: som standard på annoncegruppen, eller på kampagnen, når du sætter `budget_optimization` til `ad_campaign`.

## Sådan tælles resultater

Hvert performancetal, Whop rapporterer, er attribueret af **Whop-pixlen**, ikke af annoncenetværket.

`result_event` angiver den konverteringshændelse, en kampagne bedømmes på, og `results` er det pixel-attribuerede antal af den. `cost_per_result` dividerer forbruget med det antal. Når en kampagnes annoncegrupper optimerer mod forskellige mål, er der ikke én enkelt `result_event`, så den er `null`, og `results` bliver summen af hver annoncegruppes egne attribuerede resultater. Når der ikke optimeres mod noget, Whop kan attribuere, er begge `null` i stedet for nul.

## Ønsket pris pr. resultat

En kampagnes `desired_cost_per_result` er den pris pr. resultat i USD, du ønsker, at den opnår. Det er kun et mål: det er ikke et omkostningsloft eller budloft, og det ændrer ikke, hvordan kampagnens annoncer byder. Affiliates, der kører kampagnen, ser det som den pris pr. resultat, de skal sigte efter. En annoncegruppes egen `desired_cost_per_result` er en anden indstilling: den er dens omkostningsloft eller budloft. Sæt kampagnens `desired_cost_per_result` til `null` for at fjerne målet.

## Betaling for annoncer

Forbrug påløber, efterhånden som annoncer leveres, og opkræves bagefter. **Fakturering hører til kontoen, på tværs af dens kampagner.** Hver opkrævning samler berettiget ubetalt kampagneforbrug i én betaling ved hjælp af kontoens konfigurerede betalingsmetoder til annoncer. Du konfigurerer ikke en separat betalingsmetode eller anmoder om et separat nyt forsøg for hver kampagne. Feltet `spend` på en kampagne er det beløb, du opkræves, i `spend_currency`.

Tidspunktet for opkrævning afhænger af påløbet forbrug og faktureringstærskler. Konsolidering betyder ikke én betaling pr. dag. AI-generering af kreativer bruger sin egen saldobetaling. For lav saldo returnerer en `402` med en `deposit_url`.

### Når en betaling mislykkes

En mislykket betaling på kontoen blokerer levering på tværs af dens fakturerbare kampagner. Hver berørt kampagne rapporterer `delivery_status: "payment_failed"`, mens dens konfigurerede `status` forbliver `active` eller `paused`. Læs `delivery_status` for at afgøre, om en kampagne kan levere, og `issues` for årsagen til fejlen.

Kontoen kan ikke aktivere kampagner, mens den har uløste betalingsfejl. Du kan stadig sætte en kampagne på pause for at holde den slukket efter betalingen er genoprettet. Whop planlægger også automatiske nye forsøg. Du kan anmode om et nyt forsøg, når du har rettet betalingsmetoden.

### Prøv en betaling igen

1. I din kontos Ads-dashboard skal du vælge **Update payment method** i banneret om mislykket betaling, eller åbne Ads-indstillinger og vælge **Billing**. Opdater kontoens kort, eller fyld den saldo op, den bruger.
2. Vælg **Retry payment** én gang for kontoen. API-integrationer skal kalde [Retry Failed Ads Payments](https://docs.whop.com/da/api-reference/accounts/retry-failed-ads-payments.md) med kontoens `biz_`-ID og tilladelsen `ad_campaign:update`.
3. Vent på forsøget i baggrunden. Et `202`-svar med `queued: true` bekræfter, at jobbet blev accepteret, **ikke at betalingen lykkedes**. Læs kontoens [annoncekampagner](https://docs.whop.com/da/api-reference/ad-campaigns/list-ad-campaigns.md) for at se resultatet.
4. Efter vellykket afregning fjernes betalingsblokeringen. Levering kan vise `processing`, mens den genberegnes og synkroniseres. Kampagner konfigureret som aktive kan genoptages, hvis deres øvrige leveringskrav er opfyldt. Kampagner konfigureret som sat på pause forbliver på pause.

```bash theme={null}
curl -X POST "https://api.whop.com/api/v1/accounts/biz_YOUR_ACCOUNT/retry_ads_payment" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-09-22"
```

```json theme={null}
{ "account_id": "biz_YOUR_ACCOUNT", "queued": true }
```

Gentagne anmodninger, mens et nyt forsøg for kontoen står i kø eller kører, returnerer en fejl, der beder dig vente. Hvis betalingen mislykkes igen, forbliver levering blokeret: tjek årsagen til fejlen, og ret betalingsmetoden, før du prøver igen. Lad være med at løbe kampagnerne igennem for at prøve hver enkelt igen. Det ældre [endpoint til nyt forsøg for kampagner](https://docs.whop.com/da/api-reference/ad-campaigns/retry-a-failed-ad-campaign-payment.md) sætter stadig et nyt forsøg for kontoen i kø på API-versioner før `2026-09-22`. Fra og med `2026-09-22` returnerer det `410 Gone`. Brug konto-endpointet ovenfor.

Ældre kampagner, hvis konfigurerede `status` allerede var `payment_failed`, vender tilbage til `paused` efter et vellykket nyt forsøg, fordi deres tidligere aktiv/pause-indstilling ikke blev bevaret.

## Hvorfor en kampagne ikke leverer

`delivery_status` besvarer dette direkte. Det er det første felt, du skal læse, når en kampagne findes, men intet sker. Flere tilstande kan være sande på én gang, så værdien er den højeste på denne rangstige:

| `delivery_status` | Hvad det betyder |
| - | - |
| `payment_failed` | Fakturering for kontoen mislykkedes. Levering er blokeret uden at ændre den konfigurerede aktiv/pause-indstilling |
| `all_ads_rejected` | Alle annoncer i kampagnen blev afvist |
| `draft` | Ikke indsendt til levering |
| `paused` | Du satte kampagnen eller alle dens annoncegrupper på pause, eller den har ingen annoncer tilbage. Sletning af en kampagnes sidste annonce eller annoncegruppe sætter den på pause |
| `in_review` | En annonce er stadig under indholdsgennemgang, og intet leveres endnu |
| `learning` | Leverer og er stadig i sin læringsperiode |
| `processing` | Kampagnen har ikke nået annoncenetværket, eller alle annoncegrupper behandles stadig |
| `revise_content` | Kampagnen venter på at køre, og indholdsgennemgangen holder alle ventende annoncer ude af mindst ét annoncenetværk. Læs hver annonces `content_review` |
| `issues` | Kampagnen har åbne problemer, eller alle annoncer har et. Læs arrayet `issues` |
| `scheduled` | Kampagnens start ligger i fremtiden, eller alle annoncegrupper venter på deres egen start |
| `completed` | Kampagnens sluttidspunkt er passeret. En kampagne uden slutning bliver aldrig fuldført |
| `active` | Leverer |

Annoncer og annoncegrupper har deres egen `delivery_status` med andre værdier. En ny annonce går gennem `in_review`, før den leverer.

## Hvor du skal hen nu

> [card] [Opret og lancér en annonce](https://docs.whop.com/da/api-reference/ads/overview.md)
>
> Hele forløbet, fra kreativ til live-annonce, i to kald.

> [card] [Installér pixlen](https://docs.whop.com/da/developer/ads/pixel.md)
>
> Påkrævet, før resultater kan attribueres.

> [card] [Byg et publikum](https://docs.whop.com/da/api-reference/audiences/create-audience.md)
>
> Upload en kundeliste, der skal målrettes eller udelukkes.

> [card] [Ads-reference](https://docs.whop.com/da/api-reference/ad-campaigns/ad-campaign)
>
> Alle annoncerings-endpoints med en playground.


## Related topics

- [Annoncer](https://docs.whop.com/da/api-reference/legacy/ads/ad.md)
- [Ads API – oversigt](https://docs.whop.com/da/api-reference/ads/overview.md)
- [Ads](https://docs.whop.com/da/elements/latest/ads/overview.md)
