Skip to main content
Whop Ads kører betalte annoncer på eksterne annoncenetværk direkte fra din Whop-konto. Annonceforbrug faktureres til kontoens konfigurerede kort eller saldo på tværs af dens kampagner. Whop håndterer annoncekontoen, gennemgang, lancering og fakturering. To API-kald fører dig fra ingenting til en live annonce: generér en kreativ, og opret derefter kampagnen, annoncegruppen og annoncen i én anmodning.

Ressourcer

Fakturering og genopretning af betalinger

Forbrug opkræves på kontoniveau på tværs af kampagner. En mislykket betaling blokerer levering med delivery_status: "payment_failed", mens hver kampagnes konfigurerede active/paused-status bevares. Ret kontoens betalingsmetode, og kald derefter Retry Failed Ads Payments én gang for kontoen. Svaret sætter et forsøg i kø i baggrunden; det bekræfter ikke betalingen. Efter afregning kan aktive kampagner genoptages, og pausede kampagner forbliver pausede, med forbehold for andre leveringskrav. Se Betaling for annoncer for dashboard-forløbet, et anmodningseksempel, adfærd ved duplikerede anmodninger og håndtering af ældre kampagner.

Engangsopsætning

  • Scopes: media:generate, media:read, ad_campaign:create, ad_campaign:update, ad_campaign:basic:read.
  • Betalingsmetode til annoncer: tilknyttes i dashboardet (saldo eller kort). Kun lancering kræver den — kladder virker uden.
1

Generér en kreativ

Faktureres fra din saldo (amount_charged; utilstrækkelig saldo → 402 med en deposit_url). Poll GET /media/{id}, indtil status er ready, og brug derefter file.id:
failed refunderer beløbet — justér prompten, og prøv igen. Video: "type": "video" plus valgfri duration_seconds (5/10/15), resolution (480p–4k) og op til 4 reference_media-fil-ID’er (den første danner grundlag for åbningsbilledet).
2

Opret og lancér annoncen — én anmodning

POST /ads med en inline ad_group og ad_campaign opretter hele træet i én transaktion og lancerer det:
Ikke klar til at bruge penge? Tilføj "status": "draft" til ad_campaign, og lancér senere med PATCH /ad_campaigns/{id} {"status": "active"}.For at genbruge eksisterende containere skal du sende ad_group_id i stedet for ad_group eller ad_campaign_id i stedet for ad_campaign.
3

Overvåg

Poll GET /ads/{id}: delivery_status er den aktuelle tilstand (en kort in_review til indholdsmoderering er normal), og issues[] indeholder en menneskeligt læsbar message for alt, hvad annoncenetværket har afvist asynkront.Styr levering med pause / unpause på annoncer, annoncegrupper eller kampagner. Redigér tekst eller kreativer med PATCH /ads/{id} — når du sender creatives, erstattes hele sættet, så husk at inkludere basisposten.

Fejl

Hver kontrol er en 400, hvis besked fortæller, hvad der skal rettes: