Deze pagina documenteert
@whop/elements@1.10.0 en @whop/elements-react@1.10.0.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 aanads.create('reporting', { … }), of als props op <Reporting> in React. Props die door de parent worden geïnjecteerd, staan hier nooit.
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".Het expliciete tijdvenster, als ISO 8601-tijdstippen, gebruikt wanneer
period custom is. Wordt anders genegeerd. Standaard: null.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".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: "".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".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: [].Beperk de rapportage tot deze advertentiegroepen (
adgrp_…). Heeft voorrang op campaignIds. Hetzelfde voorbehoud over één ID geldt. Standaard: [].Beperk de rapportage tot deze advertenties (
ad_…). Het smalste filter — heeft voorrang op beide andere. Hetzelfde voorbehoud over één ID geldt. Standaard: [].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".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.
Methoden
Roep deze aan op de sub-handle uitads.create('reporting', { … }).
update
Voegt nieuwe props en callbacks samen in de sub-controller.
Parameters
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.

