Skip to main content
Deze pagina documenteert @whop/elements@1.10.0 en @whop/elements-react@1.10.0.
Sinds v1.0.0.

Playground

Stel de elementen samen met voorbeeldgegevens. Bedien de besturingselementen, voeg elementen toe en rangschik ze, en zie events live binnenkomen:

Opties

Geef deze door aan whop.tracking.create({ … }), of als props op <Tracking> in React.
string
Account-ID, met prefix biz_, waarvan dit de personen en events leest. Verplicht. Standaard "".
string
Een token met scopes waarmee beide oppervlakken lezen. Maak op je server één token aan voor de hele handle met POST /api/v1/access_tokens en stel met update({ accessToken }) een nieuw token in voordat het verloopt. Het lezen van de lijsten vereist member:basic:read of company:basic:read; de optieaantallen in de filtermenu’s gebruiken daarnaast stats:read, en het filter voor opgeslagen doelgroepen van de People-tabel gebruikt audience:basic:read — zonder die scopes tonen de menu’s gewoon minder opties. Zonder token gebruiken de aanroepen de eigen sessie van de kijker, die alleen same-origin werkt.
Waar persoonslinks op je site naartoe leiden. person is een sjabloon voor een absolute URL met twee placeholders, die per rij URL-gecodeerd worden vervangen: {personId} is de stabiele prsn_…-ID, identiek voor dezelfde persoon op elk oppervlak, dus baseer je pagina daarop en mount daar het person-element; {identifier} is de meest betekenisvolle identifier voor mensen die het oppervlak heeft (een gebruikers-ID of e-mailadres indien bekend), dus die kan per oppervlak verschillen. De URL moet absoluut zijn (https://…); een relatieve URL zou worden opgelost ten opzichte van het frame van het element en wordt daarom als niet ingesteld behandeld. Zonder instelling activeert een klik op een persoon in plaats daarvan personOpened op het element, het signaal om person over je pagina te tonen. Basis-URL’s voor people en events worden geaccepteerd voor symmetrie met de ads-handle, maar niets onder deze handle geeft ze weer. Standaard {}.
string
Het venster dat beide oppervlakken beslaan: today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time of custom (combineer dit met customRange). De elementen bevatten de kiezer en passen dit aan; lees het terug 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 venster, als ISO 8601-tijdstippen, gebruikt wanneer period custom is. Wordt anders genegeerd. Standaard null.
"account" | "local"
In welke van twee zones het venster wordt bepaald: account, de eigen planningszone van het account, of local, de zone waarin de browser van de kijker zich bevindt. account valt terug op de eigen zone van de kijker wanneer het account er geen heeft ingesteld. Standaard "account".
"last_touch" | "first_touch"
Welk contactmoment in het traject van een persoon de toeschrijving krijgt bij filteren op bron: last_touch, de standaard, of first_touch. De elementen bevatten de kiezer en passen dit aan, zodat een host het kan aansturen en terug kan lezen via attributionModelChanged. Standaard "last_touch".
Appearance
Visuele aanpassing voor de elementen van deze groep. Overschrijft de globale WhopElements({ appearance }). Wijzig het live met update({ appearance }).
WhopElementsLocale
Locale voor de UI-tekst van de elementen in deze groep. Stel deze in op een van de ingebouwde locales van de app om de globale configuratie te overschrijven. Elke andere waarde valt terug op de standaardlocale.

Events

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

onLoadingChange

Wordt uitgevoerd wanneer de gegroepeerde laadstatus verandert. De waarde is true zolang een van de gemounte elementen nog laadt.
boolean

Methoden

Roep deze aan op de Tracking-handle uit whop.tracking.create({ … }) of useTracking().

update

Voegt nieuwe handle-opties samen in elk gemount element. Wijzig in React in plaats daarvan de props van de namespace. Parameters
Partial<TrackingOptions>
vereist

destroy

Vernietigt elk element en elke sub-controller die deze handle heeft aangemaakt, verwijdert het controllerframe en geeft de abonnementen ervan vrij. Je kunt dit meer dan eens aanroepen, maar een vernietigde handle weigert elke andere aanroep — maak een nieuwe handle aan om opnieuw te beginnen. React verwijdert de groep automatisch wanneer de provider wordt unmount.

Elementen

De elementen die deze groep mount. Elk element heeft een eigen pagina:

PeopleElement

Iedereen die het account heeft gezien — bezoekers en klanten die uit pixelactiviteit zijn herleid, met hun bron, uitgaven en activiteitstellers. Zoek, filter op bron, event, geografie of apparaat, sorteer elke kolom en blader door de pagina’s. Een klik op een rij volgt links.person wanneer de handle dat configureert, en komt anders bij jou terug als personOpened.

EventsElement

Elk event dat het account heeft gemeten — paginaweergaven, leads, aankopen en aangepaste pixel-events — als een ruwe, filterbare stroom. De rijen achter elke metric: filter op event, bron, geografie of apparaat binnen het venster van de handle, of zoek op de identifier van één persoon om diens hele traject te lezen. Een persoonscel volgt links.person wanneer de handle dat configureert, en komt anders bij jou terug als personOpened.

PersonElement

Alles wat het account over één persoon weet: wie die persoon is, waar die vandaan kwam, wat die heeft uitgegeven en elk event dat die heeft uitgevoerd, op volgorde. De weergave waar een klik op een persoon naartoe leidt: mount deze op de pagina waarnaar links.person verwijst, of toon deze over je eigen pagina wanneer people of events personOpened activeren. identifier accepteert elke identifier waaronder een persoon is gezien, zodat een personOpened-payload hier ongewijzigd wordt opgelost.