POST /events accepteert dezelfde events die de pixel vanuit de browser verstuurt, zodat je conversies kunt rapporteren die plaatsvinden waar geen pixel draait. Denk aan een verkoop die in je CRM is afgesloten, een betaling op je eigen backend, een webhook van een formulier- of boekingstool, of een gesprek dat een medewerker als geboekt markeert.
Voordat je begint, heb je drie dingen nodig:
- De Whop Pixel, geïnstalleerd op elke pagina van je funnel. Deze maakt de bezoekers-ID aan die deze gids doorgeeft.
- Een API-sleutel met de machtiging
event:create. Maak er een aan onder Account API Keys en bewaar deze op je server. Zet hem nooit in browsercode. - Je account-ID, het deel van je dashboard-URL na
dashboard/dat begint metbiz_.
Wanneer gebruik je de Events API
De meeste integraties hebben dit niet nodig. De pixel rapporteert al alles wat er in de browser gebeurt, en vult zelf de bezoekers-ID, het IP-adres en de user agent in. Gebruik de Events API alleen wanneer je server de enige plek is die weet dat er een conversie heeft plaatsgevonden. Als eenwhop.track-aanroep kan worden uitgevoerd waar de actie plaatsvindt, gebruik die dan.
Een server-event verzenden
Lees de bezoekers-ID in de browser
De pixel slaat de ID van elke bezoeker op in een first-party cookie met de naam Elk subdomein krijgt zijn eigen
_wuid op je domein, en spiegelt deze naar localStorage onder dezelfde sleutel. De waarde ziet eruit als wuid_k3j9x2m1p8q4r7s0t5u6. Lees deze uit op het moment dat de bezoeker de actie uitvoert die je later rapporteert, niet bij het laden van de pagina. De cookie bestaat pas nadat het pixelfragment op de pagina is uitgevoerd.Read the visitor ID
_wuid. De pixel koppelt ze aan één persoon, dus lees de cookie die aanwezig is op de pagina waar de overdracht plaatsvindt.Stuur deze met de actie naar je server
Voeg de bezoekers-ID toe aan het verzoek dat de actie al naar je backend brengt: een formulierinzending, een checkout-aanroep, een aanmeldverzoek. Leg tegelijkertijd de pagina-URL vast. Die bevat de UTM’s en klik-ID’s die je server anders niet kan zien.Als je backend antwoordt op dezelfde host als de pagina, komt de
_wuid-cookie vanzelf mee met het verzoek. Lees hem daar uit in plaats van hem vanuit de browser te versturen. De cookie is alleen voor die host ingesteld, dus een verzoek van example.com naar api.example.com bevat hem niet.Je server ziet bij dat verzoek al het IP-adres en de user agent van de bezoeker. Bewaar beide.Sla deze op bij het klantrecord
Sla de bezoekers-ID, pagina-URL, het IP-adres en de user agent op bij de lead, klant of bestelling. De conversie die je rapporteert kan dagen na het bezoek plaatsvinden. Een deal die je salesteam volgende week sluit, heeft nog steeds de bezoekers-ID van het oorspronkelijke bezoek nodig voor toeschrijving. Whop accepteert events tot 28 dagen oud.
Verstuur het event
Verstuur het event vanaf je server met je API-sleutel. Het voorbeeld rapporteert een lead van een bezoeker die via een advertentie binnenkwam, een offerteformulier invulde en daarna in een CRM werd gekwalificeerd.De
url in het voorbeeld is waar een bezoeker terechtkomt na het tikken op een Whop-advertentie op Meta. utm_meta_ad_id, utm_meta_adset_id en utm_meta_campaign_id zijn de ID’s van het netwerk. wacid, wasid en waid zijn de campagne-, advertentiegroep- en advertentie-ID’s van Whop. utm_source noemt het oppervlak (fb, ig, msg of an), utm_placement de plaatsing, utm_content en utm_adset de namen van de advertentie en advertentiegroep, en fbclid is de tag die het netwerk zelf toevoegt. Whop bepaalt hieruit welke advertentie het bezoek heeft opgeleverd, dus sla de volledige URL op in plaats van er parameters uit te kiezen.De respons retourneert de opgeslagen event-ID. Whop zet het account voor je event_id, zodat ID’s van verschillende accounts nooit botsen:Controleer of het bij de juiste persoon is beland
List Events accepteert een bezoekers-ID als Je server-event verschijnt naast de paginaweergaven van de pixel met dezelfde
identifier, zodat je het volledige traject kunt lezen waaraan het event is toegevoegd. Het verzoek heeft een sleutel nodig met een leesmachtiging zoals company:basic:read.cURL
person_id. Als de paginaweergaven er wel zijn maar je event niet, kwam de bezoekers-ID niet overeen. Zie Probleemoplossing. Het event verschijnt ook op de Events-pagina in je dashboard.Parameters die de toeschrijving bepalen
Alleenaccount_id en event_name zijn verplicht. De rest van de payload maakt het event toeschrijfbaar, dus behandel deze ook als verplicht.
Het volledige request-schema staat op de referentiepagina Create Event.
Het event een naam geven
Gebruik dezelfde namen als de pixel. Eenlead die je vanaf je server rapporteert, komt binnen als hetzelfde event als een lead die de pixel rapporteert, dus telt mee voor de resultaten van een campagne die op leads wordt beoordeeld.
Elke andere
event_name wordt een aangepast event onder die naam. Houd namen kort en stabiel, en hergebruik een kleine set.
Custom event
Dubbele events voorkomen
Als dezelfde conversie Whop zowel vanuit de browser als vanaf je server kan bereiken, verstuur haar dan vanaf beide met dezelfdeevent_name en dezelfde event_id. Whop bewaart één kopie. Dit is de veiligste setup wanneer een formulier bij verzenden whop.track("lead", { event_id }) uitvoert en je backend dezelfde lead na validatie opnieuw rapporteert.
De event_id identificeert één actie, niet het type actie. Elke lead heeft een eigen ID nodig. Een waarde die op het moment van verzenden wordt bedacht, is elke keer nieuw en voorkomt dus niets. Gebruik een ID die je systeem al voor die ene actie heeft.
Probleemoplossing
Het event is opgeslagen maar niet aan een advertentie toegeschreven. Het event bevatte geenuser.anonymous_id, of een waarde die de pixel nooit heeft gebruikt. Gebruikelijke oorzaken zijn het uitlezen van de cookie voordat het pixelfragment was uitgevoerd, het uitlezen op een domein zonder de pixel, of het opslaan van de bezoekers-ID bij het verkeerde record. Bevestig de oplossing door events voor die bezoekers-ID op te vragen. De paginaweergaven van de pixel moeten onder dezelfde identifier verschijnen als je event.
400 met een melding over event_time. De tijdstempel is meer dan 28 dagen oud. Verstuur het event dichter bij het moment waarop het plaatsvindt, of laat het vallen.
400 bij een purchase-event. value ontbreekt of is niet groter dan nul. Advertentienetwerken kunnen niet optimaliseren op een verkoop zonder bedrag, dus Whop weigert het event.
401 of 403. De sleutel ontbreekt, mist event:create, of hoort bij een ander account dan account_id. Productiesleutels gebruiken https://api.whop.com/api/v1.
