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, PURCHASED og en håndfuld andre foruddefinerede navne. Der er ingen plads til en brugerdefineret hændelse, og at presse vores data ind i en PAGE_VIEWED ville 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.

PlatformKontofeltNøgle
ActiveCampaignactidWebsted → Webstedssporing, ved siden af hændelsesnøglen
MailchimpMålgruppe-ID'etEn API-nøgle - behold dens -us14-endelse; datacentret læses fra den
Iterableikke nødvendigt - lad feltet være tomtEn nøgle med tilladelsen »Tillad kald til hændelsessporing«
Klaviyoikke nødvendigt - lad feltet være tomtEn 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 angiverIdentificeres via
BrazeREST-endepunkt og API-nøglee-mailadresse
Customer.iowebsteds-ID, API-nøgle og din regiondit eget kunde-ID
Brevosporingsnøglen, intet andete-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.