Wat je kunt bouwen
- Campagnes uitvoeren met een doelstelling, een budget en een planning.
- Een doelgroep targeten op locatie, demografie, interesses, apparaten en talen, of upload een klantenlijst als doelgroep.
- Creatives genereren als AI-afbeeldingen of -video op basis van een prompt, je eigen assets aanleveren, of een post promoten die al bestaat op een gekoppeld extern account.
- Toegeschreven prestaties uitlezen: uitgaven, resultaten, kosten per resultaat en rendement op advertentie-uitgaven, allemaal op het campagneobject zelf.
Landen die je niet kunt targeten
Whop staat niet toe dat campagnes deze landen targeten:
Verzoeken om een advertentiegroep aan te maken of de getargete landen ervan bij te werken, worden geweigerd als ze een van deze codes bevatten. Verwijder ze uit je getargete locaties voordat je het verzoek indient.
Voordat je geld uitgeeft
Twee dingen zijn vereist voor een live advertentie, en beide stel je eenmalig in:- Een betaalmethode die in het dashboard is gekoppeld, ofwel je Whop-saldo of een kaart. Concepten werken ook zonder.
- De Whop-pixel op je bestemming, tenzij je verkeer naar een whop.com-winkelpagina stuurt. Elke externe landingspagina heeft eerst de pixel nodig.
Kernobjecten
Advertentiecampagne, advertentiegroep, advertentie, doelgroep. Elk ervan wordt gedefinieerd in Kernconcepten. Advertising heeft één hiërarchie, en elk object hoort bij het niveau erboven.Bevat de doelstelling en de budgetstrategie. Zie Ad Campaigns.
Bevat de targeting, het optimalisatiedoel, de planning en standaard een eigen budget. Zie Ad Groups.
Bevat de creatives, de tekstvarianten, de call-to-action en de bestemmings-URL. Zie Ads.
POST /ads accepteert een inline ad_group, die op zijn beurt een inline ad_campaign accepteert, zodat één verzoek de hele boom in één transactie aanmaakt. Geef in plaats daarvan ad_group_id mee om de advertentie aan een bestaande advertentiegroep te koppelen.
Wil je later lanceren in plaats van nu, stel dan status in op draft op de inline ad_campaign en activeer de campagne daarna met PATCH /ad_campaigns/{id}.
Het budget staat op precies één niveau, nooit op beide: standaard op de advertentiegroep, of op de campagne wanneer je budget_optimization instelt op ad_campaign.
Hoe resultaten worden geteld
Elk prestatiecijfer dat Whop rapporteert, wordt toegeschreven door de Whop-pixel, niet door het advertentienetwerk.result_event geeft het conversie-event aan waarop een campagne wordt beoordeeld, en results is het door de pixel toegeschreven aantal daarvan. cost_per_result deelt de uitgaven door dat aantal. Wanneer de advertentiegroepen van een campagne op verschillende doelen optimaliseren, is er geen enkel result_event, dus is het null en wordt results de som van de eigen toegeschreven resultaten van elke advertentiegroep. Wanneer er niet wordt geoptimaliseerd op iets wat Whop kan toeschrijven, zijn beide null in plaats van nul.
Gewenste kosten per resultaat
Dedesired_cost_per_result van een campagne is de kosten per resultaat, in USD, die je wilt bereiken. Het is alleen een streefwaarde: het is geen kostenplafond of biedplafond en het verandert niets aan hoe de advertenties van de campagne bieden. Affiliates die de campagne uitvoeren, zien het als de kosten per resultaat waarop ze moeten mikken. De eigen desired_cost_per_result van een advertentiegroep is een andere instelling: dat is het kostenplafond of biedplafond ervan. Stel de desired_cost_per_result van de campagne in op null om de streefwaarde te wissen.
Betalen voor advertenties
Uitgaven lopen op naarmate advertenties worden weergegeven en worden achteraf in rekening gebracht. Facturering hoort bij het account, over alle campagnes heen. Elke incasso combineert in aanmerking komende onbetaalde campagne-uitgaven tot één betaling met de geconfigureerde betaalmethoden voor advertenties van het account. Je configureert geen aparte betaalmethode en vraagt geen aparte nieuwe poging aan per campagne. Het veldspend op een campagne is het bedrag dat bij je in rekening wordt gebracht, in spend_currency.
Het moment van incasso hangt af van de opgebouwde uitgaven en factureringsdrempels. Consolidatie betekent niet één betaling per dag. Het genereren van AI-creatives gebruikt een eigen betaling vanuit het saldo. Bij te weinig saldo wordt een 402 geretourneerd met een deposit_url.
Wanneer een betaling mislukt
Een mislukte betaling op accountniveau blokkeert de weergave voor alle factureerbare campagnes. Elke getroffen campagne rapporteertdelivery_status: "payment_failed", terwijl de geconfigureerde status active of paused blijft. Lees delivery_status om te bepalen of een campagne kan worden weergegeven, en issues voor de reden van de mislukking.
Het account kan geen campagnes activeren zolang er onopgeloste mislukte betalingen zijn. Je kunt een campagne nog wel pauzeren zodat deze uit blijft na herstel van de betaling. Whop plant ook automatische nieuwe pogingen. Je kunt een nieuwe poging aanvragen nadat je de betaalmethode hebt hersteld.
Een betaling opnieuw proberen
- Selecteer in het Ads-dashboard van je account Update payment method in de banner over de mislukte betaling, of open de Ads-instellingen en selecteer Billing. Werk de kaart van het account bij of vul het saldo aan dat het gebruikt.
- Selecteer één keer Retry payment voor het account. API-integraties moeten Retry Failed Ads Payments aanroepen met de
biz_-ID van het account en de machtigingad_campaign:update. - Wacht op de poging op de achtergrond. Een
202-respons metqueued: truebevestigt dat de taak is geaccepteerd, niet dat de betaling is geslaagd. Lees de advertentiecampagnes van het account voor de uitkomst. - Na een geslaagde afrekening wordt de betalingsblokkade opgeheven. De weergave kan
processingtonen terwijl deze opnieuw wordt berekend en gesynchroniseerd. Campagnes die als actief zijn geconfigureerd, kunnen worden hervat als aan hun andere weergavevereisten is voldaan. Campagnes die als gepauzeerd zijn geconfigureerd, blijven gepauzeerd.
2026-09-22 nog steeds een nieuwe poging voor het account in de wachtrij. Vanaf 2026-09-22 retourneert het 410 Gone. Gebruik het account-endpoint hierboven.
Oudere campagnes waarvan de geconfigureerde status al payment_failed was, keren na een geslaagde nieuwe poging terug naar paused, omdat hun vorige actief/gepauzeerd-instelling niet is bewaard.
Waarom een campagne niet wordt weergegeven
delivery_status geeft hier direct antwoord op. Het is het eerste veld om te lezen wanneer een campagne bestaat maar er niets gebeurt. Meerdere statussen kunnen tegelijk waar zijn, dus de waarde is de hoogste op deze ladder:
Advertenties en advertentiegroepen hebben hun eigen
delivery_status met andere waarden. Een nieuwe advertentie doorloopt in_review voordat deze wordt weergegeven.
Volgende stappen
Een advertentie maken en lanceren
De volledige flow, van creative tot live advertentie, in twee aanroepen.
De pixel installeren
Vereist voordat resultaten kunnen worden toegeschreven.
Een doelgroep opbouwen
Upload een klantenlijst om te targeten of uit te sluiten.
Ads-referentie
Elk advertentie-endpoint, met een playground.

