Skip to main content
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.
  • 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: 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.
Oversigten over Ads API’et 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. Annoncering har ét hierarki, og hvert objekt hører til niveauet over det.
adcamp_
Indeholder målet og budgetstrategien. Se Annoncekampagner.
adgrp_
Indeholder målretning, optimeringsmålet, tidsplanen og som standard sit eget budget. Se Annoncegrupper.
ad_
Indeholder kreativerne, tekstvarianterne, call to action og destinations-URL’en. Se Annoncer.
POST /ads 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}. 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 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 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.
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 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: 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

Opret og lancér en annonce

Hele forløbet, fra kreativ til live-annonce, i to kald.

Installér pixlen

Påkrævet, før resultater kan attribueres.

Byg et publikum

Upload en kundeliste, der skal målrettes eller udelukkes.

Ads-reference

Alle annoncerings-endpoints med en playground.