Skip to main content
Deze pagina documenteert @whop/elements@1.10.0 en @whop/elements-react@1.10.0.
Sinds v1.0.0. Wordt gemount binnen Ads. Maak het aan om een handle te krijgen en mount daarna de elementen ervan op die handle. Roep destroy() aan om de sub-controller te verwijderen. Maak het opnieuw aan om een nieuwe handle te krijgen.

Voorbeeld

Een live, interactieve demo van de standaardindeling van deze sub-controller met voorbeeldgegevens:

Opties

Geef deze door aan ads.create('reporting', { … }), of als props op <Reporting> in React. Props die door de parent worden geïnjecteerd, staan hier nooit.
string
Het tijdvenster waarover elk oppervlak rapporteert: today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time of custom (combineer dat met customRange). De grafiek bevat de kiezer en die wijzigt deze waarde — zo kan een host het tijdvenster aansturen en het teruglezen via periodChanged. Standaard: "last_14_days".Een van "today", "yesterday", "last_7_days", "last_14_days", "last_30_days", "last_90_days", "all_time" of "custom".
object | null
Het expliciete tijdvenster, als ISO 8601-tijdstippen, gebruikt wanneer period custom is. Wordt anders genegeerd. Standaard: null.
"account" | "local"
Tijdzonekeuze voor elk gerapporteerd cijfer. Gebruik account voor de preferences.ads_scheduling_timezone van het account of local voor de browsertijdzone van de kijker. Dit zijn de enige keuzes die de grafiek biedt. Een vrij ingevulde IANA-tijdzone zou de kiezer gegevens verkeerd kunnen laten labelen en zou verloren gaan wanneer de kijker de selectie wijzigt. Wil je in een andere tijdzone rapporteren, wijzig dan de accountinstelling. account valt terug op de tijdzone van de kijker als het account geen instelling heeft. Standaard: "account".
string
ISO 4217-valutacode van drie kleine letters voor omgerekende bedragen, zoals usd of eur. Als deze niet is ingesteld, wordt de preferences.ads_reporting_currency van het account gebruikt. Standaard: "".
"last_touch" | "first_touch"
Welk contactmoment in de klantreis van een koper de toeschrijving krijgt: last_touch, de standaard, of first_touch. Bij beide wint een Whop-contactmoment ergens in de klantreis de Whop-categorie — het model kiest alleen de eindpunten. De tabel bevat de kiezer en wijzigt deze waarde, zodat een host die kan aansturen en teruglezen via attributionModelChanged. Standaard: "last_touch".
string[]
Beperk de rapportage tot deze advertentiecampagnes (adcamp_…). Leeg rapporteert over het hele account. Wordt overschreven door adGroupIds of adIds als een van beide is ingesteld. Geef één ID door voor een exact cijfer: de rapportage-API filtert op één bronpad, dus als er meer dan één is opgegeven, rapporteert de grafiek alleen over de eerste. Standaard: [].
string[]
Beperk de rapportage tot deze advertentiegroepen (adgrp_…). Heeft voorrang op campaignIds. Hetzelfde voorbehoud over één ID geldt. Standaard: [].
string[]
Beperk de rapportage tot deze advertenties (ad_…). Het smalste filter — heeft voorrang op beide andere. Hetzelfde voorbehoud over één ID geldt. Standaard: [].
"ads" | "all" | "businesses" | "campaigns" | "ad-groups"
Op welke tabel het element table opent: campaigns, ad-groups, ads of all voor de weergave per verkeersbron. all rapporteert altijd accountbreed — de bronreeks bestaat alleen op dat niveau — dus een filter dat ernaast is ingesteld, beperkt de tabel maar niet de grafiek. Standaard: "campaigns".
string[] | null
Over welk verkeer de grafiek rapporteert, als bronpaden — whop:* voor advertenties die via Whop zijn ingekocht, ext:* en ext:<platform>:* voor advertenties die elders draaien, referrer:* voor organisch, direct, other. null, de standaard, rapporteert alleen over Whop-advertenties; [] rapporteert over elke bron; een niet-lege array rapporteert over die bronnen. Dit is een ANDERE as dan campaignIds en verwante opties, die binnen Whop-advertenties filteren — ratio’s die van uitgaven zijn afgeleid, blijven aan Whop toegeschreven, ongeacht deze instelling, omdat uitgaven alleen Whop-advertenties hebben ingekocht. Het tabblad All van het element table wijzigt deze waarde. Standaard: null.

Events

Geef callbacks door in de create-opties of als React-props.

onEditRequested

De kijker wilde iets bewerken — via een rijmenu, een conceptrij of Edit ad in de detailoverlay. campaignId is altijd aanwezig; adGroupId en adId beperken het tot waarop is geklikt. Wordt alleen geactiveerd wanneer useCampaignCreator uit staat; staat het aan, dan opent in plaats daarvan de builder boven de pagina en blijft dit event stil.
AdsEditTarget

Methoden

Roep deze aan op de sub-handle uit ads.create('reporting', { … }).

update

Voegt nieuwe props en callbacks samen in de sub-controller. Parameters
Partial<ReportingSubOptions>
vereist

destroy

Vernietigt de sub-controller en de elementen ervan, en geeft daarna het exclusieve slot vrij. Een latere create("reporting") begint opnieuw.

Elementen

De elementen die deze sub-controller mount. Elk element heeft een eigen pagina:

ChartElement

De prestaties van een account over een tijdvenster, met een kiezer voor wat er wordt geplot — uitgaven, impressies, klikken of elke conversie die het account registreert. Alleen-lezen.

TableElement

De campagnes, advertentiegroepen en advertenties van een advertentieaccount in één tabel, met tabbladen om ertussen te wisselen: kies rijen om het onderliggende niveau te filteren, zoek, sorteer, splits de cijfers uit, kies je kolommen, en pauzeer, hervat, dupliceer of verwijder direct vanuit een rij. Het tijdvenster waarover gerapporteerd wordt en de rijen waarop gefilterd is, staan op de handle, zodat een grafiek die ernaast is gemount over precies hetzelfde rapporteert.