PostHog toevoegen aan een nieuwe app: Hier lees je hoe je PostHog en Clerk instelt en configureert

Projects

Voeg diensten toe, genereer toegangsgegevens en beheer facturatie vanuit de CLI – of laat je agent dit doen.

Meer informatie 
  1. Inleiding
  2. Belangrijkste punten
  3. Wat zijn PostHog en Clerk?
  4. Waarom zou je PostHog-analytics combineren met Clerk-auth?
  5. Hoe configureer je PostHog en Clerk handmatig?
    1. 1. Een PostHog-project maken
    2. 2. Een Clerk-toepassing maken
    3. 3. De SDK’s installeren
    4. 4. Omgevingsvariabelen instellen
    5. 5. De configuratie testen
  6. Hoe kun je door analytics-providers bladeren met Stripe Projects?
  7. Hoe voeg je PostHog en Clerk toe met Stripe Projects?
  8. Wat zijn de best practices voor PostHog en Clerk?
  9. Hoe Stripe Projects kan helpen

PostHog en Clerk aan een nieuwe app toevoegen betekent dat je twee afzonderlijke systemen configureert die verschillende problemen oplossen. Clerk regelt de gebruikersaanmelding voor de app, terwijl PostHog bijhoudt wat gebruikers doen als ze eenmaal binnen zijn. Je kunt ze handmatig configureren via de dashboards en software development kits (SDK's), of ze inrichten met Stripe Projects. Hiermee worden de inloggegevens voor beide providers rechtstreeks in het .env-bestand van je project geplaatst, zonder dat je tussen dashboards hoeft te wisselen.

PostHog wordt gebruikt door meer dan 500.000 teams en bijna 250.000 engineers. Veel teams koppelen PostHog uiteindelijk aan een authenticatieprovider, zoals Clerk. Stripe Projects vereenvoudigt die configuratie door beide diensten in één workflow in te richten.

Hieronder bespreken we wat elke provider doet, waarom het koppelen van geauthenticeerde identiteit aan analytics-events je helpt meer te begrijpen dan alleen verkeer, en hoe je PostHog en Clerk snel toevoegt met Stripe Projects.

Belangrijkste punten

  • Het koppelen van de geauthenticeerde gebruikers-ID's van Clerk aan de identify()-methode van PostHog zet anonieme sessiegegevens om in geïdentificeerde gebruikersprofielen zonder de event-geschiedenis van vóór het inloggen te verliezen.

  • Stripe Projects kan PostHog en Clerk inrichten via opdrachten voor de command-line interface (CLI) die de accountautorisatie afhandelen en inloggegevens rechtstreeks in het .env-bestand van je project schrijven.

  • Best practices voor PostHog en Clerk omvatten het overzichtelijk scheiden van omgevingen en het minimaliseren van persoonsgegevens in event-eigenschappen.

Wat zijn PostHog en Clerk?

PostHog is een platform voor product-analytics. Het volgt events, paginaweergaven en gebruikersgedrag binnen een app, en zet die gegevens vervolgens om in trechters, sessieopnamen, feature-flags en cohortanalyse. Clerk is een provider voor authenticatie en gebruikersbeheer. Deze beheert aanmeldingen, inloggen, sessietokens, multifactorauthenticatie en gegevens van gebruikersprofielen.

Waarom zou je PostHog-analytics combineren met Clerk-auth?

Door PostHog met Clerk te combineren, krijg je analytics over het verkeer aan de bovenkant van de trechter, zoals churn-voorspellingen, onboarding-analyse of feature-adoptie, opgesplitst per accountstaffel. PostHog volgt gebruikers via een specifieke ID, die begint als een anonieme, willekeurig gegenereerde identificatiecode gekoppeld aan een browser of apparaat. Wanneer een gebruiker inlogt via Clerk, kun je de identify()-methode van PostHog aanroepen en de gebruikers-ID van Clerk doorgeven als de nieuwe specifieke ID. PostHog voegt vervolgens de anonieme sessiegeschiedenis samen met het geïdentificeerde profiel, waardoor geregistreerde events van vóór het inloggen (zoals paginaweergaven, klikken op knoppen en interacties met features) aan die gebruiker worden gekoppeld.

Let goed op deze specifieke punten:

  • Consistentie in event-naamgeving: Beslis in een vroeg stadium of events in snake_case (bijv. zonder spaties) of Title Case worden geschreven, en of ze acties zoals signed\_up of objecten zoals signup\_completed beschrijven. Het door elkaar gebruiken van conventies maakt de PostHog-dashboards onleesbaar.

  • Anonieme versus geïdentificeerde gebruikers: Als je identify() aanroept bij het laden van elke pagina, verzamel je dubbele merge-events in het activiteitenlogboek van PostHog. Roep het één keer aan, direct nadat Clerk een sessie bevestigt. Je kunt de aanroep ook conditioneel maken door te controleren of de gebruiker al in de huidige sessie is geïdentificeerd.

  • Privacy en toestemming: In regio's met toestemmingsvereisten voor tracking, zoals onder de AVG in de EU, leg je toestemming vast voordat je een gebruiker identificeert of persoonsgegevens aan event-eigenschappen toevoegt. Een e-mail of naam op elk analytics-event is zelden nodig en vergroot het compliance-oppervlak.

  • Wanneer je de twee koppelt: Als de app voornamelijk uit marketingpagina's van vóór de registratie bestaat, is anonieme tracking voldoende. Koppel Clerk- en PostHog-events zodra je geauthenticeerde stromen hebt die het meten waard zijn, zoals conversie van proefversie naar betaald.

Hoe configureer je PostHog en Clerk handmatig?

Je configureert beide providers handmatig over vier systemen: twee dashboards en twee SDK's.

Zo werkt het:

1. Een PostHog-project maken

Registreer je bij PostHog en maak een project. Dit geeft je een application programming interface (API)-sleutel en host-URL voor het project. Je hebt beide waarden nodig voor de SDK.

2. Een Clerk-toepassing maken

Maak een toepassing in het Clerk-dashboard en kies de inlogmethoden, zoals e-mail, Google OAuth of passkeys.

3. De SDK's installeren

Voer npm install posthog-js en npm install @clerk/nextjs uit voor een Next.js-app. PostHog initialiseert client-side via posthog.init(), terwijl Clerk de app in een \<ClerkProvider\> wikkelt en middleware vereist om routebeveiliging af te handelen.

4. Omgevingsvariabelen instellen

Voeg vier tot zes waarden toe aan het .env.local-bestand.

5. De configuratie testen

Bevestig dat de inlogstroom van Clerk een sessie oplevert en controleer vervolgens de weergave van live events van PostHog om te bevestigen dat events doorkomen. Verifieer dat identify() precies één keer per sessie wordt geactiveerd, direct nadat de authenticatie is voltooid.

Hoe kun je door analytics-providers bladeren met Stripe Projects?

Stripe Projects is een Stripe CLI-kenmerk voor het inrichten van infrastructuurdiensten van derden, inclusief databases, analytics en AI-providers, rechtstreeks vanaf de command-line. In plaats van afzonderlijke dashboards te openen voor elke dienst, blader je er doorheen en richt je ze in vanuit één interface die is gekoppeld aan het project.

Gebruik Stripe Projects om door provideropties voor analytics te bladeren door dit uit te voeren vanuit de projectmap om beschikbare providers weer te geven, geordend per categorie en dienststaffel. Je kunt het specificeren met stripe projects catalog \<provider\> of stripe projects catalog \<category\>, of direct zoeken met stripe projects search \<keyword\>. Als je specifiek naar analytics zoekt, zie je PostHog naast andere ondersteunde providers, waardoor je de terminal niet hoeft te verlaten of naar een browser hoeft over te schakelen.

Hoe voeg je PostHog en Clerk toe met Stripe Projects?

Zodra je PostHog en Clerk hebt gekozen, zijn er twee opdrachten nodig om beide in te richten vanuit een project dat al is geïnitialiseerd met de Stripe CLI. Voer stripe projects add posthog/analytics uit om PostHog toe te voegen en de inrichtingsstroom te starten. Stripe Projects handelt de stap van de accountautorisatie af waarbij je normaal gesproken direct bij PostHog moet inloggen en sleutels handmatig moet kopiëren. Vervolgens schrijft het de resulterende API-sleutel en host-URL in het .env-bestand van je project. Het uitvoeren van stripe projects add clerk/auth doet hetzelfde voor Clerk: het beheert de autorisatiestroom en haalt de publiceerbare en geheime sleutels op. Deze worden in .env geschreven, naast wat PostHog zojuist heeft toegevoegd.

Het praktische verschil tussen configuratie met Stripe Projects en handmatige configuratie is waar de inloggegevens vandaan komen. In plaats van sleutels uit twee dashboards te kopiëren en ze in .env.local te plakken, haalt Stripe Projects ze op en schrijft ze direct, hoewel je (of je coderingsagent) nog steeds zelf de SDK-initialisatiecode schrijft en de applogica koppelt.

Je wilt ook dat de sleutels synchroon blijven. Als je het project voor de eerste keer op een nieuwe machine instelt, kloont stripe projects pull \<projectID\> het bestaande project naar een lege map en schrijft het .env-bestand, wat verbinding maakt met de bestaande diensten van het project in plaats van nieuwe in te richten. Als je al in de projectmap bent en je lokale .env moet vernieuwen nadat een teamgenoot een provider heeft toegevoegd of gerouleerd, voer dan in plaats daarvan stripe projects pull env \--pull uit.

Wat zijn de best practices voor PostHog en Clerk?

Het is de moeite waard om een paar dingen goed te regelen voordat je deze integratie lanceert.

Hier is wat je in gedachten moet houden:

  • Omgevingen overzichtelijk scheiden: Gebruik verschillende PostHog-projecten en Clerk-toepassingen voor ontwikkeling en productie. Het mengen van testaanmeldingen met echte gebruikersgegevens maakt de analytics onbetrouwbaar en vervuilt de gebruikerslijst van Clerk met wegwerpaccounts.

  • De geheime sleutel van Clerk nooit client-side blootstellen: Deze hoort uitsluitend in server-side omgevingsvariabelen. De publiceerbare sleutel is veilig voor de browser; de geheime sleutel niet.

  • Persoonsgegevens minimaliseren in event-eigenschappen: Verzend een gebruikers-ID in plaats van een e-mailadres, aangezien je met alleen de ID later de gegevens indien nodig weer kunt koppelen aan de gebruikerstabel van Clerk.

  • Toestemming respecteren vóór het identificeren van gebruikers: Als in jouw regio toestemming vereist is voor tracking, maak je de identify()-aanroep afhankelijk van die toestemming.

  • Het merge-gedrag expliciet testen: Registreer je als een anonieme gebruiker, genereer een paar events, log vervolgens in en bevestig dat PostHog die geschiedenis samenvoegt onder het geïdentificeerde profiel in plaats van een losstaand nieuw profiel te starten.

  • Het event-schema documenteren: Een gedeelde referentie voor event-namen en eigenschappen voorkomt dat verschillende delen van het team dezelfde actie onder drie verschillende namen volgen.

Hoe Stripe Projects kan helpen

Met Stripe Projects kunnen ontwikkelaars en hun AI-agents diensten toevoegen, inloggegevens genereren en facturatie beheren vanaf de command-line interface (CLI).

Stripe Projects helpt je:

  • Diensten van derden inrichten vanaf de command-line: Gebruik één workflow om diensten toe te voegen, inloggegevens te beheren en tariefplannen te upgraden, in plaats van verschillende tools en workflows voor elke provider. Beheer hosting, databases, authenticatie, AI en meer zonder dashboards, configuratiebestanden of infrastructuurcode nodig te hebben.

  • Inloggegevens automatisch synchroniseren: Houd omgevingsvariabelen overdraagbaar tussen lokale configuraties, machines, teamgenoten en agents (zonder application programming interface (API)-sleutels te hoeven kopiëren en plakken).

  • Facturatie beheren via de CLI of de coderingsagent: Stel facturatiegegevens één keer in en deel ze veilig met diensten van derden. Upgrade en downgrade staffels, houd het gebruik bij en beheer abonnementen vanuit de CLI.

Lees meer over hoe Stripe Projects de app-inrichting helpt te vereenvoudigen, of kopieer en plak deze opdracht in de terminal om vandaag nog aan de slag te gaan:

De inhoud van dit artikel is uitsluitend bedoeld voor algemene informatieve en educatieve doeleinden en mag niet worden opgevat als juridisch of fiscaal advies. Stripe verklaart of garandeert niet dat de informatie in dit artikel nauwkeurig, volledig, adequaat of actueel is. Voor aanbevelingen voor jouw specifieke situatie moet je het advies inwinnen van een bekwame, in je rechtsgebied bevoegde advocaat of accountant.

Meer artikelen

  • Er is iets misgegaan. Probeer het opnieuw of neem contact op met support.

Klaar om aan de slag te gaan?

Maak een account en begin direct met het ontvangen van betalingen. Contracten of bankgegevens zijn niet vereist. Je kunt ook contact met ons opnemen om een pakket op maat voor je onderneming samen te stellen.
Payments

Payments

Ontvang over de hele wereld online en fysieke betalingen met een betaaloplossing die past bij elke onderneming.

Documentatie voor Payments

Vind een whitepaper over de integratie van de betaal-API's van Stripe.