L’ajout de PostHog et de Clerk à une nouvelle application implique la configuration de deux systèmes distincts qui résolvent des problèmes différents. Clerk gère la connexion des utilisateurs à votre application, tandis que PostHog fait le suivi de ce que les utilisateurs font une fois à l’intérieur. Vous pouvez les configurer manuellement au moyen de leurs tableaux de bord et de leurs trousses SDK, ou les provisionner à l’aide de Stripe Projects, qui extrait les identifiants des deux fournisseurs directement dans le fichier .env de votre projet sans que vous ayez à passer d’un tableau de bord à l’autre.
PostHog est utilisé par plus de 500 000 équipes et près de 250 000 spécialistes en ingénierie. De nombreuses équipes finiront par associer PostHog à un fournisseur d’authentification, comme Clerk. Stripe Projects simplifie cette configuration en provisionnant les deux services dans un flux de travail unique.
Ci-dessous, nous aborderons ce que fait chaque fournisseur, pourquoi l’association d’une identité authentifiée aux événements d’analyse vous aide à comprendre plus que le simple trafic, et comment ajouter PostHog et Clerk rapidement à l’aide de Stripe Projects.
Points à retenir
L’association des identifiants d’utilisateurs (ID) authentifiés de Clerk à la méthode
identify()de PostHog transforme les données de session anonymes en profils d’utilisateurs identifiés sans perdre l’historique des événements précédant la connexion.Stripe Projects peut provisionner PostHog et Clerk au moyen de commandes de l’interface de ligne de commande (CLI) qui gèrent l’autorisation des comptes et écrivent les identifiants directement dans le fichier
.envde votre projet.Les bonnes pratiques relatives à PostHog et à Clerk incluent la séparation nette des environnements et la minimisation des données personnelles dans les propriétés des événements.
Que sont PostHog et Clerk ?
PostHog est une plateforme d’analyse de produits. Elle fait le suivi des événements, des pages vues et du comportement des utilisateurs dans une application, puis transforme ces données en entonnoirs, en enregistrements de session, en indicateurs de fonctionnalités et en analyse de cohorte. Clerk est un fournisseur d’authentification et de gestion des utilisateurs. Il gère l’inscription, la connexion, les jetons de session, l’authentification multifacteur et les données de profils d’utilisateurs.
Pourquoi devriez-vous combiner les analyses PostHog à l’authentification Clerk?
La combinaison de PostHog et de Clerk vous fournit des analyses sur le trafic au début de l’entonnoir, comme la prédiction de la résiliation, l’analyse de l’inscription des utilisateurs ou l’adoption des fonctionnalités, réparties par niveau de compte. PostHog fait le suivi des utilisateurs au moyen d’un ID distinct, qui commence comme un identifiant anonyme généré de manière aléatoire et lié à un navigateur ou à un appareil. Lorsqu’un utilisateur se connecte au moyen de Clerk, vous pouvez appeler la méthode identify() de PostHog et transmettre l’ID d’utilisateur de Clerk comme nouvel ID distinct. PostHog fusionne alors l’historique de session anonyme avec le profil identifié, associant les événements suivis avant la connexion – comme les pages vues, les clics sur des boutons et les interactions avec les fonctionnalités – à cet utilisateur.
Portez une attention particulière à ces points précis :
Cohérence de la nomenclature des événements : Décidez tôt si les événements utilisent la casse « snake case » (par exemple, sans espaces) ou la casse de titre, et s’ils décrivent des actions comme
signed\_upou des objets commesignup\_completed. Le mélange des conventions rend vos tableaux de bord PostHog illisibles.Utilisateurs anonymes par rapport aux utilisateurs identifiés : Si vous appelez
identify()à chaque chargement de page, vous accumulerez des événements de fusion en double dans le journal d’activité de PostHog. Appelez-la une seule fois, juste après que Clerk confirme une session. Vous pouvez également conditionner l’appel à une vérification visant à déterminer si l’utilisateur a déjà été identifié dans la session en cours.Confidentialité et consentement : Dans les territoires exigeant un consentement pour le suivi, comme en vertu du RGPD dans l’UE, obtenez le consentement avant d’identifier un utilisateur ou de joindre des données personnelles aux propriétés de l’événement. Un courriel ou un nom sur chaque événement d’analyse est rarement nécessaire et élargit votre surface de conformité.
Quand connecter les deux : Si votre application se compose principalement de pages de marketing préalables à l’inscription, le suivi anonyme est suffisant. Connectez les événements Clerk et PostHog une fois que vous avez des flux authentifiés valant la peine d’être mesurés, comme la conversion d’un essai à un abonnement payant.
Comment configurer PostHog et Clerk manuellement ?
Vous configurerez manuellement les deux fournisseurs dans quatre systèmes : deux tableaux de bord et deux trousses SDK.
Voici comment cela fonctionne :
1. Création d’un projet PostHog
Inscrivez-vous sur PostHog et créez un projet. Cela vous donne une clé d’API (interface de programmation d’application) de projet et une URL d’hôte. Vous aurez besoin des deux valeurs pour la trousse SDK.
2. Création d’une application Clerk
Dans le tableau de bord Clerk, créez une application et choisissez vos méthodes de connexion, comme le courriel, Google OAuth ou les clés d’accès.
3. Installation des trousses SDK
Exécutez npm install posthog-js et npm install @clerk/nextjs pour une application Next.js. PostHog s’initialise côté client au moyen de posthog.init(), tandis que Clerk enveloppe votre application dans un \<ClerkProvider\> et nécessite un intergiciel pour gérer la protection des routes.
4. Définition des variables d’environnement
Ajoutez de quatre à six valeurs à votre fichier .env.local.
5. Mise à l’essai de la configuration
Confirmez que le flux de connexion de Clerk produit une session, puis vérifiez la vue des événements en direct de PostHog pour confirmer que les événements sont bien transmis. Vérifiez que identify() se déclenche exactement une fois par session, juste après la résolution de l’authentification.
Comment parcourir les fournisseurs d’analyses avec Stripe Projects ?
Stripe Projects est une fonctionnalité de l’interface de ligne de commande (CLI) de Stripe permettant de provisionner des services d’infrastructure tiers, y compris des bases de données, des analyses et des fournisseurs d’IA, directement à partir de la ligne de commande. Au lieu d’ouvrir des tableaux de bord distincts pour chaque service, vous les parcourez et les provisionnez à partir d’une seule interface liée à votre projet.
Utilisez Stripe Projects pour parcourir les options de fournisseurs d’analyses en l’exécutant à partir de votre répertoire de projet pour répertorier les fournisseurs disponibles, organisés par catégorie et par niveau de service. Vous pouvez affiner la liste avec stripe projects catalog \<provider\> ou stripe projects catalog \<category\>, ou faire une recherche directe avec stripe projects search \<keyword\>. Si vous recherchez spécifiquement des analyses, vous verrez PostHog aux côtés d’autres fournisseurs pris en charge, ce qui élimine le besoin de quitter votre terminal ou de passer à un navigateur.
Comment ajouter PostHog et Clerk avec Stripe Projects ?
Une fois que vous avez choisi PostHog et Clerk, il faut deux commandes pour provisionner les deux à partir d’un projet déjà initialisé avec l’interface de ligne de commande (CLI) de Stripe. Pour ajouter PostHog, exécutez stripe projects add posthog/analytics pour démarrer le flux de provisionnement. Stripe Projects gère l’étape d’autorisation de compte qui vous obligerait normalement à vous connecter directement à PostHog et à copier les clés manuellement. Il écrit ensuite la clé d’API et l’URL d’hôte obtenues dans le fichier .env de votre projet. L’exécution de stripe projects add clerk/auth fait la même chose pour Clerk : il gère le flux d’autorisation et récupère les clés publiables et secrètes. Celles-ci sont écrites dans le fichier .env aux côtés de ce que PostHog vient d’ajouter.
La différence pratique entre la configuration avec Stripe Projects et la configuration manuelle réside dans la provenance des identifiants. Au lieu de copier les clés à partir de deux tableaux de bord et de les coller dans le fichier .env.local, Stripe Projects les récupère et les écrit directement, bien que vous (ou votre agent de codage) écriviez toujours le code d’initialisation de la trousse SDK et que vous connectiez vous-même la logique de votre application.
Vous voudrez également garder vos clés synchronisées. Si vous configurez le projet sur un nouvel ordinateur pour la première fois, stripe projects pull \<projectID\> clone le projet existant dans un répertoire vide et écrit votre fichier .env, qui se connecte aux services existants du projet plutôt que d’en provisionner de nouveaux. Si vous êtes déjà dans le répertoire du projet et que vous devez actualiser votre fichier .env local après qu’un ou une collègue a ajouté ou effectué la rotation d’un fournisseur, exécutez plutôt stripe projects pull env \--pull.
Quelles sont les bonnes pratiques pour PostHog et Clerk ?
Quelques points méritent d’être bien exécutés avant de mettre cette intégration en production.
Voici ce qu’il faut garder à l’esprit :
Séparez nettement les environnements : Utilisez des projets PostHog et des applications Clerk différents pour le développement et la production. Le mélange d’inscriptions de test avec des données d’utilisateurs réels rend vos analyses peu fiables et encombre votre liste d’utilisateurs Clerk de comptes jetables.
N’exposez jamais la clé secrète Clerk côté client : Elle ne doit figurer que dans les variables d’environnement côté serveur. La clé publiable est sécuritaire pour le navigateur; la clé secrète ne l’est pas.
Minimisez les données personnelles dans les propriétés des événements : Envoyez un ID d’utilisateur plutôt qu’une adresse de courriel, car l’ID seul vous permet de relier ultérieurement les données à la table des utilisateurs de Clerk si vous en avez besoin.
Respectez le consentement avant d’identifier les utilisateurs : Si votre territoire exige un consentement pour le suivi, conditionnez l’appel
identify()à ce consentement.Mettez à l’essai explicitement le comportement de fusion : Inscrivez-vous en tant qu’utilisateur anonyme, générez quelques événements, puis connectez-vous et confirmez que PostHog fusionne cet historique sous le profil identifié au lieu d’en démarrer un nouveau qui est déconnecté.
Documentez votre schéma d’événements : Une référence partagée pour les noms et les propriétés des événements empêche différentes parties de votre équipe de faire le suivi de la même action sous trois noms différents.
Comment Stripe Projects peut vous aider
Stripe Projects permet au personnel de développement et à ses agents d’IA d’ajouter des services, de générer des identifiants et de gérer la facturation à partir de l’interface de ligne de commande (CLI).
Stripe Projects vous aide à :
Provisionner des services tiers à partir de la ligne de commande : Utilisez un seul flux de travail pour ajouter des services, gérer les identifiants et mettre à niveau les offres, au lieu de recourir à des outils et à des flux de travail différents pour chaque fournisseur. Gérez l’hébergement, les bases de données, l’authentification, l’IA et bien plus encore sans avoir besoin de tableaux de bord, de fichiers de configuration ou de code d’infrastructure.
Synchroniser les identifiants automatiquement : Gardez les variables d’environnement transférables d’une configuration locale, d’un ordinateur, d’un ou d’une collègue et d’un agent à l’autre – pas de copier-coller de clés d’API (interface de programmation d’application).
Gérer la facturation à partir de la CLI ou de votre agent de codage : Configurez les informations de facturation une seule fois et partagez-les en toute sécurité avec des services tiers. Mettez à niveau et rétrogradez les niveaux, surveillez l’utilisation et gérez les abonnements à partir de la CLI.
Apprenez-en plus sur la façon dont Stripe Projects contribue à simplifier le provisionnement d’applications, ou copiez et collez cette commande dans votre terminal pour commencer dès aujourd’hui :
Le contenu de cet article est fourni uniquement à des fins informatives et pédagogiques. Il ne saurait constituer un conseil juridique ou fiscal. Stripe ne garantit pas l'exactitude, l'exhaustivité, la pertinence, ni l'actualité des informations contenues dans cet article. Nous vous conseillons de consulter un avocat compétent ou un comptable agréé dans le ou les territoires concernés pour obtenir des conseils adaptés à votre situation particulière.