Skip to main content
En Ad er den individuelle kreative enhed, der leveres af en annoncegruppe. Den indeholder teksten, de kreative assets og destinations-URL’en for én annonce. Brug Ads API’et til at vise annoncer for en konto, oprette annoncer i annoncegrupper, hente eller opdatere kreative detaljer, slette annoncer, der skal stoppe med at køre, og sætte levering på pause eller genoptage den.

Endpoints

Attributter

string
påkrævet
Unik identifikator for annoncen med præfikset ad_.
object
påkrævet
Den annoncekampagne, som denne annonce tilhører.

Egenskaber

string
påkrævet
Den refererede enheds id.
object
påkrævet
Den annoncegruppe, som denne annonce tilhører.

Egenskaber

string
påkrævet
Den refererede enheds id.
number
påkrævet
USD-værdi tilskrevet add-to-cart-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.
number
påkrævet
Whop-pixel-tilskrevne add-to-cart-hændelser, last-click.
string | null
påkrævet
Call-to-action-knappen, der vises på annoncen.Tilgængelige muligheder: 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
påkrævet
Klik divideret med visninger, mellem 0 og 1.
number
påkrævet
Antallet af klik.
number
påkrævet
USD-værdi tilskrevet complete-registration-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.
number
påkrævet
Whop-pixel-tilskrevne complete-registration-hændelser, last-click.
number
påkrævet
USD-værdi tilskrevet contact-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.
number
påkrævet
Whop-pixel-tilskrevne contact-hændelser, last-click.
object
påkrævet
Whops indholdsgennemgang af denne annonce: om den er afsluttet, hvilke annoncenetværk den anbefales til, og hvilke indholdsregler den overtræder.

Egenskaber

object[]
påkrævet
Om hvert netværk kan køre annoncen. Tom, indtil gennemgangen er afsluttet.

Egenskaber

Om annoncen overholder Whops indholdspolitik og dette netværks.
string
påkrævet
Netværket. whop er Whops egen indholdspolitik, som alle andre netværk også kræver.Tilgængelige muligheder: whop, meta, tiktok, google
string
påkrævet
reviewed, når Whops indholdsgennemgang er afsluttet, in_review, mens den kører, not_reviewed, når den aldrig blev kørt.Tilgængelige muligheder: reviewed, in_review, not_reviewed
object[]
påkrævet
Alle regler, som gennemgangen fandt, at annoncen overtræder, på ethvert netværk. Tom, når den ikke overtræder nogen, eller gennemgangen ikke er afsluttet.

Egenskaber

string
påkrævet
Den dokumentation, gennemgangen registrerede for denne regel.
string
påkrævet
Den regel, som Whops indholdsgennemgang fandt, at annoncen overtræder.
number | null
påkrævet
Forbrug divideret med tilskrevne add-to-cart-hændelser; null, når de ikke er målet, og ingen er tilskrevet.
number
påkrævet
Forbrug divideret med klik; 0, når der ikke er nogen klik.
number | null
påkrævet
Forbrug divideret med tilskrevne complete-registration-hændelser; null, når de ikke er målet, og ingen er tilskrevet.
number | null
påkrævet
Forbrug divideret med tilskrevne contact-hændelser; null, når kontakter ikke er målet, og ingen er tilskrevet.
number | null
påkrævet
Forbrug divideret med tilskrevne leads; null, når leads ikke er et mål, og ingen er tilskrevet.
number
påkrævet
Forbrug pr. 1.000 visninger; 0, når der ikke er nogen visninger.
number | null
påkrævet
Forbrug divideret med tilskrevne køb; null, når køb ikke er et mål, og ingen er tilskrevet.
number | null
påkrævet
Forbrug divideret med Whop-pixel-tilskrevne resultater; null, når der ikke optimeres efter noget, Whop kan tilskrive.
number | null
påkrævet
Forbrug divideret med tilskrevne schedule-hændelser; null, når bookinger ikke er målet, og ingen er tilskrevet.
number | null
påkrævet
Forbrug divideret med tilskrevne submit-application-hændelser; null, når de ikke er målet, og ingen er tilskrevet.
number | null
påkrævet
Forbrug divideret med unikke klik; null, når der ikke er nogen unikke klik.
number | null
påkrævet
Forbrug divideret med tilskrevne view-content-hændelser; null, når de ikke er målet, og ingen er tilskrevet.
string
påkrævet
Hvornår annoncen blev oprettet, som et ISO 8601-tidsstempel.
object[]
påkrævet
De kreative assets, som denne annonce bruger. Det originale asset har et null-format; square-, vertical- og horizontal-poster er placeringsspecifikke varianter. En karruselannonce returnerer én post med format null pr. vedhæftning i rækkefølge.

