Skip to main content
Een Ad is de afzonderlijke creatieve eenheid die door een advertentiegroep wordt geleverd. Deze bevat de tekst, creatieve assets en bestemmings-URL voor één advertentie. Gebruik de Ads API om de advertenties van een account op te vragen, advertenties binnen advertentiegroepen aan te maken, creatieve details op te halen of bij te werken, advertenties te verwijderen die moeten stoppen en de levering te pauzeren of te hervatten.

Endpoints

Attributen

string
vereist
Unieke identificatie van de advertentie, met prefix ad_.
object
vereist
De advertentiecampagne waartoe deze advertentie behoort.

Eigenschappen

string
vereist
De id van de entiteit waarnaar wordt verwezen.
object
vereist
De advertentiegroep waartoe deze advertentie behoort.

Eigenschappen

string
vereist
De id van de entiteit waarnaar wordt verwezen.
number
vereist
USD-waarde toegeschreven aan add-to-cart-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.
number
vereist
Door de Whop-pixel toegeschreven add-to-cart-events, last-click.
string | null
vereist
De call-to-action-knop die op de advertentie wordt getoond.Beschikbare opties: learn_more, shop_now, sign_up, subscribe, get_started, book_now, apply_now, contact_us, download, order_now, buy_now, get_quote, message_page, whatsapp_message, instagram_message, call_now, get_directions, send_updates, get_offer, watch_more, listen_now, play_game, open_link, no_button, get_offer_view, get_event_tickets, see_menu, request_time, event_rsvp, see_details, view_instagram_profile, donate_now, see_more, visit_site
number
vereist
Klikken gedeeld door vertoningen, tussen 0 en 1.
number
vereist
Het aantal klikken.
number
vereist
USD-waarde toegeschreven aan complete-registration-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.
number
vereist
Door de Whop-pixel toegeschreven complete-registration-events, last-click.
number
vereist
USD-waarde toegeschreven aan contact-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.
number
vereist
Door de Whop-pixel toegeschreven contact-events, last-click.
object
vereist
De contentbeoordeling van deze advertentie door Whop: of deze is afgerond, voor welke advertentienetwerken de advertentie wordt aanbevolen en welke contentregels worden overtreden.

Eigenschappen

object[]
vereist
Of elk netwerk de advertentie kan weergeven. Leeg totdat de beoordeling is afgerond.

Eigenschappen

Of de advertentie voldoet aan het contentbeleid van Whop en van dit netwerk.
string
vereist
Het netwerk. whop is het eigen contentbeleid van Whop, dat ook door elk ander netwerk wordt vereist.Beschikbare opties: whop, meta, tiktok, google
string
vereist
reviewed zodra de contentbeoordeling van Whop is afgerond, in_review terwijl deze loopt, not_reviewed wanneer deze nooit is uitgevoerd.Beschikbare opties: reviewed, in_review, not_reviewed
object[]
vereist
Elke regel die de advertentie volgens de beoordeling overtreedt, op welk netwerk dan ook. Leeg wanneer er geen regels worden overtreden of de beoordeling nog niet is afgerond.

Eigenschappen

