Skip to main content
Events API er serversidens modstykke til Whop Pixel. POST /events accepterer de samme hændelser, som pixlen sender fra browseren, så du kan rapportere konverteringer, der sker steder, hvor ingen pixel kører. Det dækker et salg, der lukkes i dit CRM, en betaling på din egen backend, en webhook fra en formular eller et bookingværktøj, eller et opkald, som en sælger markerer som booket.
Før du starter skal du have tre ting:
  • Whop Pixel installeret på alle sider i din tragt. Den opretter det besøgende-ID, som denne guide sender videre.
  • En API-nøgle med tilladelsen event:create. Opret en under Account API Keys, og opbevar den på din server. Læg den aldrig i browserkode.
  • Dit konto-ID, den del af din dashboard-URL efter dashboard/, der starter med biz_.

Hvornår du skal bruge Events API

De fleste integrationer har ikke brug for dette. Pixlen rapporterer allerede alt, hvad der sker i browseren, og den udfylder selv besøgende-ID, IP-adresse og user agent. Brug kun Events API, når din server er det eneste sted, der ved, at en konvertering er sket. Hvis et whop.track-kald kan udløses der, hvor handlingen sker, skal du bruge det i stedet.

Send en serverhændelse

1

Læs besøgende-ID'et i browseren

Pixlen gemmer hver besøgendes ID i en førsteparts-cookie ved navn _wuid på dit domæne og spejler det til localStorage under den samme nøgle. Værdien ser ud som wuid_k3j9x2m1p8q4r7s0t5u6. Læs den i det øjeblik, den besøgende udfører den handling, du senere vil rapportere, ikke ved sideindlæsning. Cookien findes først, når pixel-snippet’en er kørt på siden.
Read the visitor ID
Hvert underdomæne får sin egen _wuid. Pixlen knytter dem til én person, så læs den cookie, der findes på den side, hvor overdragelsen sker.
2

Send det til din server sammen med handlingen

Vedhæft besøgende-ID’et til den anmodning, der allerede bringer handlingen til din backend: en formularindsendelse, et checkout-kald, en tilmeldingsanmodning. Registrér sidens URL på samme tid. Den indeholder de UTM’er og klik-ID’er, som din server ellers ikke kan se.
Hvis din backend svarer på den samme vært som siden, kommer _wuid-cookien automatisk med anmodningen. Læs den der i stedet for at sende den fra browseren. Cookien er kun sat for den vært, så en anmodning fra example.com til api.example.com medbringer den ikke.Din server ser allerede den besøgendes IP-adresse og user agent på den anmodning. Gem begge.
3

Gem det på kundeposten

Gem besøgende-ID, side-URL, IP-adresse og user agent på leadet, kunden eller ordren. Den konvertering, du rapporterer, kan ske flere dage efter besøget. En aftale, som dit salgsteam lukker i næste uge, har stadig brug for besøgende-ID’et fra det oprindelige besøg for at kunne tilskrives. Whop accepterer hændelser, der er op til 28 dage gamle.
4

Send hændelsen

Post hændelsen fra din server med din API-nøgle. Eksemplet rapporterer et lead fra en besøgende, der kom fra en annonce, udfyldte en tilbudsformular og derefter blev kvalificeret i et CRM.
url i eksemplet er det, en besøgende lander på efter at have trykket på en Whop-annonce på Meta. utm_meta_ad_id, utm_meta_adset_id og utm_meta_campaign_id er netværkets ID’er. wacid, wasid og waid er Whop-kampagne-, annoncegruppe- og annonce-ID’erne. utm_source angiver fladen (fb, ig, msg eller an), utm_placement placeringen, utm_content og utm_adset navnene på annoncen og annoncegruppen, og fbclid er det tag, som netværket selv tilføjer. Whop afgør ud fra disse, hvilken annonce der førte til besøget, så gem hele URL’en i stedet for at plukke parametre ud af den.Svaret returnerer det gemte hændelses-ID. Whop sætter kontoen foran dit event_id, så ID’er fra forskellige konti aldrig kolliderer:
5

Bekræft, at den landede på den rigtige person

List Events accepterer et besøgende-ID som identifier, så du kan læse hele den rejse, som hændelsen blev en del af. Anmodningen kræver en nøgle med en læsetilladelse såsom company:basic:read.
cURL
Din serverhændelse vises ved siden af pixlens sidevisninger med det samme person_id. Hvis sidevisningerne er der, men din hændelse ikke er, matchede besøgende-ID’et ikke. Se Fejlfinding. Hændelsen vises også på siden Events i dit dashboard.

Parametre, der afgør tilskrivning

Kun account_id og event_name er påkrævet. Resten af payloaden er det, der gør hændelsen tilskrivbar, så behandl også disse som påkrævede. Det fulde anmodningsskema findes på referencesiden Create Event.

Navngiv hændelsen

Brug de samme navne som pixlen. Et lead, du rapporterer fra din server, lander som den samme hændelse som et lead, pixlen rapporterer, så det tæller med i resultaterne for en kampagne, der bedømmes på leads. Ethvert andet event_name bliver en tilpasset hændelse under det navn. Hold navne korte og stabile, og genbrug et lille sæt.
Custom event
Send aldrig purchase for et salg, som Whop har behandlet. Whop registrerer automatisk alle checkouts, køb, abonnementer og prøveperioder på sin egen checkout og rapporterer dem til annoncenetværket. Send kun hændelser, som Whop ikke kan se.

Undgå dobbelte hændelser

Hvis den samme konvertering kan nå Whop både fra browseren og din server, skal du sende den fra begge med det samme event_name og det samme event_id. Whop beholder én kopi. Dette er den sikreste opsætning, når en formular udløser whop.track("lead", { event_id }) ved indsendelse, og din backend rapporterer det samme lead igen efter at have valideret det. event_id identificerer én handling, ikke typen af handling. Hvert lead skal have sit eget. En værdi, der opfindes på afsendelsestidspunktet, er ny hver gang, så den forhindrer ingenting. Brug et ID, som dit system allerede har for netop den handling.

Fejlfinding

Hændelsen er gemt, men ikke tilskrevet en annonce. Hændelsen indeholdt ingen user.anonymous_id, eller en værdi, som pixlen aldrig har brugt. De typiske årsager er, at cookien blev læst, før pixel-snippet’en kørte, at den blev læst på et domæne uden pixlen, eller at besøgende-ID’et blev gemt på den forkerte post. Bekræft rettelsen ved at vise hændelser for det besøgende-ID. Pixlens sidevisninger skal vises under det samme identifier som din hændelse. 400 med en meddelelse om event_time. Tidsstemplet er mere end 28 dage gammelt. Send hændelsen tættere på, hvornår den sker, eller drop den. 400 på en purchase-hændelse. value mangler eller er ikke større end nul. Annoncenetværk kan ikke optimere mod et salg uden beløb, så Whop afviser det. 401 eller 403. Nøglen mangler, mangler event:create eller tilhører en anden konto end account_id. Produktionsnøgler bruger https://api.whop.com/api/v1.