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 medbiz_.
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 etwhop.track-kald kan udløses der, hvor handlingen sker, skal du bruge det i stedet.
Send en serverhændelse
Læs besøgende-ID'et i browseren
Pixlen gemmer hver besøgendes ID i en førsteparts-cookie ved navn Hvert underdomæne får sin egen
_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
_wuid. Pixlen knytter dem til én person, så læs den cookie, der findes på den side, hvor overdragelsen sker.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.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.
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:Bekræft, at den landede på den rigtige person
List Events accepterer et besøgende-ID som Din serverhændelse vises ved siden af pixlens sidevisninger med det samme
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
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
Kunaccount_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. Etlead, 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
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 sammeevent_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 ingenuser.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.