string
vereist
Het bewijs dat de beoordeling voor deze regel heeft vastgelegd.
string
vereist
De regel die de advertentie volgens de contentbeoordeling van Whop overtreedt.
number | null
vereist
Uitgaven gedeeld door toegeschreven add-to-cart-events; null wanneer deze niet het doel zijn en er geen zijn toegeschreven.
number
vereist
Uitgaven gedeeld door klikken; 0 wanneer er geen klikken zijn.
number | null
vereist
Uitgaven gedeeld door toegeschreven complete-registration-events; null wanneer deze niet het doel zijn en er geen zijn toegeschreven.
number | null
vereist
Uitgaven gedeeld door toegeschreven contact-events; null wanneer contacten niet het doel zijn en er geen zijn toegeschreven.
number | null
vereist
Uitgaven gedeeld door toegeschreven leads; null wanneer leads geen doel zijn en er geen zijn toegeschreven.
number
vereist
Uitgaven per 1.000 vertoningen; 0 wanneer er geen vertoningen zijn.
number | null
vereist
Uitgaven gedeeld door toegeschreven aankopen; null wanneer aankopen geen doel zijn en er geen zijn toegeschreven.
number | null
vereist
Uitgaven gedeeld door door de Whop-pixel toegeschreven resultaten; null wanneer er niets wordt geoptimaliseerd dat aan Whop kan worden toegeschreven.
number | null
vereist
Uitgaven gedeeld door toegeschreven schedule-events; null wanneer afspraken niet het doel zijn en er geen zijn toegeschreven.
number | null
vereist
Uitgaven gedeeld door toegeschreven submit-application-events; null wanneer deze niet het doel zijn en er geen zijn toegeschreven.
number | null
vereist
Uitgaven gedeeld door unieke klikken; null wanneer er geen unieke klikken zijn.
number | null
vereist
Uitgaven gedeeld door toegeschreven view-content-events; null wanneer deze niet het doel zijn en er geen zijn toegeschreven.
string
vereist
Wanneer de advertentie is aangemaakt, als ISO 8601-tijdstempel.
object[]
vereist
De creatieve assets die door deze advertentie worden gebruikt. Het originele asset heeft een null-format; square-, vertical- en horizontal-items zijn plaatsingsspecifieke varianten. Een carrouseladvertentie retourneert één item met null-format per bijlage, op volgorde.

Eigenschappen

string
vereist
De bestands-id van de creatieve bijlage.
object | null
vereist
Het opgeslagen uitsnedevenster voor deze creative, in pixels van de bronafbeelding. Null voor het originele asset of een format dat niet is bijgesneden.

Eigenschappen

number
vereist
Hoogte van het uitsnedevenster in bronpixels.
number
vereist
Breedte van het uitsnedevenster in bronpixels.
number
vereist
Linkerrand van het uitsnedevenster in bronpixels.
number
vereist
Bovenrand van het uitsnedevenster in bronpixels.
string | null
vereist
De plaatsingsvariant die dit asset dekt, of null voor het originele asset.Beschikbare opties: square, vertical, horizontal
string | null
vereist
Altijd null. Vertalingen zijn niet langer beschikbaar.
string | null
vereist
Het soort asset, afbeelding of video.
string | null
vereist
CDN-url van het asset.
number
vereist
Door de Whop-pixel toegeschreven aangepaste (door de merchant gedefinieerde) conversie-events, last-click, over alle aangepaste eventnamen.
object
vereist
Door de Whop-pixel toegeschreven aangepaste conversies, met je eventnaam als sleutel en het last-click-aantal als waarde. Leeg wanneer er geen benoemde aangepaste events zijn toegeschreven. Aangepaste events die zonder naam zijn verstuurd, worden geteld in custom_conversions maar hier weggelaten, dus deze waarden tellen op tot maximaal custom_conversions.
object
vereist
Conversiewaarde toegeschreven aan elk aangepast event, met de eventnaam als sleutel, zoals bij custom_event_counts. Telt de waarde op die aan whop.track is doorgegeven, genormaliseerd naar USD; events die zonder waarde zijn verstuurd, dragen 0 bij.
string
vereist
Of de advertentie op dit moment wordt geleverd, en zo niet, waarom. Wanneer meerdere statussen tegelijk van toepassing zijn, wordt de status met de hoogste prioriteit geretourneerd.Beschikbare opties: rejected, in_review, draft, campaign_paused, paused, processing, revise_content, issues, scheduled, learning, active
object[]
vereist
De beschrijving die op de advertentie wordt getoond.

Eigenschappen

string | null
vereist
Altijd null. Vertalingen zijn niet langer beschikbaar.
string
vereist
De tekst die aan kijkers wordt getoond.
number | null
vereist
Vertoningen gedeeld door bereik.
object[]
vereist
De kop die op de advertentie wordt getoond.

Eigenschappen

string | null
vereist
Altijd null. Vertalingen zijn niet langer beschikbaar.
string
vereist
De tekst die aan kijkers wordt getoond.
number
vereist
Het aantal vertoningen.
object[]
vereist
Openstaande problemen die deze advertentie beïnvloeden. Leeg wanneer er geen zijn.

Eigenschappen

