Deze pagina documenteert
@whop/elements@1.10.0 en @whop/elements-react@1.10.0.v1.0.0.
Wordt gemount binnen Websites. Geef props en callbacks door via de create-opties of als React-props.
Je kunt dit element inline mounten (
create) of openen als modale overlay (createOverlay).Voorbeeldgegevens. Open de Playground.
Props
Account-ID, met prefix
biz_, waarvan dit de pixel is. Verplicht; het fragment, de scans en de uitnodigingen draaien er allemaal tegen. Standaard "".Een token met beperkte scopes voor de scans en de ontwikkelaarsuitnodiging. De scans hebben
company:basic:read nodig; “Invite a developer” heeft daarnaast authorized_user:create nodig, en de event-presets lezen het account met company:balance:read (zonder die scope werkt de wizard nog steeds, met een generieke presetlijst). Als er geen destinationUrl wordt doorgegeven, stelt het lege URL-veld ook pagina’s voor uit de advertenties en het pixelverkeer van het account — die leesacties hebben ad_campaign:basic:read en stats:read nodig, en zonder die scopes blijft het veld gewoon leeg. Maak het token op je server aan met POST /api/v1/access_tokens en stel een nieuw token in voordat het verloopt. Een ander element dat deze wizard binnen zichzelf opent — zoals de ads-campaign-creator — voert deze calls uit met zijn eigen token, dus voeg deze scopes toe aan dat ene token in plaats van een tweede aan te maken: dit element kan een referentie die je elders instelt niet lezen. Zonder token gebruiken de calls de eigen sessie van de kijker, die alleen same-origin antwoordt.De pagina die moet worden gecontroleerd, gescand bij het mounten. Laat je het leeg, dan vraagt de wizard erom. Bepaalt ook of “Verify live” beschikbaar is in de events-stap — die knop leidt de accounteigenaar door zijn eigen funnel om events op te vangen die een server-side scan niet kan zien, dus hij verschijnt pas zodra er een bestemming bekend is, hier opgegeven of in de wizard genoemd. Wordt één keer bij het opstarten gelezen, dus
update() wijzigt het doel niet halverwege de flow — maak een nieuwe mount aan voor een andere pagina. Standaard "".Optioneel. Een event dat op die pagina moet afgaan (
lead, schedule, view_content, …); de events-stap blokkeert totdat het is gedetecteerd. Niet ingesteld, dan wordt elk event aangeboden en is geen enkel event verplicht. Events die Whop server-side vastlegt (purchase, subscribe, proefperiodes, checkoutstappen) worden genegeerd. Wordt één keer bij het opstarten gelezen. Standaard "".Een URL waarnaar de bestemming doorverwijst, wanneer het event daar afgaat. De accounteigenaar kan er ook een instellen in de wizard — luister naar
redirectUrlChanged en geef de URL de volgende keer terug. Standaard "".Waar de wizard opent: bij de installatiestap, of direct bij
events wanneer de pixel er al is en alleen het conversie-event ontbreekt. Standaard "install".Opent op het introscherm “waarom een pixel”. Zet dit uit waar de accounteigenaar al weet waarom die hier is — een campagneflow die hem halverwege de lancering hierheen stuurt — en de wizard opent direct bij de installatiestap. Standaard
true.Biedt de optie “Invite a developer to install it”. Verberg deze waar de gebruikers van je embed geen leden zouden moeten uitnodigen voor het Whop-team erachter. Standaard
true.Toont het scherm “je pixel is live” nadat een pagina door de controle is gekomen, dat conversie-events als volgende stap aanbiedt. Zet dit uit waar de accounteigenaar juist voor de events zelf kwam — een geslaagde controle gaat dan direct daarnaartoe, in plaats van te pauzeren op een scherm waar hij doorheen zou klikken. Standaard
true.Begint met de paginacontrole in plaats van met de installatie-instructies: het URL-veld (en de suggesties ervan) staat bovenaan, de installatieopties worden ingeklapt onder een toggle “Pixel not installed yet?”, en de koptekst luidt “Verify your pixel”. Voor een accounteigenaar die al een pixel heeft en wil uitzoeken waarom er niets wordt toegeschreven. Combineer het met
showIntro: false. Standaard false.Events
Geef callbacks door in de create-opties of als React-props.onRedirectUrlChanged
De accounteigenaar heeft in de wizard een redirect-URL ingesteld of gewist. Sla deze op en geef hem de volgende keer terug als redirectUrl.
onScanned
Een pixelscan is afgerond. Wordt geactiveerd voor elke URL die de wizard controleert, zodat je eigen installatiebadge die kan volgen. primary markeert de pagina die wordt ingesteld: de funnelchecker scant alles wat de accounteigenaar verder opgeeft, inclusief andere hostnamen, dus controleer hierop voordat je een resultaat behandelt als iets dat over hun site gaat. Je hebt dit niet nodig om een websites-tabel actueel te houden — wanneer het onder die handle is gemount, krijgt een site waarvan bewezen is dat die live is al zijn wachtende rij.
onFinished
Er is op Done gedrukt. Controleer de pagina zelf opnieuw — dit betekent dat de wizard klaar is, niet dat aan je vereisten is voldaan.
onUrlSubmitted
De accounteigenaar heeft vanuit de wizard de te controleren pagina opgegeven — handmatig getypt of gekozen uit de voorgestelde pagina’s. Alleen bereikbaar wanneer er bij het mounten geen bestemming is opgegeven.
onVerifyLaunched
Er is op “Verify live” gedrukt. popupBlocked betekent dat de browser het funnelvenster heeft geweigerd, waardoor de doorloop nooit is gestart.
onVerifyConnected
De funnelpagina heeft de wizard teruggepingd — de pixel is daar geladen en de doorloop is live.
onVerdict
De verify-live-doorloop is voltooid. ok betekent geen hiaten in de tracking; anders bevat gaps de hiaatcodes die de doorloop heeft gevonden.
onEventVerified
De accounteigenaar heeft zijn funnel doorlopen met “Verify live” en dit event is afgegaan — het bewijs dat het is gekoppeld op een plek die een server-side scan niet kan bereiken.
onLoaderStart
Wordt uitgevoerd nadat het laadskelet voor het eerst is getekend en vóór onReady.
onReady
Wordt uitgevoerd na de eerste volledige weergave van het element.
onError
Wordt uitgevoerd wanneer het element niet laadt of crasht. De fallback blijft zichtbaar. Gebruik code voor programmatische afhandeling. sourceKey identificeert een mislukte host-state-bron.
Methoden
Roep deze aan op de handle diecreate retourneert, of via een React-ref.
mount
Mount het element in target en begint met laden. React-componenten mounten zichzelf.
Parameters
destroy
Verwijdert het element en geeft het frame en de abonnementen ervan vrij. Je kunt dit meer dan eens aanroepen. React verwijdert het element automatisch.
update
Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de props van de component.
Parameters
Styling
Style deze onderdelen viaappearance.classes. Gebruik camelCase of kebab-case voor eigenschapsnamen en vermeld eenheden. Stylesheets van de pagina kunnen het frame van het element niet bereiken. Het framework valideert elke declaratie voordat die wordt geïnjecteerd.
appearance door aan <Websites>. Stel het globaal in met WhopElements({ appearance }).
