Das Hinzufügen von PostHog und Clerk zu einer neuen App umfasst die Einrichtung zweier separater Systeme, die unterschiedliche Probleme lösen. Clerk übernimmt die Nutzeranmeldung bei Ihrer App, während PostHog nachverfolgt, was Nutzende nach der Anmeldung tun. Sie können sie manuell über ihre Dashboards und Software Development Kits (SDKs) konfigurieren oder sie mit Stripe Projects bereitstellen, wodurch die Anmeldeinformationen für beide Anbieter direkt in die Datei .env Ihres Projekts abgerufen werden, ohne dass Sie zwischen Dashboards wechseln müssen.
PostHog wird von mehr als 500.000 Teams und fast 250.000 Personen in der Softwareentwicklung genutzt. Viele Teams kombinieren PostHog schließlich mit einem Authentifizierungsanbieter wie Clerk. Stripe Projects vereinfacht diese Einrichtung, indem es beide Dienste in einem einzigen Workflow bereitstellt.
Im Folgenden gehen wir darauf ein, was die einzelnen Anbieter leisten, warum die Verknüpfung einer authentifizierten Identität mit Analytics-Ereignissen Ihnen hilft, mehr als nur den reinen Traffic zu verstehen, und wie Sie PostHog und Clerk mithilfe von Stripe Projects schnell hinzufügen.
Das Wichtigste auf einen Blick
Die Verknüpfung der authentifizierten Nutzer-IDs von Clerk mit der Methode
identify()von PostHog wandelt anonyme Sitzungsdaten in identifizierte Nutzerprofile um, ohne dass der Ereignisverlauf vor der Anmeldung verloren geht.Stripe Projects kann PostHog und Clerk über Befehle auf der Befehlszeilenschnittstelle (CLI) bereitstellen, die die Kontoautorisierung übernehmen und die Anmeldeinformationen direkt in die Datei
.envIhres Projekts schreiben.Zu den Best Practices für PostHog und Clerk gehören die saubere Trennung von Umgebungen und die Minimierung personenbezogener Daten in den Ereigniseigenschaften.
Was sind PostHog und Clerk?
PostHog ist eine Produkt-Analytics-Plattform. Sie erfasst Ereignisse, Seitenaufrufe und das Nutzerverhalten in einer App und wandelt diese Daten dann in Funnel, Sitzungsaufzeichnungen, Feature Flags und Kohortenanalysen um. Clerk ist ein Anbieter für Authentifizierung und Nutzermanagement. Er übernimmt die Registrierung, die Anmeldung, Sitzungstoken, die Multi-Faktor-Authentifizierung und Nutzerprofildaten.
Warum sollten Sie PostHog-Analytics mit Clerk-Authentifizierung kombinieren?
Die Kombination von PostHog und Clerk liefert Ihnen Analytics über Top-of-Funnel-Traffic wie Abwanderungsprognosen, Onboarding-Analysen oder Feature-Adoption, aufgeschlüsselt nach Kontostufe. PostHog erfasst Nutzende über eine eindeutige ID, die als anonymer, zufällig generierter Bezeichner beginnt, der an einen Browser oder ein Gerät gebunden ist. Wenn eine Anmeldung über Clerk erfolgt, können Sie die Methode identify() von PostHog aufrufen und die Nutzer-ID von Clerk als neue eindeutige ID übergeben. PostHog führt dann den anonymen Sitzungsverlauf mit dem identifizierten Profil zusammen und verknüpft nachverfolgte Ereignisse vor der Anmeldung – wie Seitenaufrufe, Klicks auf Schaltflächen und Feature-Interaktionen – mit dieser Person.
Achten Sie genau auf diese Besonderheiten:
Konsistenz bei der Benennung von Ereignissen: Entscheiden Sie frühzeitig, ob Ereignisse im Snake Case (z. B. ohne Leerzeichen) oder Title Case geschrieben werden, und ob sie Aktionen wie
signed\_upoder Objekte wiesignup\_completedbeschreiben. Die Vermischung von Konventionen macht Ihre PostHog-Dashboards unlesbar.Anonyme vs. identifizierte Nutzende: Wenn Sie bei jedem Laden der Seite
identify()aufrufen, sammeln Sie im Aktivitätsprotokoll von PostHog doppelte Zusammenführungsereignisse an. Rufen Sie die Methode nur einmal auf, direkt nachdem Clerk eine Sitzung bestätigt hat. Sie können den Aufruf auch an eine Prüfung knüpfen, ob die Identifizierung in der aktuellen Sitzung bereits erfolgt ist.Datenschutz und Einwilligung: In Zuständigkeitsbereichen mit Einwilligungspflichten für die Nachverfolgung, wie z. B. gemäß DSGVO in der EU, müssen Sie die Einwilligung einholen, bevor Sie eine Person identifizieren oder personenbezogene Daten an Ereigniseigenschaften anhängen. Eine E-Mail-Adresse oder ein Name ist bei jedem Analytics-Ereignis selten erforderlich und vergrößert Ihre Compliance-Angriffsfläche.
Wann Sie beides verbinden sollten: Wenn Ihre App hauptsächlich aus Marketingseiten vor der Registrierung besteht, reicht ein anonymes Tracking aus. Verknüpfen Sie Ereignisse von Clerk und PostHog, sobald Sie über authentifizierte Flows verfügen, die es wert sind, gemessen zu werden, wie z. B. die Conversion von der Testversion zum kostenpflichtigen Abonnement.
Wie konfigurieren Sie PostHog und Clerk manuell?
Sie konfigurieren beide Anbieter manuell über vier Systeme: zwei Dashboards und zwei SDKs.
Sehen wir uns das näher an:
1. Erstellen Sie ein PostHog-Projekt
Registrieren Sie sich bei PostHog und erstellen Sie ein Projekt. Dadurch erhalten Sie einen projektbezogenen Application Programming Interface (API)-Schlüssel sowie eine Host-URL. Sie benötigen beide Werte für das SDK.
2. Eine Clerk-Anwendung erstellen
Erstellen Sie im Clerk-Dashboard eine Anwendung und wählen Sie Ihre Anmeldemethoden aus, z. B. E-Mail, Google OAuth oder Passkeys.
3. Installieren Sie die SDKs
Führen Sie npm install posthog-js und npm install @clerk/nextjs für eine Next.js-App aus. PostHog initialisiert sich clientseitig über posthog.init(), während Clerk Ihre App in \<ClerkProvider\> einbettet und Middleware erfordert, um den Routenschutz abzuwickeln.
4. Legen Sie Umgebungsvariablen fest
Fügen Sie Ihrer Datei .env.local vier bis sechs Werte hinzu.
5. Testen Sie die Einrichtung
Bestätigen Sie, dass der Anmeldeflow von Clerk eine Sitzung erzeugt, und prüfen Sie dann die Live-Ereignisansicht von PostHog, um sicherzustellen, dass die Ereignisse eingehen. Verifizieren Sie, dass identify() genau einmal pro Sitzung ausgelöst wird, und zwar unmittelbar nach Abschluss der Authentifizierung.
Wie können Sie Analytics-Anbieter mit Stripe Projects durchsuchen?
Stripe Projects ist eine Stripe-CLI-Funktion zur Bereitstellung von Infrastrukturdiensten von Drittanbietern, einschließlich Datenbanken, Analytics- und KI-Anbietern, direkt über die Befehlszeile. Anstatt für jeden Dienst separate Dashboards zu öffnen, durchsuchen und stellen Sie diese über eine einzige, mit Ihrem Projekt verknüpfte Oberfläche bereit.
Verwenden Sie Stripe Projects, um die Anbieteroptionen für Analytics zu durchsuchen. Führen Sie es von Ihrem Projektverzeichnis aus, um verfügbare Anbieter aufzulisten, die nach Kategorie und Dienststufe organisiert sind. Sie können die Suche mit stripe projects catalog \<provider\> oder stripe projects catalog \<category\> eingrenzen oder direkt mit stripe projects search \<keyword\> suchen. Wenn Sie speziell nach Analytics suchen, wird PostHog neben anderen unterstützten Anbietern angezeigt, sodass Sie weder Ihr Terminal verlassen noch in einen Browser wechseln müssen.
Wie fügen Sie PostHog und Clerk mit Stripe Projects hinzu?
Sobald Sie sich für PostHog und Clerk entschieden haben, genügen zwei Befehle, um beide aus einem Projekt bereitzustellen, das bereits mit der Stripe-CLI initialisiert wurde. Führen Sie zum Hinzufügen von PostHog stripe projects add posthog/analytics aus, um den Bereitstellungsflow zu starten. Stripe Projects übernimmt den Kontoautorisierungsschritt, für den Sie sich normalerweise direkt bei PostHog anmelden und die Schlüssel manuell kopieren müssten. Anschließend schreibt es den resultierenden API-Schlüssel und die Host-URL in die Datei .env Ihres Projekts. Die Ausführung von stripe projects add clerk/auth erledigt dasselbe für Clerk: Es verwaltet den Autorisierungsflow und ruft die veröffentlichbaren Schlüssel sowie die Geheimschlüssel ab. Diese werden neben den gerade von PostHog hinzugefügten Daten in .env geschrieben.
Der praktische Unterschied zwischen der Einrichtung mit Stripe Projects und der manuellen Einrichtung liegt in der Herkunft der Anmeldeinformationen. Anstatt Schlüssel aus zwei Dashboards zu kopieren und in .env.local einzufügen, ruft Stripe Projects diese direkt ab und schreibt sie, auch wenn Sie (oder Ihr Coding-Agent) den SDK-Initialisierungscode weiterhin selbst schreiben und Ihre App-Logik eigenständig verknüpfen.
Sie sollten Ihre Schlüssel auch synchron halten. Wenn Sie das Projekt zum ersten Mal auf einem neuen Rechner einrichten, klont stripe projects pull \<projectID\> das vorhandene Projekt in ein leeres Verzeichnis und schreibt Ihre Datei .env, wodurch eine Verbindung zu den vorhandenen Diensten des Projekts hergestellt wird, anstatt neue bereitzustellen. Wenn Sie sich bereits im Projektverzeichnis befinden und Ihre lokale .env aktualisieren müssen, nachdem ein Teammitglied einen Anbieter hinzugefügt oder rotiert hat, führen Sie stattdessen stripe projects pull env \--pull aus.
Was sind die Best Practices für PostHog und Clerk?
Es gibt einige Aspekte, die Sie beachten sollten, bevor Sie diese Integration veröffentlichen.
Das sollten Sie beachten:
Umgebungen sauber trennen: Verwenden Sie für Entwicklung und Produktion unterschiedliche PostHog-Projekte und Clerk-Anwendungen. Die Vermischung von Testregistrierungen mit echten Nutzerdaten macht Ihre Analytics unzuverlässig und überfrachtet Ihre Clerk-Nutzerliste mit Wegwerfkonten.
Den Clerk-Geheimschlüssel niemals clientseitig offenlegen: Er gehört ausschließlich in serverseitige Umgebungsvariablen. Der veröffentlichbare Schlüssel ist für den Browser sicher, der Geheimschlüssel hingegen nicht.
Personenbezogene Daten in Ereigniseigenschaften minimieren: Senden Sie lieber eine Nutzer-ID als eine E-Mail-Adresse, da Sie anhand der ID allein die Daten bei Bedarf später wieder mit der Nutzertabelle von Clerk verknüpfen können.
Einwilligung vor der Identifizierung von Nutzenden respektieren: Wenn Ihr Zuständigkeitsbereich eine Einwilligung zur Nachverfolgung erfordert, knüpfen Sie den Aufruf von
identify()an diese Einwilligung.Das Zusammenführungsverhalten explizit testen: Registrieren Sie sich anonym, generieren Sie ein paar Ereignisse, melden Sie sich dann an und bestätigen Sie, dass PostHog diesen Verlauf unter dem identifizierten Profil zusammenführt, anstatt ein separates neues Profil zu starten.
Ihr Ereignisschema dokumentieren: Eine gemeinsame Referenz für Ereignisnamen und Eigenschaften verhindert, dass verschiedene Teile Ihres Teams dieselbe Aktion unter drei unterschiedlichen Namen nachverfolgen.
Wie Stripe Projects helfen kann
Stripe Projects ermöglicht es Entwicklungsteams und ihren KI-Agenten, Dienste hinzuzufügen, Anmeldeinformationen zu generieren und die Abrechnung über die Befehlszeilenschnittstelle (CLI) zu verwalten.
Mit Stripe Projects können Sie Folgendes umsetzen:
Dienste von Drittanbietern über die Befehlszeile bereitstellen: Nutzen Sie einen einzigen Workflow zum Hinzufügen von Diensten, Verwalten von Anmeldeinformationen und für das Upgrade von Plänen, anstatt verschiedene Tools und Workflows für jeden Anbieter zu verwenden. Verwalten Sie Hosting, Datenbanken, Autorisierung, KI und mehr, ohne Dashboards, Konfigurationsdateien oder Infrastrukturcode zu benötigen.
Anmeldeinformationen automatisch synchronisieren: Halten Sie Umgebungsvariablen über lokale Setups, Rechner, Teammitglieder und Agenten hinweg übertragbar – kein Kopieren und Einfügen von Application Programming Interface (API)-Schlüsseln.
Die Abrechnung über die CLI oder Ihren Coding-Agenten verwalten: Richten Sie die Abrechnungsdetails einmalig ein und teilen Sie sie sicher mit Drittanbieterdiensten. Sie können über die CLI Upgrades und Downgrades von Stufen vornehmen, die Nutzung überwachen und Abonnements verwalten.
Erfahren Sie mehr darüber, wie Stripe Projects die Bereitstellung von Apps vereinfacht, oder kopieren Sie diesen Befehl und fügen Sie ihn in Ihr Terminal ein, um noch heute loszulegen:
Der Inhalt dieses Artikels dient nur zu allgemeinen Informations- und Bildungszwecken und sollte nicht als Rechts- oder Steuerberatung interpretiert werden. Stripe übernimmt keine Gewähr oder Garantie für die Richtigkeit, Vollständigkeit, Angemessenheit oder Aktualität der Informationen in diesem Artikel. Sie sollten den Rat eines in Ihrem steuerlichen Zuständigkeitsbereich zugelassenen kompetenten Rechtsbeistands oder von einer Steuerberatungsstelle einholen und sich hinsichtlich Ihrer speziellen Situation beraten lassen.