Kundelivscyklus (serverside)
Send afspilningslinket til ActiveCampaign, Mailchimp, Iterable eller Klaviyo fra vores server i det øjeblik, en session får dit eget kunde-ID.
1. Hvorfor denne findes ved siden af browserbroen
MousePlayer har allerede en kundelivscyklusbro, der skriver til SDK'et på din egen side - Klaviyo, Braze, Customer.io og seks andre. Denne udfører samme opgave fra vores server og findes, fordi browservejen slet ikke er tilgængelig for to af de største platforme:
- ActiveCampaign har slet intet browser-API til hændelser. Dens
vgo()kan angive en konto og en e-mailadresse og starte sporing - den kan ikke sende en hændelse. Hændelser sendes via Event Tracking API med en separat hændelsesnøgle, kun fra serversiden. - Mailchimp har et, men med et lukket ordforråd. Dens webstedssporingspixel accepterer
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDog en håndfuld andre foruddefinerede navne. Der er ingen plads til en brugerdefineret hændelse, og at presse vores data ind i enPAGE_VIEWEDville være en usandhed i din egen datamodel.
For Iterable og Klaviyo er servervejen blot mere pålidelig: ingen annonceblokker, intet SDK, der måske er indlæst, og ingen fane, der lukker for tidligt.
2. Hvad kræves
Tre felter; hvilke du udfylder, afhænger af platformen.
| Platform | Kontofelt | Nøgle |
|---|---|---|
| ActiveCampaign | actid | Websted → Webstedssporing, ved siden af hændelsesnøglen |
| Mailchimp | Målgruppe-ID'et | En API-nøgle - behold dens -us14-endelse; datacentret læses fra den |
| Iterable | ikke nødvendigt - lad feltet være tomt | En nøgle med tilladelsen »Tillad kald til hændelsessporing« |
| Klaviyo | ikke nødvendigt - lad feltet være tomt | En privat API-nøgle |
Det tredje felt er hændelsesnavnet, som vises på platformen. Hold det kort: højst 32 tegn. Det er API'ets grænse, ikke vores, og vi forkorter det, når du gemmer, ikke når vi sender - ellers ville formularen vise noget andet end det, der ankommer.
Mailchimp: Behold endelsen på din API-nøgle. Delen efter den sidste bindestreg (-us14) angiver datacentret for din konto, og adressen bygges ud fra den. En nøgle uden denne del afvises med en tydelig meddelelse i stedet for at fejle et sted, du ikke kan se.
3. Hvornår udløses det - og hvornår ikke
I det øjeblik en session identificeres: når dit websted kalder MousePlayer.setUserId(), når vores analysebro læser et særskilt ID tilbage, eller når din server kalder identify-endepunktet. Før det ved vi ikke, hvem optagelsen tilhører.
Kun med en e-mailadresse
Alle fire platforme identificerer en kontakt via e-mailadressen. Hvis dit kunde-ID er et kontraktnummer, sendes intet - en opgave, der kun kan mislykkes, ville blot fylde loggen med støj.
Kontakten skal allerede findes. Ingen af platformene opretter en kontakt ud fra en hændelse; ActiveCampaign kasserer hændelsen helt, hvis adressen er ukendt. Broen beriger dine eksisterende kontakter - den opbygger ikke din liste.
Hver hændelse indeholder et ID
Så samme session ikke kan tælles to gange, selv hvis en opgave prøves igen.
4. Hvad ankommer på den anden side
Én hændelse med afspilningslinket som en egenskab ved navn mouseplayer_session_url. Åbn den, og du er i optagelsen af præcis den session.
Derfra gælder platformens egen logik: brug hændelsen som udløser til automatisering, som segmentbetingelse eller blot til at lade teamet åbne optagelsen fra kontakten.
Nøglen forlader aldrig vores server
Den lagres krypteret med AES-256-GCM, vises aldrig igen efter lagring og placeres bevidst ikke i den interne opgavekø - workeren henter den selv fra databasen.
HTTP 200 betyder ikke leveret
ActiveCampaign svarer med status 200 og {"success":0} når en hændelse afvises. Vi læser svarindholdet, ikke kun status, så en afvisning vises som fejl i leveringsloggen i stedet for som en tavs succes.
5. Braze, Customer.io og Brevo
Yderligere tre platforme på serversiden. To af dem kræver noget, de andre ikke gør: en placering.
| Du angiver | Identificeres via | |
|---|---|---|
| Braze | REST-endepunkt og API-nøgle | e-mailadresse |
| Customer.io | websteds-ID, API-nøgle og din region | dit eget kunde-ID |
| Brevo | sporingsnøglen, intet andet | e-mailadresse |
To af dem findes et bestemt sted
Braze bruger instansbundne REST-endepunkter; Customer.io bruger to separate regioner med forskellige værter. Ingen af dem kan udledes af nøglen, og et forkert valg giver 401 - så du begynder at lede efter fejlen i nøglen. Derfor findes begge felter.
Customer.io er den, der ikke kræver e-mail
Den kender personer under det ID, du tildeler dem, så et krav om e-mail ville være en opfundet hindring. De andre seks matcher på e-mail, og hos dem giver en session identificeret med et kontraktnummer intet - helt korrekt.
Ingen nye profiler
Braze-kaldet indeholder _update_existing_only. Samme beslutning som i CRM-broen: en browsersession er ikke en pålidelig oplysning om, hvem dine kunder er, og en kundelivscyklusplatform, der får en profil pr. anonym besøgende, er værre end ingen integration.
Brevo svarer 204, Braze svarer 201 med en hage
Brevo returnerer intet svarindhold - dér er en 2xx-status virkelig hele sandheden. Braze returnerer "message": "success" og kan have et errors-array ved siden af: alvorlige problemer vises i message, tolererede tab af felter kun i errors. At læse kun det ene giver et forkert billede i den ene eller den anden retning.
Alle nævnte varemærker tilhører deres respektive ejere. MousePlayer har ingen forretningsforbindelse med disse udbydere.