Egenskaber

string
påkrævet
Fil-id’et for den kreative vedhæftning.
object | null
påkrævet
Det gemte beskæringsvindue for denne kreative, i kildebilledets pixels. Null for det originale asset eller et format, der ikke er beskåret.

Egenskaber

number
påkrævet
Beskæringsvinduets højde i kildepixels.
number
påkrævet
Beskæringsvinduets bredde i kildepixels.
number
påkrævet
Beskæringsvinduets venstre kant i kildepixels.
number
påkrævet
Beskæringsvinduets øverste kant i kildepixels.
string | null
påkrævet
Den placeringsvariant, dette asset dækker, eller null for det originale asset.Tilgængelige muligheder: square, vertical, horizontal
string | null
påkrævet
Altid null. Oversættelser er ikke længere tilgængelige.
string | null
påkrævet
Typen af asset, billede eller video.
string | null
påkrævet
CDN-url for asset’et.
number
påkrævet
Whop-pixel-tilskrevne brugerdefinerede (forhandlerdefinerede) konverteringshændelser, last-click, på tværs af alle brugerdefinerede hændelsesnavne.
object
påkrævet
Whop-pixel-tilskrevne brugerdefinerede konverteringer med dit hændelsesnavn som nøgle og dets last-click-antal som værdi. Tom, når ingen navngivne brugerdefinerede hændelser er tilskrevet. Brugerdefinerede hændelser, der udløses uden et navn, tælles med i custom_conversions, men udelades her, så disse værdier summerer til højst custom_conversions.
object
påkrævet
Konverteringsværdi tilskrevet hver brugerdefineret hændelse med hændelsesnavnet som nøgle ligesom custom_event_counts. Summerer den værdi, der sendes til whop.track, normaliseret til USD; hændelser, der udløses uden en værdi, bidrager med 0.
string
påkrævet
Om annoncen leveres lige nu, og hvis ikke, hvorfor. Når flere tilstande gælder på én gang, returneres den med højest prioritet.Tilgængelige muligheder: rejected, in_review, draft, campaign_paused, paused, processing, revise_content, issues, scheduled, learning, active
object[]
påkrævet
Beskrivelsen, der vises på annoncen.

Egenskaber

string | null
påkrævet
Altid null. Oversættelser er ikke længere tilgængelige.
string
påkrævet
Teksten, der vises for seerne.
number | null
påkrævet
Visninger divideret med rækkevidde.
object[]
påkrævet
Overskriften, der vises på annoncen.

Egenskaber

string | null
påkrævet
Altid null. Oversættelser er ikke længere tilgængelige.
string
påkrævet
Teksten, der vises for seerne.
number
påkrævet
Antallet af visninger.
object[]
påkrævet
Åbne problemer, der påvirker denne annonce. Tom, når der ikke er nogen.

Egenskaber