string
vereist
Unieke identificatie van het probleem.
string
vereist
Het soort probleem: informatie over levering, een waarschuwing of een fout die aandacht vereist.Beschikbare opties: information, warning, error
string
vereist
Een beschrijving van wat het probleem is en hoe het kan worden opgelost.
string | null
vereist
De ID van de campagne, advertentiegroep of advertentie waaraan het probleem is gekoppeld.
string
vereist
Het type resource waaraan het probleem is gekoppeld.Beschikbare opties: ad_campaign, ad_group, ad
string
vereist
Een korte titel voor het probleem, bedoeld voor de creator: de regel die bij een afwijzing door de contentbeoordeling wordt genoemd, of een algemeen label.
number
vereist
USD-waarde toegeschreven aan lead-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.
number
vereist
Door de Whop-pixel toegeschreven leads, last-click.
Paginaweergaven op je bestemming door mensen die op de advertentie hebben geklikt, geregistreerd door de Whop-pixel. Op elk advertentieplatform op dezelfde manier geteld.
object[]
vereist
De primaire tekst die in de hoofdtekst van de advertentie wordt getoond. Meerdere items vormen tekstvariaties.

Eigenschappen

string | null
vereist
Altijd null. Vertalingen zijn niet langer beschikbaar.
string
vereist
De tekst die aan kijkers wordt getoond.
number
vereist
USD-waarde van door de pixel toegeschreven aankopen.
number
vereist
Door de Whop-pixel toegeschreven aankopen, last-click.
number
vereist
Het aantal unieke personen dat dit heeft gezien.
string | null
vereist
Het Whop-pixel-conversie-event waarvan het toegeschreven aantal de resultaten vertegenwoordigt — het optimalisatiedoel, of het event met het hoogste toegeschreven volume voor campagnes die per advertentiegroep budgetteren. Null wanneer het doel geen door Whop toegeschreven event is.Beschikbare opties: purchase, lead, schedule, submit_application, contact, complete_registration, view_content, add_to_cart, custom, messaging_conversation
string | null
vereist
De door de merchant gedefinieerde eventnaam wanneer result_event custom is; null voor de standaard-events.
number | null
vereist
Het door de Whop-pixel toegeschreven aantal achter result_event. Wanneer de advertentiegroepen van een campagne op verschillende doelen optimaliseren, is er geen enkele result_event (die is dan null), en is dit in plaats daarvan de som van de eigen toegeschreven resultaten van elke advertentiegroep. Null wanneer er niets wordt geoptimaliseerd dat aan Whop kan worden toegeschreven.
number
vereist
Aankoopwaarde gedeeld door uitgaven, beide in USD (een valuta-neutrale verhouding); 0 wanneer er geen uitgaven zijn.
number
vereist
USD-waarde toegeschreven aan schedule-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.
number
vereist
Door de Whop-pixel toegeschreven schedule-events, last-click.
number
vereist
Het in rekening gebrachte bedrag, in spend_currency.
string | null
vereist
De ISO 4217-valutacode van alle monetaire statistieken.
string
vereist
Of de advertentie is ingeschakeld. active en paused stel je zelf in; in_review en rejected komen voort uit de advertentiebeoordeling.Beschikbare opties: active, paused, in_review, rejected
number
vereist
USD-waarde toegeschreven aan submit-application-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.
number
vereist
Door de Whop-pixel toegeschreven submit-application-events, last-click.
string | null
vereist
Weergavetitel van de advertentie.
number | null
vereist
Unieke klikken gedeeld door vertoningen, tussen 0 en 1.
number
vereist
Personen die hebben geklikt, gerapporteerd door de Whop-pixel, één keer per persoon geteld.
string
vereist
Wanneer de advertentie voor het laatst is bijgewerkt, als ISO 8601-tijdstempel.
string | null
vereist
De URL waarnaar de advertentie linkt, zonder querystring. Parameters horen in url_parameters; parameters die je op url meestuurt, worden daarheen verplaatst.
object
vereist
Queryparameters die aan url worden toegevoegd, met de naam als sleutel. De klikattributieparameters van Whop zijn gereserveerd.
number
vereist
USD-waarde toegeschreven aan view-content-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.
number
vereist
Door de Whop-pixel toegeschreven view-content-events, last-click.
Ad