Clientsliewenszyklus (serversäiteg)
Schéckt den Ofspill-Link vun eisem Server un ActiveCampaign, Mailchimp, Iterable oder Klaviyo, soubal eng Sessioun Är eege Clients-ID kritt.
1. Firwat et dëst nieft der Browserbréck gëtt
MousePlayer huet schonn eng Clientsliewenszyklus-Bréck, déi an de SDK op Ärer eegener Säit schreift — Klaviyo, Braze, Customer.io a sechs anerer. Dës mécht datselwecht vun eisem Server aus. Si existéiert, well fir zwou vun de gréisste Plattformen de Browserwee einfach net verfügbar ass:
- ActiveCampaign huet iwwerhaapt keng Browser-API fir Eventer. Säin
vgo()kann e Kont an eng E-Mail-Adress setzen an d'Verfollegung starten — e kann keen Event schécken. Eventer lafen iwwer d'Event Tracking API mat engem separaten Eventschlëssel, nëmme serversäiteg. - Mailchimp huet eng, mee mat engem zouene Vocabulaire. Säi Websäiteverfollegungspixel akzeptéiert
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDan e puer aner virdefinéiert Nimm. Et gëtt keng Plaz fir en eegendefinéierten Event, an eis Donnéeën an ePAGE_VIEWEDze zwénge wier eng Ligen an Ärem eegenen Datemodell.
Fir Iterable a Klaviyo ass de Serverwee einfach méi zouverlässeg: kee Reklammeblocker, kee SDK, deen eventuell gelueden ass oder net, kee Reider, deen ze fréi zougeet.
2. Wat et brauch
Dräi Felder; wéi eng Dir ausfëllt, hänkt vun der Plattform of.
| Plattform | Kontfeld | Schlëssel |
|---|---|---|
| ActiveCampaign | actid | Websäit → Websäiteverfollegung, nieft dem Eventschlëssel |
| Mailchimp | D'ID vun der Zilgrupp | En API-Schlëssel — behaalt säi Suffix am Stil -us14 ; d'Datenzenter gëtt doraus gelies |
| Iterable | net néideg — eidel loossen | E Schlëssel mat der Berechtegung „Allow event track calls“ |
| Klaviyo | net néideg — eidel loossen | E privaten API-Schlëssel |
Dat drëtt Feld ass den Eventnumm, ënner deem et erschéngt. Halt e kuerz: héchstens 32 Zeechen. Dat ass d'Limit vun der API, net eis. Mir kierzen e beim Späicheren amplaz beim Schécken — soss géif de Formular Iech eppes Aneschtes weisen ewéi dat, wat ukënnt.
Mailchimp: Behaalt de Suffix vun Ärem API-Schlëssel. Deen Deel nom leschte Bindestréch (-us14) nennt dat Datenzenter vun Ärem Kont, an d'Adress gëtt doraus gebaut. E Schlëssel ouni deen Deel gëtt mat enger kloerer Meldung refuséiert, amplaz op enger Plaz ze scheiteren, déi Dir net gesitt.
3. Wéini et ausgeléist gëtt — a wéini net
An deem Moment, wou eng Sessioun identifizéiert gëtt: wann Är Websäit MousePlayer.setUserId()oprifft, wann eis Analysbréck eng eendeiteg ID zeréckliest oder wann Äre Server den Identifikatiounsendpunkt oprifft. Virdru wësse mir net, wiem d'Opnam gehéiert.
Nëmme mat enger E-Mail-Adress
All véier Plattforme adresséieren e Kontakt iwwer seng E-Mail. Wann Är Clients-ID eng Kontraktsnummer ass, gëtt näischt verschéckt — eng Aufgab an d'Schlaang ze setzen, déi nëmme feel schloe kann, géif Äre Protokoll nëmme mat onnéidege Meldunge fëllen.
De Kontakt muss schonn existéieren. Keng vun dëse Plattformen erstellt een aus engem Event; ActiveCampaign verwërft den Event komplett, wann et d'Adress net erkennt. Dës Bréck beräichert Är bestoend Kontakter — si baut Är Lëscht net op.
All Event huet eng ID
Esou kann déiselwecht Sessioun net zweemol gezielt ginn, och wann eng Aufgab widderholl gëtt.
4. Wat op där anerer Säit ukënnt
Een Event, deen den Ofspill-Link als Eegenschaft mam Numm mouseplayer_session_urlenthält. Maacht en op, an Dir sidd an der Opnam vu genee där Sessioun.
Vun do u gëllt d'Logik vun Ärer Plattform: Benotzt den Event als Automatiséierungsausléiser, als Segmentbedéngung oder loosst Är Ekipp einfach d'Opnam vum Kontakt aus opmaachen.
De Schlëssel verléisst eise Server ni
E gëtt mat AES-256-GCM verschlësselt gespäichert, nom Späicheren ni méi gewisen a bewosst net an déi intern Warteschlaang gesat, déi d'Aufgab transportéiert — de Worker rifft e selwer aus der Datebank of.
HTTP 200 bedeit net geliwwert
ActiveCampaign äntwert mat Status 200 an {"success":0} , wann en en Event refuséiert. Mir liesen den Äntwertinhalt, net nëmmen de Status, soudatt eng Oflehnung als Feeler am Liwwerprotokoll erschéngt an net als onbemierkten Erfolleg.
5. Braze, Customer.io a Brevo
Dräi weider Plattformen um serversäitege Wee. Zwou dovu brauchen eppes, wat déi aner net brauchen: eng Plaz.
| Dir gitt un | Identifizéiert duerch | |
|---|---|---|
| Braze | REST-Endpunkt an API-Schlëssel | E-Mail-Adress |
| Customer.io | Websäiten-ID, API-Schlëssel an Är Regioun | Är eege Clients-ID |
| Brevo | de Verfollegungsschlëssel, soss näischt | E-Mail-Adress |
Zwou dovu sinn op enger bestëmmter Plaz
Braze huet instanzgebonne REST-Endpunkten; Customer.io huet zwou getrennte Regioune mat verschiddene Hosten. Béides léisst sech net aus dem Schlëssel ofleeden, an eng falsch Wiel liwwert 401 — wat Iech no engem Feeler am Schlëssel siche léisst. Nëmmen aus deem Grond gëtt et déi zwee Felder.
Customer.io brauch als eenzeg keng E-Mail
Et kennt d'Leit ënner därselwechter ID, déi Dir hinnen zouuerdent; eng E-Mail-Adress ze verlaange wier dofir eng erfonnten Hürd. Déi aner sechs ordnen iwwer d'E-Mail zou, a bei hinne produzéiert eng Sessioun, déi duerch eng Kontraktsnummer identifizéiert ass, näischt — zu Recht.
Keng nei Profiller
De Braze-Opruff enthält _update_existing_only. Déiselwecht Entscheedung ewéi bei der CRM-Bréck: Eng Browsersessioun ass keng zouverlässeg Ausso doriwwer, wien Är Clientë sinn, an eng Clientsliewenszyklus-Plattform, déi pro anonyme Visiteur e Profil derbäikritt, ass méi schlëmm ewéi keng Integratioun.
Brevo äntwert mat 204, Braze mat 201 an engem Hoken
Brevo liwwert iwwerhaapt keen Inhalt zeréck — do ass 2xx tatsächlech déi ganz Wourecht. Braze liwwert "message": "success" a kann niewendrun en Array mam Numm errors enthalen: Fatal Problemer erschéngen an der Meldung, toleréiert Feldverloschter nëmmen an errors. Nëmmen eng vun deenen zwou Informatiounen ze liesen, féiert an déi eng oder aner Richtung an d'Ier.
All hei genannt Marke gehéieren hire jeeweilege Besëtzer. MousePlayer huet keng Geschäftsbezéiung mat dësen Ubidder.