PostHog-, Mixpanel- & Amplitude-Bridge

1. Das Problem: Zahlen ohne Gesichter

Die Produktanalyse liefert dir einen Funnel: 1.000 Nutzer haben den Checkout erreicht, 620 haben ihn abgebrochen. Das ist eine präzise Messung eines Problems, das du trotzdem nicht sehen kannst. Ein paar dieser 620 Aufzeichnungen anzusehen beantwortet die Frage meist in Minuten — aber nur, wenn du vom Diagramm zu den richtigen Sitzungen kommst, ohne IDs zu exportieren und von Hand zu suchen.

Die Produktanalyse-Bridge schließt diese Lücke. Sie läuft in mp.js und verknüpft beide Systeme automatisch:

Hinweg: Jedes Event, das dein Analyse-Tool aufzeichnet, trägt eine Eigenschaft mouseplayer_session_url. Event öffnen, Link klicken, Sitzung ansehen.
Rückweg: Die distinct_id des Besuchers wird zurückgelesen und an der MousePlayer-Sitzung gespeichert. Aufzeichnungen werden damit über dieselbe Identität auffindbar, die du in PostHog, Mixpanel oder Amplitude ohnehin nutzt.

Kein Code nötig. Die Bridge erkennt das Analyse-SDK selbst. Du rufst keine MousePlayer-Funktion auf und musst nichts an deinem Event-Tracking ändern.

2. Aktivierung

Weg A: Dashboard (ohne Code)

Öffne dein Projekt und wechsle in den Reiter Integrations.
Schalte PostHog, Mixpanel & Amplitude Bridge auf AN.
Wähle die Plattform, die du einsetzt. Änderungen werden automatisch gespeichert.

Die Einstellung greift beim nächsten Seitenaufruf deiner Website. Bereits laufende Sitzungen werden nicht rückwirkend verändert.

Weg B: Manuelle Skript-Konfiguration

Wenn du es lieber fest im Code setzt, trage die beiden Werte in window.mp_config ein:

<script> window.mp_config = { channel: 'DEINE_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' oder 'amplitude' }; </script>

3. Was pro Plattform passiert

Jede Plattform stellt eine andere API bereit, deshalb nutzt die Bridge jeweils den dort üblichen Aufruf. Konfigurieren musst du das nicht — es folgt deiner Provider-Auswahl.

Plattform	Hinweg (Replay-URL)	Rückweg (Identität)
PostHog	`posthog.register()` — als Super-Property registriert, hängt damit an jedem folgenden Event	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — gleiches Super-Property-Verhalten	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — als User-Property gesetzt	`getDeviceId()`, mit Rückfall auf `getInstance().options.deviceId` beim älteren SDK

Super-Property vs. User-Property: Bei PostHog und Mixpanel hängt die Replay-URL an allen Events ab dem Zeitpunkt der Initialisierung. Du findest sie also an jedem Event nach dem Start der Bridge — nicht an Events, die früher im Seitenaufbau bereits gesendet wurden.

4. Identität: Von der distinct_id zur benannten Sitzung

Den Rückweg unterschätzen die meisten Teams. Ohne ihn sind MousePlayer-Sitzungen anonym: Du kannst sie ansehen, aber die Frage „Zeig mir die Aufzeichnungen des Accounts, der letzte Woche gekündigt hat" nicht beantworten.

Sobald die Bridge aktiv ist, wird die distinct_id aus deinem Analyse-Tool in das Feld custom_user_id der Sitzung geschrieben — dasselbe Feld, das auch der manuelle SDK-Aufruf befüllt:

// Das manuelle Gegenstueck - bei aktiver Bridge NICHT noetig mp('set', { user_id: 'deine-interne-id' });

Wenn du mp('set') bereits selbst aufrufst, behalte das bei. Eine ausdrücklich von dir gesetzte Identität ist die verlässlichere, weil sie dein eigener Primärschlüssel ist und nicht eine browserbezogene Analyse-Kennung.

Datenschutzhinweis: Übertragen wird ausschließlich die Kennung, die dein Analyse-Tool ohnehin schon vergeben hat. Es werden keine E-Mail-Adressen, Namen oder sonstigen personenbezogenen Felder aus dem SDK ausgelesen. Achte darauf, dass deine Datenschutzerklärung diese Verarbeitung abdeckt, und binde das Tracking-Skript hinter deinem Consent-Tool ein, wenn du dich auf Einwilligung als Rechtsgrundlage stützt.

5. Technisches Verhalten

Analyse-SDKs werden meist asynchron geladen, oft erst nachdem mp.js bereits läuft. Ein einzelner Versuch beim Start würde deshalb auf den meisten echten Websites fehlschlagen.

Die Bridge versucht es alle 1,5 Sekunden, bis zu zehnmal, und hört auf, sobald beide Richtungen erledigt sind.
Beide Richtungen werden unabhängig voneinander abgeschlossen. Die Replay-URL wird also nicht doppelt gesendet, während noch auf eine Identität gewartet wird.
Erscheint das SDK nie, gibt die Bridge nach rund 15 Sekunden still auf. Es landet nichts in der Konsole, und die Sitzungsaufzeichnung läuft unverändert weiter.
Kennungen mit mehr als 128 Zeichen werden verworfen statt gekürzt — eine halbe Kennung würde später ohnehin zu keinem Treffer führen.

6. Funktionsprüfung

Öffne deine Website in einem normalen Browser-Tab und interagiere kurz mit ihr.
Öffne in deinem Analyse-Tool das neueste Event und suche die Eigenschaft mouseplayer_session_url. Ein Klick darauf sollte direkt zur Aufzeichnung führen.
Öffne in MousePlayer den User Explorer. Sitzungen mit Identität zeigen diese anstelle des generierten Besucher-Spitznamens.

Wenn nichts erscheint

Die Eigenschaft fehlt an allen Events: Prüfe, ob das Analyse-SDK auf der Seite wirklich geladen wird und ob du die passende Plattform ausgewählt hast. Eine PostHog-Auswahl liest kein Mixpanel aus.
Die Eigenschaft taucht erst an späteren Events auf: Das ist so erwartet, siehe Hinweis in Abschnitt 3.
Die URL ist da, die Identität nicht: Dein SDK hat noch keine distinct_id vergeben. Das ist normal, solange kein Nutzer identifiziert wurde, und wird bei einem späteren Seitenaufruf nachgeholt.
Du testest als eingeloggter Administrator: Manche Setups schließen internen Traffic aus. Probiere ein privates Fenster.

Wie können wir helfen?