Lifecycle (serverseitig)

1. Warum es das neben der Browser-Brücke gibt

MousePlayer hat bereits eine Lifecycle-Brücke, die in das SDK auf Ihrer eigenen Seite schreibt - Klaviyo, Braze, Customer.io und sechs weitere. Diese hier tut dasselbe von unserem Server aus, und es gibt sie, weil der Weg über den Browser bei zwei der größten Plattformen schlicht nicht existiert:

• ActiveCampaign hat gar keine Browser-API für Ereignisse. Sein vgo() kann ein Konto und eine E-Mail-Adresse setzen und das Tracking starten - senden kann es nicht. Ereignisse laufen über die Event-Tracking-API mit einem eigenen Event Key, ausschließlich serverseitig.
• Mailchimp hat eine, aber mit geschlossenem Vokabular. Sein Site-Tracking-Pixel nimmt PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED und eine Handvoll weiterer vorgegebener Namen. Für ein eigenes Ereignis ist kein Platz vorgesehen, und unsere Daten in ein PAGE_VIEWED zu pressen wäre eine Notlüge in Ihrem eigenen Datenmodell.

2. Was es braucht

Drei Felder, und welche davon Sie ausfüllen, hängt von der Plattform ab.

Das dritte Feld ist der Ereignisname, unter dem das drüben erscheint. Halten Sie ihn kurz: höchstens 32 Zeichen. Das ist die Grenze der API und nicht unsere, und wir kürzen ihn beim Speichern statt beim Senden - sonst zeigte das Formular etwas anderes an, als ankommt.

3. Wann es feuert - und wann nicht

In dem Augenblick, in dem eine Sitzung erkannt wird: wenn Ihre Seite MousePlayer.setUserId() aufruft, wenn unsere Analytics-Brücke eine Kennung zurückliest, oder wenn Ihr Server den Identify-Endpunkt aufruft. Vorher wissen wir nicht, wem die Aufzeichnung gehört.

Nur mit einer E-Mail-Adresse

Alle vier Plattformen sprechen einen Kontakt über seine E-Mail an. Ist Ihre Kundenkennung eine Vertragsnummer, wird nichts gesendet - eine Aufgabe einzureihen, die nur scheitern kann, füllte bloß Ihr Protokoll.

Jedes Ereignis trägt eine Kennung

Damit dieselbe Sitzung nicht zweimal zählt, auch wenn eine Aufgabe wiederholt wird.

4. Was drüben ankommt

Ein Ereignis, das den Link zur Aufzeichnung als Eigenschaft mouseplayer_session_url trägt. Ein Klick darauf, und Sie sind in der Aufzeichnung genau dieser Sitzung.

Alles Weitere ist die Logik Ihrer Plattform: das Ereignis als Auslöser einer Automatisierung, als Segmentbedingung, oder schlicht als Weg für Ihr Team, die Aufzeichnung vom Kontakt aus zu öffnen.

Der Schlüssel verlässt unseren Server nicht

Er wird AES-256-GCM verschlüsselt gespeichert, nach dem Speichern nie wieder angezeigt, und er wandert bewusst nicht in die interne Warteschlange, die die Aufgabe trägt - der Worker holt ihn selbst aus der Datenbank.

HTTP 200 heißt nicht zugestellt

ActiveCampaign antwortet mit Status 200 und {"success":0}, wenn es ein Ereignis ablehnt. Wir lesen den Antwortrumpf und nicht nur den Status - eine Ablehnung erscheint deshalb als Fehlschlag im Zustellprotokoll und nicht als stiller Erfolg.