Att lägga till PostHog och Clerk i en ny app innebär att man konfigurerar två separata system som löser olika problem. Clerk hanterar användarinloggningen i din app, medan PostHog spårar vad användare gör när de väl är inloggade. Du kan konfigurera dem manuellt via deras dashboards och Software Development Kits (SDK:er), eller tillhandahålla dem med Stripe Projects, som hämtar autentiseringsuppgifter för båda leverantörerna direkt till ditt projekts .env-fil utan att du behöver hoppa mellan olika dashboards.
PostHog används av fler än 500 000 team och nästan 250 000 utvecklare. Många team kommer så småningom att para ihop PostHog med en autentiseringsleverantör, såsom Clerk. Stripe Projects förenklar denna installation genom att tillhandahålla båda tjänsterna i ett enda arbetsflöde.
Nedan diskuterar vi vad varje leverantör gör, varför anslutning av en autentiserad identitet till analyshändelser hjälper dig att förstå mer än bara trafik, och hur du snabbt lägger till PostHog och Clerk med Stripe Projects.
Viktiga lärdomar
Genom att ansluta Clerks autentiserade användaridentifierare (ID:n) till PostHogs
identify()-metod omvandlas anonym sessionsdata till identifierade användarprofiler utan att händelsehistoriken före inloggningen går förlorad.Stripe Projects kan tillhandahålla PostHog och Clerk via kommandoradsgränssnittskommandon (CLI) som hanterar kontoauktorisering och skriver autentiseringsuppgifter direkt till ditt projekts
.env-fil.Bästa praxis för PostHog och Clerk inkluderar att separera miljöer tydligt och minimera personuppgifter i händelseegenskaper.
Vad är PostHog och Clerk?
PostHog är en plattform för produktanalys. Den spårar händelser, sidvisningar och användarbeteende i en app och omvandlar sedan den informationen till trattar, sessionsinspelningar, funktionsflaggor och kohortanalys. Clerk är en leverantör av autentisering och användarhantering. Den hanterar registrering, inloggning, sessionstokens, multifaktorautentisering och användarprofildata.
Varför ska du kombinera PostHog-analys med Clerk-autentisering?
Genom att kombinera PostHog med Clerk får du analys av trafik i toppen av tratten, som prediktion av kundbortfall, onboarding-analys eller funktionsanvändning, uppdelat efter kontonivå. PostHog spårar användare via ett distinkt ID som börjar som en anonym, slumpmässigt genererad identifierare kopplad till en webbläsare eller enhet. När en användare loggar in via Clerk kan du anropa PostHogs identify()-metod och skicka Clerks användar-id som det nya distinkta ID:t. PostHog slår sedan samman den anonyma sessionshistoriken med den identifierade profilen och kopplar spårade händelser före inloggningen – som sidvisningar, knappklick och funktionsinteraktioner – till den användaren.
Var särskilt uppmärksam på dessa detaljer:
Konsekvent namngivning av händelser: Bestäm tidigt om händelser ska ha snake case (t.ex. utan mellanslag) eller versaler i början av varje ord (title case), och om de beskriver åtgärder som
signed\_upeller objekt somsignup\_completed. Att blanda konventioner gör dina PostHog-dashboards oläsliga.Anonyma jämfört med identifierade användare: Om du anropar
identify()vid varje sidladdning kommer du att samla på dig duplicerade sammanslagningshändelser i PostHogs aktivitetslogg. Anropa den en gång, direkt efter att Clerk bekräftar en session. Du kan också låsa anropet bakom en kontroll för att se om användaren redan har identifierats i den aktuella sessionen.Integritet och samtycke: I jurisdiktioner med krav på samtycke för spårning, som under GDPR i EU, måste du inhämta samtycke innan du identifierar en användare eller kopplar personuppgifter till händelseegenskaper. En e-postadress eller ett namn för varje analyshändelse är sällan nödvändigt och breddar din efterlevnadsyta.
När man ska ansluta de två: Om din app huvudsakligen består av marknadsföringssidor före registrering täcker anonym spårning dina behov. Anslut Clerk- och PostHog-händelser när du har autentiserade flöden värda att mäta, såsom konvertering från provperiod till betalande.
Hur konfigurerar du PostHog och Clerk manuellt?
Du konfigurerar båda leverantörerna manuellt över fyra system: två dashboards och två SDK:er.
Så här fungerar det:
1. Skapa ett PostHog-projekt
Registrera dig på PostHog och skapa ett projekt. Detta ger dig en API-nyckel (Application Programming Interface) för projektet och en värd-URL. Du behöver båda värdena för SDK:n.
2. Skapa en Clerk-applikation
I Clerk-dashboarden skapar du en applikation och väljer dina inloggningsmetoder, såsom e-post, Google OAuth eller lösenordsnycklar (passkeys).
3. Installera SDK:erna
Kör npm install posthog-js och npm install @clerk/nextjs för en Next.js-app. PostHog initieras på klientsidan via posthog.init(), medan Clerk omsluter din app i en \<ClerkProvider\> och kräver middleware för att hantera ruttskydd.
4. Ställ in miljövariabler
Lägg till fyra till sex värden i din .env.local-fil.
5. Testa installationen
Bekräfta att Clerks inloggningsflöde skapar en session och kontrollera sedan PostHogs vy för livehändelser för att bekräfta att händelser kommer igenom. Verifiera att identify() utlöses exakt en gång per session, direkt efter att autentiseringen har slutförts.
Hur kan du bläddra bland analysleverantörer med Stripe Projects?
Stripe Projects är en Stripe CLI-funktion för att tillhandahålla tredjepartstjänster för infrastruktur, inklusive databaser, analys och AI-leverantörer, direkt från kommandoraden. Istället för att öppna separata dashboards för varje tjänst kan du bläddra bland och tillhandahålla dem från ett enda gränssnitt kopplat till ditt projekt.
Använd Stripe Projects för att bläddra bland leverantörsalternativ för analys genom att köra det från din projektkatalog för att lista tillgängliga leverantörer, organiserade efter kategori och tjänstenivå. Du kan begränsa det med stripe projects catalog \<provider\> eller stripe projects catalog \<category\>, eller söka direkt med stripe projects search \<keyword\>. Om du letar specifikt efter analys kommer du att se PostHog tillsammans med andra leverantörer som stöds, vilket eliminerar behovet av att lämna din terminal eller byta till en webbläsare.
Hur lägger du till PostHog och Clerk med Stripe Projects?
När du har valt PostHog och Clerk krävs det två kommandon för att tillhandahålla båda från ett projekt som redan har initierats med Stripe CLI. För att lägga till PostHog kör du stripe projects add posthog/analytics för att starta tillhandahållandeflödet. Stripe Projects hanterar kontoauktoriseringssteget som normalt skulle kräva att du loggar in på PostHog direkt och kopierar nycklar manuellt. Det skriver sedan den resulterande API-nyckeln och värd-URL:en till ditt projekts .env-fil. Att köra stripe projects add clerk/auth gör detsamma för Clerk: det hanterar auktoriseringsflödet och hämtar de publicerbara och hemliga nycklarna. Dessa skrivs till .env tillsammans med det som PostHog just lade till.
Den praktiska skillnaden mellan installation med Stripe Projects och manuell installation är var autentiseringsuppgifterna kommer ifrån. Istället för att kopiera nycklar från två dashboards och klistra in dem i .env.local hämtar och skriver Stripe Projects dem direkt, även om du (eller din kodningsagent) fortfarande skriver SDK-initieringskoden och kopplar ihop din applogik själv.
Du vill också hålla dina nycklar synkroniserade. Om du ställer in projektet på en ny maskin för första gången klonar stripe projects pull \<projectID\> det befintliga projektet till en tom katalog och skriver din .env-fil, som ansluter till projektets befintliga tjänster istället för att tillhandahålla nya. Om du redan befinner dig i projektkatalogen och behöver uppdatera din lokala .env efter att en lagkamrat har lagt till eller roterat en leverantör, kör du stripe projects pull env \--pull istället.
Vilka är bästa praxis för PostHog och Clerk?
Några saker är värda att få rätt innan du lanserar denna integration.
Här är vad du ska tänka på:
Separera miljöer tydligt: Använd olika PostHog-projekt och Clerk-applikationer för utveckling och produktion. Att blanda testregistreringar med riktig användardata gör din analys opålitlig och rör till din Clerk-användarlista med engångskonton.
Exponera aldrig Clerks hemliga nyckel på klientsidan: Den hör endast hemma i miljövariabler på serversidan. Den publicerbara nyckeln är säker för webbläsaren; den hemliga nyckeln är det inte.
Minimera personuppgifter i händelseegenskaper: Skicka ett användar-id istället för en e-postadress, eftersom enbart ID:t låter dig koppla data tillbaka till Clerks användartabell senare om du behöver det.
Respektera samtycke innan du identifierar användare: Om din jurisdiktion kräver samtycke för spårning måste du låsa
identify()-anropet bakom det samtycket.Testa sammanslagningsbeteendet uttryckligen: Registrera dig som en anonym användare, generera några händelser, logga sedan in och bekräfta att PostHog slår samman den historiken under den identifierade profilen istället för att starta en ny frånkopplad.
Dokumentera ditt händelseschema: En gemensam referens för händelsenamn och egenskaper hindrar olika delar av ditt team från att spåra samma åtgärd under tre olika namn.
Hur Stripe Projects kan hjälpa till
Stripe Projects låter utvecklare och deras AI-agenter lägga till tjänster, generera autentiseringsuppgifter och hantera fakturering från kommandoradsgränssnittet (CLI).
Stripe Projects hjälper dig att:
Tillhandahålla tredjepartstjänster från kommandoraden: Använd ett arbetsflöde för att lägga till tjänster, hantera autentiseringsuppgifter och uppgradera planer, istället för olika verktyg och arbetsflöden för varje leverantör. Hantera värdtjänster, databaser, autentisering, AI och mer utan att behöva dashboards, konfigurationsfiler eller infrastrukturkod.
Synkronisera autentiseringsuppgifter automatiskt: Håll miljövariabler portabla över lokala installationer, maskiner, lagkamrater och agenter – ingen kopiering och inklistring av API-nycklar (Application Programming Interface).
Hantera fakturering från CLI eller din kodningsagent: Ställ in faktureringsuppgifter en gång och dela dem säkert med tredjepartstjänster. Uppgradera och nedgradera nivåer, övervaka användning och hantera prenumerationer från CLI.
Läs mer om hur Stripe Projects hjälper till att förenkla apptillhandahållande, eller kopiera och klistra in detta kommando i din terminal för att komma igång idag:
Innehållet i den här artikeln är endast avsett för allmän information och utbildningsändamål och ska inte tolkas som juridisk eller skatterelaterad rådgivning. Stripe garanterar inte att informationen i artikeln är korrekt, fullständig, adekvat eller aktuell. Du bör söka råd från en kompetent advokat eller revisor som är licensierad att praktisera i din jurisdiktion för råd om din specifika situation.