Denne side dokumenterer
@whop/elements@1.10.0 og @whop/elements-react@1.10.0.v1.0.0.
Playground
Sæt elementerne sammen med eksempeldata. Betjen kontrollerne, tilføj og arrangér elementer, og se events blive udløst live:Indstillinger
Angiv disse tilwhop.tracking.create({ … }) eller som props på <Tracking> i React.
Et afgrænset token, som begge flader læser med. Udsted ét token til hele handlet på din server med
POST /api/v1/access_tokens, og sæt et nyt med update({ accessToken }), før det udløber. Læsning af listerne kræver member:basic:read eller company:basic:read; filtermenuernes antal pr. valgmulighed bruger desuden stats:read, og People-tabellens filter for gemte målgrupper bruger audience:basic:read — uden dem viser menuerne blot færre valgmuligheder. Udeladt bærer kaldene seerens egen session, som kun besvares fra samme origin.Hvor personlinks fører hen på dit website.
person er en skabelon for en absolut URL med to pladsholdere, som hver erstattes URL-kodet pr. række: {personId} er det stabile prsn_…-ID, identisk for den samme person på alle flader, så byg din side op omkring det og montér person-elementet dér; {identifier} er den mest menneskeligt meningsfulde identifikator, fladen har (et bruger-ID eller en e-mail, hvor den kendes), så den kan variere mellem flader. Den skal være absolut (https://…); en relativ URL ville blive opløst i forhold til elementets frame, så en sådan behandles som ikke sat. Hvis den ikke er sat, udløser et klik på en person i stedet personOpened på sit element, hvilket er signalet til at vise person oven på din side. Basis-URL’er for people og events accepteres for symmetri med ads-handlet, men intet under dette handle renderer dem. Standard er {}.Det tidsvindue, begge flader dækker:
today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time eller custom (kombinér det med customRange). Elementerne indeholder vælgeren og ændrer denne værdi; aflæs den igen fra periodChanged. Standard er "last_14_days".Én af "today", "yesterday", "last_7_days", "last_14_days", "last_30_days", "last_90_days", "all_time" eller "custom".Det eksplicitte tidsvindue som ISO 8601-tidspunkter, der bruges, når
period er custom. Ignoreres ellers. Standard er null.Hvilken af to tidszoner tidsvinduet opløses i:
account, kontoens egen planlægningszone, eller local, den zone, seerens browser befinder sig i. account falder tilbage til seerens egen, når kontoen ikke har angivet nogen. Standard er "account".Hvilket berøringspunkt i en persons rejse der får krediteringen ved filtrering efter kilde:
last_touch, standarden, eller first_touch. Elementerne indeholder vælgeren og ændrer denne værdi, så en host kan styre den og aflæse den igen fra attributionModelChanged. Standard er "last_touch".Visuel tilpasning af denne gruppes elementer. Tilsidesætter den globale
WhopElements({ appearance }). Ændr den live med update({ appearance }).Sprog for UI-teksten i denne gruppes elementer. Sæt den til et af appens indbyggede sprog for at tilsidesætte den globale konfiguration. Enhver anden værdi falder tilbage til standardsproget.
Events
Angiv callbacks i create-indstillingerne eller som React-props.onLoadingChange
Kører, når den samlede indlæsningstilstand ændres. Værdien er true, så længe et monteret element stadig indlæses.
Metoder
Kald disse på Tracking-handlet frawhop.tracking.create({ … }) eller useTracking().
update
Fletter nye handle-indstillinger ind i alle monterede elementer. I React ændrer du i stedet namespace-props.
Parametre
destroy
Ødelægger alle elementer og sub-controllere, som dette handle har oprettet, fjerner controller-framen og frigiver dens abonnementer. Du kan kalde den mere end én gang, men et ødelagt handle afviser alle andre kald — opret et nyt handle for at starte forfra. React fjerner gruppen automatisk, når provideren afmonteres.
Elementer
De elementer, som denne gruppe monterer. Hvert element har sin egen side:PeopleElement
Alle, kontoen har set — besøgende og kunder identificeret ud fra pixelaktivitet, med deres kilde, forbrug og aktivitetstællere. Søg, filtrér efter kilde, event, geografi eller enhed, sortér enhver kolonne, og bladr igennem. Et klik på en række følger
links.person, når handlet konfigurerer det, og kommer ellers tilbage til dig som personOpened.EventsElement
Hver event, kontoen har målt — sidevisninger, leads, køb og brugerdefinerede pixel-events — som en rå, filtrerbar strøm. Rækkerne bag enhver metrik: filtrér efter event, kilde, geografi eller enhed inden for handlets tidsvindue, eller søg på én persons identifikator for at læse hele deres rejse. En personcelle følger
links.person, når handlet konfigurerer det, og kommer ellers tilbage til dig som personOpened.PersonElement
Alt, hvad kontoen ved om én person: hvem de er, hvor de kom fra, hvad de har brugt, og hver event, de har udført, i rækkefølge. Den visning, et klik på en person fører til: montér den på den side, som
links.person peger på, eller vis den oven på din egen side, når people eller events udløser personOpened. identifier accepterer enhver identifikator, en person er set under, så en personOpened-payload kan slås op her uændret.
