Kundelivssyklus (serversiden)
Send avspillingslenken til ActiveCampaign, Mailchimp, Iterable eller Klaviyo fra serveren vår i det øyeblikket en økt får din egen kunde-ID.
1. Hvorfor dette finnes ved siden av nettleserbroen
MousePlayer har allerede en bro for kundelivssyklus som skriver til SDK-et på din egen side — Klaviyo, Braze, Customer.io og seks andre. Denne gjør samme jobb fra serveren vår i stedet, fordi nettleserveien rett og slett ikke finnes for to av de største plattformene:
- ActiveCampaign har ikke noe nettleser-API for hendelser. Dets
vgo()kan angi en konto og en e-postadresse og starte sporing — det kan ikke sende en hendelse. Hendelser går via Event Tracking API med en egen hendelsesnøkkel, bare på serversiden. - Mailchimp har et, men med et lukket ordforråd. Pikselen for nettstedssporing godtar
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDog noen få andre forhåndsdefinerte navn. Det finnes ingen plass for en egendefinert hendelse, og å presse dataene våre inn i enPAGE_VIEWEDville vært en løgn i din egen datamodell.
For Iterable og Klaviyo er serverveien rett og slett mer pålitelig: ingen annonseblokker, intet SDK som kanskje er lastet inn, ingen fane som lukkes for tidlig.
2. Hva som trengs
Tre felt, og hvilke du fyller ut, avhenger av plattformen.
| Plattform | Kontofelt | Nøkkel |
|---|---|---|
| ActiveCampaign | actid | Nettsted → Nettstedssporing, ved siden av hendelsesnøkkelen |
| Mailchimp | Målgruppe-ID-en | En API-nøkkel — behold suffikset av typen -us14, for datasenteret leses fra det |
| Iterable | ikke nødvendig — la det stå tomt | En nøkkel med tillatelsen «Tillat kall for hendelsessporing» |
| Klaviyo | ikke nødvendig — la det stå tomt | En privat API-nøkkel |
Det tredje feltet er hendelsesnavnet den vises under. Hold det kort: høyst 32 tegn. Det er API-ets grense, ikke vår, og vi forkorter ved lagring i stedet for ved sending — ellers ville skjemaet vist noe annet enn det som kommer frem.
Mailchimp: behold suffikset på API-nøkkelen. Delen etter siste bindestrek (-us14) angir datasenteret kontoen ligger i, og adressen bygges fra den. En nøkkel uten dette avvises med en tydelig melding i stedet for å feile et sted du ikke kan se.
3. Når det utløses — og når det ikke gjør det
I det øyeblikket en økt identifiseres: når nettstedet kaller MousePlayer.setUserId(), når analysebroen vår leser tilbake en entydig ID, eller når serveren din kaller identifikasjonsendepunktet. Før det vet vi ikke hvem opptaket tilhører.
Bare med e-postadresse
Alle fire plattformene finner en kontakt via e-postadressen. Hvis kunde-ID-en er et kontraktsnummer, sendes ingenting — å kølegge en oppgave som bare kan feile, ville bare fylt loggen med støy.
Kontakten må finnes fra før. Ingen av disse plattformene oppretter en kontakt fra en hendelse; ActiveCampaign forkaster hendelsen helt hvis adressen er ukjent. Denne broen beriker eksisterende kontakter — den bygger ikke listen din.
Hver hendelse har en ID
Da kan samme økt ikke telles to ganger, selv om en oppgave forsøkes på nytt.
4. Hva som kommer frem på den andre siden
Én hendelse med avspillingslenken som en egenskap kalt mouseplayer_session_url. Åpne den, så er du i opptaket av akkurat den økten.
Derfra gjelder plattformens egen logikk: bruk hendelsen som utløser for automatisering, som segmentbetingelse, eller la teamet åpne opptaket fra kontakten.
Nøkkelen forlater aldri serveren vår
Den lagres AES-256-GCM-kryptert, vises aldri igjen etter lagring og legges bevisst ikke i den interne oppgavekøen — arbeiderprosessen henter den selv fra databasen.
HTTP 200 betyr ikke levert
ActiveCampaign svarer med status 200 og {"success":0} når en hendelse avvises. Vi leser svarinnholdet, ikke bare statusen, slik at avvisningen vises som en feil i leveringsloggen og ikke som en stille suksess.
5. Braze, Customer.io og Brevo
Tre plattformer til på serversiden. To av dem trenger noe de andre ikke trenger: et sted.
| Du oppgir | Identifiseres via | |
|---|---|---|
| Braze | REST-endepunkt og API-nøkkel | e-postadresse |
| Customer.io | nettsteds-ID, API-nøkkel og regionen din | din egen kunde-ID |
| Brevo | bare sporingsnøkkelen | e-postadresse |
To av dem ligger et bestemt sted
Braze bruker REST-endepunkter bundet til instansen; Customer.io har to separate regioner med ulike verter. Ingen av delene kan utledes fra nøkkelen, og feil valg gir 401 — som får deg til å undersøke nøkkelen. Begge feltene finnes av nettopp den grunnen.
Customer.io trenger ikke e-postadresse
Det kjenner personer under samme ID som du tildeler dem, så et krav om e-postadresse ville vært en oppdiktet hindring. De seks andre kobler via e-post, og der fører en økt identifisert med kontraktsnummer ikke til noe — helt riktig.
Ingen nye profiler
Braze-kallet inneholder _update_existing_only. Samme valg som for CRM-broen: en nettleserøkt er ingen pålitelig kilde til hvem kundene dine er, og en plattform for kundelivssyklus som lager en profil per anonym besøkende, er verre enn ingen integrasjon.
Brevo svarer 204, Braze svarer 201 med et forbehold
Brevo returnerer ikke noe innhold — der er en 2xx-status faktisk hele sannheten. Braze returnerer "message": "success" og kan ha et errors-array ved siden av: alvorlige problemer vises i meldingen, tolererte felttap bare i errors. Å lese bare den ene gir feil konklusjon i den ene eller andre retningen.
Alle nevnte varemerker tilhører sine respektive eiere. MousePlayer har ingen forretningsforbindelse med disse leverandørene.