Skip to main content
Denne side dokumenterer @whop/elements@1.10.0 og @whop/elements-react@1.10.0.
Siden v1.0.0. Monteres inde i Tracking. accountId og accessToken kommer derfra. Angiv props og callbacks via create-indstillingerne eller som React-props.

Eksempeldata. Åbn Playground.

Props

string
Afgræns til personer, der er hentet ind af en trafikkilde, angivet som en kildesti — whop:adcamp_…:* for en af kontoens kampagner, ext:* for annoncer kørt andre steder, referrer:*, direct. Den samme værdi, som annoncetabellens klikantal linker med, så en side kan hydrere denne direkte fra sin egen URL. Standard er "".
string
Afgræns til personer, der har udført en event, efter dens navn — payment.completed, pixel.lead, pixel.page. Standard er "".
string
Afgræns til personer, der har udført en brugerdefineret pixel-event, efter dens brugerdefinerede navn. Kombineres med en tom eventName. Standard er "".
string
Afgræns efter den utm_source, deres trafik bar. Adskil med kommaer for at matche en hvilken som helst af flere. Standard er "".
string
Afgræns efter ISO 3166-1 alpha-2-landekode, f.eks. US eller GB. Standard er "".
string
Afgræns efter enhedsklasse — desktop, mobile, tablet, bot. Standard er "".
string
Afgræns efter browsernavn. Standard er "".
string
Afgræns efter styresystemets navn. Standard er "".
string
true kun for kunder, false for personer, der aldrig har købt, tom for alle. Standard er "".
string
Hvad søgefeltet er filtreret på — et navn, en e-mail eller en identifikator. Standard er "".
string
Afgræns til en gemt målgruppe (adaud_…) bygget ud fra personfiltre. Målgruppefiltermenuen ændrer denne værdi. Standard er "".
string
Fastlås event-vinduet for source/eventName-filtre til et præcist ISO 8601-tidspunkt i stedet for handlets period. Sæt både eventFrom og eventTo eller ingen af dem. Standard er "".
string
Slutningen af det fastlåste event-vindue som et ISO 8601-tidspunkt. Standard er "".
string
Den sorterede kolonne: name, email, ltv, purchase_count, event_count, first_seen_at, last_seen_at. Standard er "last_seen_at".
"asc" | "desc"
Sorteringsretningen. Standard er "desc".

Events

Angiv callbacks i create-indstillingerne eller som React-props.

onPeriodChanged

Seeren flyttede tidsvinduet via periodevælgeren. Alle flader under det samme handle har allerede fulgt med; gem det, og send det tilbage som period/customRange på handlet, ellers nulstilles tidsvinduet ved næste montering.
object

onAttributionModelChanged

Seeren ændrede, hvilket berøringspunkt der får krediteringen, via filterrækkens Attribution-menu. Alle flader under det samme handle har allerede krediteret på ny; gem det, og send det tilbage som attributionModel på handlet, ellers vender det tilbage ved næste montering.
object

onFiltersChanged

Seeren ændrede et filter, søgefeltet eller målgruppevælgeren. Indeholder hele filtertilstanden, uanset hvad der blev ændret — spejl den i din egen URL, og send den tilbage som props for at gøre visningen reproducerbar.
PeopleFilterBag

onSortChanged

Seeren sorterede en kolonne. Gem og send tilbage som sort/dir, ellers nulstilles sorteringen ved næste montering.
object

onPersonOpened

Seeren klikkede på en personrække, og handlet har intet links.person at følge. Vis person-elementet med den, f.eks. createOverlay("person", { identifier: payload.personId }) (personId er den stabile nøgle pr. person; identifier er den mest menneskeligt meningsfulde, fladen har), eller angiv links.person på handlet for i stedet at gøre rækkerne til rigtige ankre.
object

onLoaderStart

Kører, efter at indlæsningsskelettet først er tegnet, og før onReady.

onReady

Kører efter elementets første fuldstændige rendering.

onError

Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug code til programmatisk håndtering. sourceKey identificerer en host-state-kilde, der fejlede.
object

Metoder

Kald disse på det handle, som create returnerer, eller via en React-ref.

mount

Monterer elementet i target og begynder indlæsningen. React-komponenter monterer sig selv. Parametre
string | HTMLElement
påkrævet

destroy

Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde den mere end én gang. React fjerner elementet automatisk.

update

Fletter nye props ind i det monterede element. I React ændrer du i stedet komponentens props. Parametre
Partial<PeopleElementProps>
påkrævet

Styling

Dette element eksponerer ikke klassenavne til styling. Brug appearance (tema, accentfarve, variabler) til at ændre udseendet.