Skip to main content
Whop Ads toont betaalde advertenties op externe advertentienetwerken, rechtstreeks vanuit je Whop-account. Advertentie-uitgaven worden over alle campagnes gefactureerd aan de geconfigureerde kaart of het saldo van het account. Whop regelt het advertentieaccount, de beoordeling, de lancering en de facturering. Twee API-aanroepen brengen je van niets naar een live advertentie: genereer een creative en maak vervolgens de campagne, advertentiegroep en advertentie aan in één verzoek.

Resources

Facturering en betalingsherstel

Uitgaven worden op accountniveau over alle campagnes geïnd. Een mislukte betaling blokkeert de levering met delivery_status: "payment_failed", terwijl de geconfigureerde active/paused status van elke campagne behouden blijft. Herstel de betaalmethode van het account en roep vervolgens Retry Failed Ads Payments één keer aan voor het account. Het antwoord plaatst een poging op de achtergrond in de wachtrij; het bevestigt de betaling niet. Na verrekening kunnen actieve campagnes hervatten en blijven gepauzeerde campagnes gepauzeerd, afhankelijk van andere leveringsvereisten. Zie Betalen voor advertenties voor de flow in het dashboard, een voorbeeldverzoek, het gedrag bij dubbele verzoeken en de afhandeling van legacy-campagnes.

Eenmalige installatie

  • Scopes: media:generate, media:read, ad_campaign:create, ad_campaign:update, ad_campaign:basic:read.
  • Betaalmethode voor advertenties: gekoppeld in het dashboard (saldo of kaart). Alleen het lanceren vereist deze — concepten werken zonder.
1

Genereer een creative

Gefactureerd vanuit je saldo (amount_charged; onvoldoende saldo → 402 met een deposit_url). Poll GET /media/{id} totdat status ready is en gebruik vervolgens file.id:
failed betaalt de kosten terug — pas de prompt aan en probeer het opnieuw. Video: "type": "video" plus optioneel duration_seconds (5/10/15), resolution (480p–4k) en maximaal 4 reference_media-bestands-ID’s (de eerste vormt de basis voor het openingsframe).
2

Maak de advertentie aan en lanceer deze — één verzoek

POST /ads met een inline ad_group en ad_campaign maakt de hele boomstructuur aan in één transactie en lanceert deze:
Nog niet klaar om uit te geven? Voeg "status": "draft" toe aan ad_campaign en lanceer later met PATCH /ad_campaigns/{id} {"status": "active"}.Om bestaande containers te hergebruiken, geef je ad_group_id door in plaats van ad_group, of ad_campaign_id in plaats van ad_campaign.
3

Monitoren

Poll GET /ads/{id}: delivery_status is de live status (een korte in_review voor contentmoderatie is normaal), en issues[] bevat een leesbaar message voor alles wat het advertentienetwerk asynchroon heeft afgewezen.Beheer de levering met pause / unpause op advertenties, advertentiegroepen of campagnes. Bewerk tekst of creatives met PATCH /ads/{id} — het meesturen van creatives vervangt de hele set, dus neem het basisitem op.

Fouten

Elke controle is een 400 waarvan het bericht aangeeft wat je moet oplossen: