Einstellungen öffnen
Klicke oben rechts auf das Zahnrad-Symbol. Nur Owner und Admins können die Integration speichern; andere Rollen erhalten beim Speichern einen Fehler.
Analytics-Integration verbinden
- Wähle unter Provider aktuell PostHog — Google Analytics 4 lässt sich zwar auswählen, der Datenabruf dafür ist aber noch nicht umgesetzt.
- Trage Projekt-ID und Host ein (Standard:
eu.posthog.com, für die US-Cloudus.posthog.com). - Trage den API-Key ein (Präfix
phx_). Mehr erfahren klappt eine Kurzanleitung mit den PostHog-Schritten auf (Project Settings → API-Key, Projekt-ID aus der URL/project/[ID]). - Klicke auf Analytics speichern.
Ein bereits hinterlegter Key wird nie im Klartext angezeigt — leer lassen behält den bestehenden Key, nur eine Eingabe überschreibt ihn.
Tracked Events pflegen
- Klicke auf + Event, um eine Zeile hinzuzufügen: technischer Event-Name (z. B.
signup_completed) und Anzeige-Label. - Markiere optional, auf welchen Surfaces (App/Website/Web App) das Event zählen soll — ohne Markierung zählt es überall.
- Ab der ersten Zeile erscheint Auto-Detect: Der Button prüft die letzten 30 Tage je Surface und schlägt passende Surfaces vor.
- Klicke danach erneut auf Analytics speichern — Auto-Detect ändert nur die Ansicht, ohne Speichern geht die Zuordnung beim Schließen des Dialogs wieder verloren.
Website und Web App per URL-Muster trennen
Der Abschnitt Surface-Filter funktioniert nur mit PostHog (bei anderen Providern gesperrt mit Hinweis „PostHog erforderlich“).
- Trage unter Website-URL-Muster und/oder Web-App-URL-Muster je einen Teilstring ein, der in der URL vorkommen muss (z. B.
marketing.example.com). - Erscheinen beide Muster gleichzeitig, weist ein Hinweistext darauf hin, dass Website automatisch Web-App-URLs ausschließt, um Überschneidungen zu vermeiden.
- Klicke auf Filter speichern.
Sichtbare Reiter festlegen
Ganz unten im Dialog schaltest du jeden der acht Reiter einzeln per Kontrollkästchen sichtbar oder unsichtbar. Replays, Surveys und Live tragen ein „PH“-Kennzeichen und lassen sich nur aktivieren, solange PostHog als Provider gewählt ist.
Diese Auswahl wird nur lokal im Browser gespeichert, nicht im Profil — auf einem anderen Gerät oder in einem anderen Browser siehst du wieder die Standardauswahl.
Häufige Stolperfallen
Google Analytics 4 ist noch nicht funktionsfähig
GA4 lässt sich als Provider auswählen und speichern, der eigentliche Datenabruf ist dafür jedoch noch nicht umgesetzt. Verwende bis auf Weiteres ausschließlich PostHog.
Nur Owner und Admins können speichern
Mitglieder mit anderen Rollen sehen die Einstellungen, ein Speicherversuch schlägt jedoch fehl. Bitte in dem Fall einen Owner oder Admin der Organisation.
Auto-Detect überschreibt erst beim Speichern
Der Button aktualisiert nur die Surface-Häkchen in der Formularansicht. Ohne anschließenden Klick auf „Analytics speichern“ geht die erkannte Zuordnung beim Schließen des Dialogs wieder verloren.
Sichtbare Reiter gelten nur lokal
Die Auswahl der sichtbaren Reiter wird im Browser gespeichert (localStorage), nicht im Nutzerprofil — sie muss auf jedem Gerät und in jedem Browser einzeln eingestellt werden.
Häufige Fragen
Wer darf die Analytics-Integration einrichten?
Nur Owner und Admins der Organisation können die Integration anlegen, ändern oder Tracked Events speichern.
Sehe ich meinen gespeicherten API-Key wieder?
Nein, aus Sicherheitsgründen wird ein hinterlegter Key nie im Klartext angezeigt. Lässt du das Feld beim Speichern leer, bleibt der bestehende Key unverändert.
Warum sind Replays, Surveys und Live in den Einstellungen ausgegraut?
Diese drei Reiter sind mit dem „PH“-Kennzeichen markiert und lassen sich nur aktivieren, solange PostHog als Provider gewählt ist.