string
påkrævet
Unik identifikator for problemet.
string
påkrævet
Problemets type: information om levering, en advarsel eller en fejl, der kræver opmærksomhed.Tilgængelige muligheder: information, warning, error
string
påkrævet
En beskrivelse af, hvad problemet er, og hvordan det kan løses.
string | null
påkrævet
ID’et for den kampagne, annoncegruppe eller annonce, som problemet er knyttet til.
string
påkrævet
Typen af den ressource, som problemet er knyttet til.Tilgængelige muligheder: ad_campaign, ad_group, ad
string
påkrævet
En kort titel til skaberen for problemet: den regel, en afvisning ved indholdsgennemgang nævner, eller en generisk etiket.
number
påkrævet
USD-værdi tilskrevet lead-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.
number
påkrævet
Whop-pixel-tilskrevne leads, last-click.
Sidevisninger på din destination fra personer, der klikkede på annoncen, registreret af Whop-pixelen. Tælles på samme måde på alle annonceplatforme.
object[]
påkrævet
Den primære tekst, der vises i annoncens brødtekst. Flere poster giver tekstvariationer.

Egenskaber

string | null
påkrævet
Altid null. Oversættelser er ikke længere tilgængelige.
string
påkrævet
Teksten, der vises for seerne.
number
påkrævet
USD-værdi af pixel-tilskrevne køb.
number
påkrævet
Whop-pixel-tilskrevne køb, last-click.
number
påkrævet
Antallet af unikke personer, der så dette.
string | null
påkrævet
Den Whop-pixel-konverteringshændelse, hvis tilskrevne antal repræsenterer resultater — optimeringsmålet eller den tilskrevne hændelse med størst volumen for kampagner, der budgetterer pr. annoncegruppe. Null, når målet ikke er en Whop-tilskrevet hændelse.Tilgængelige muligheder: purchase, lead, schedule, submit_application, contact, complete_registration, view_content, add_to_cart, custom, messaging_conversation
string | null
påkrævet
Det forhandlerdefinerede hændelsesnavn, når result_event er custom; null for standardhændelserne.
number | null
påkrævet
Det Whop-pixel-tilskrevne antal bag result_event. Når en kampagnes annoncegrupper optimerer efter forskellige mål, er der ingen enkelt result_event (den er null), og dette er i stedet summen af hver annoncegruppes egne tilskrevne resultater. Null, når der ikke optimeres efter noget, Whop kan tilskrive.
number
påkrævet
Købsværdi divideret med forbrug, begge i USD (et valutaneutralt forhold); 0, når der ikke er noget forbrug.
number
påkrævet
USD-værdi tilskrevet schedule-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.
number
påkrævet
Whop-pixel-tilskrevne schedule-hændelser, last-click.
number
påkrævet
Det opkrævede beløb i spend_currency.
string | null
påkrævet
ISO 4217-valutakoden for alle monetære målinger.
string
påkrævet
Om annoncen er aktiveret. active og paused angives af dig; in_review og rejected kommer fra annoncegennemgangen.Tilgængelige muligheder: active, paused, in_review, rejected
number
påkrævet
USD-værdi tilskrevet submit-application-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.
number
påkrævet
Whop-pixel-tilskrevne submit-application-hændelser, last-click.
string | null
påkrævet
Annoncens visningstitel.
number | null
påkrævet
Unikke klik divideret med visninger, mellem 0 og 1.
number
påkrævet
Personer, der klikkede, rapporteret af Whop-pixelen, talt én gang pr. person.
string
påkrævet
Hvornår annoncen sidst blev opdateret, som et ISO 8601-tidsstempel.
string | null
påkrævet
Den URL, annoncen linker til, uden dens forespørgselsstreng. Parametre hører hjemme i url_parameters; dem, du sender på url, flyttes derhen.
object
påkrævet
Forespørgselsparametre, der tilføjes til url, med navnet som nøgle. Whops parametre til klik-tilskrivning er reserverede.
number
påkrævet
USD-værdi tilskrevet view-content-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.
number
påkrævet
Whop-pixel-tilskrevne view-content-hændelser, last-click.
Ad