Ajouter PostHog à une nouvelle application : voici comment installer et configurer PostHog et Clerk

Projects

Ajoutez des services, générez des identifiants et gérez la facturation depuis la CLI, ou laissez votre agent s’en charger.

En savoir plus 
  1. Introduction
  2. L’essentiel à retenir
  3. Que sont PostHog et Clerk ?
  4. Pourquoi associer l’analyse PostHog à l’authentification Clerk ?
  5. Comment configurer manuellement PostHog et Clerk ?
    1. 1. Créez un projet PostHog
    2. 2. Créez une application Clerk
    3. 3. Installez les SDK
    4. 4. Définissez les variables d’environnement
    5. 5. Testez la configuration
  6. Comment parcourir les fournisseurs d’analyses avec Stripe Projects ?
  7. Comment ajouter PostHog et Clerk avec Stripe Projects ?
  8. Quelles sont les bonnes pratiques pour PostHog et Clerk ?
  9. En quoi Stripe Projects peut vous aider

L'ajout de PostHog et Clerk à une nouvelle application nécessite 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 suit ce que font les utilisateurs une fois à l'intérieur. Vous pouvez les configurer manuellement via leurs dashboards et kits de développement logiciel (SDK), ou les provisionner avec Stripe Projects, qui récupère les identifiants des deux fournisseurs directement dans le fichier .env de votre projet, sans avoir à jongler entre les différents dashboards.

PostHog est utilisé par plus de 500 000 équipes et près de 250 000 ingénieurs. De nombreuses équipes finissent par associer PostHog à un fournisseur d'authentification, tel que Clerk. Stripe Projects simplifie cette configuration en provisionnant les deux services dans un seul workflow.

Nous allons voir ci-dessous ce que fait chaque fournisseur, pourquoi l'association d'une identité authentifiée aux événements d'analyse permet d'aller au-delà de la simple analyse du trafic, et comment ajouter rapidement PostHog et Clerk à l'aide de Stripe Projects.

L’essentiel à retenir

  • La connexion des identifiants utilisateur (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 perte de l'historique des événements antérieurs à la connexion.

  • Stripe Projects peut provisionner PostHog et Clerk via des commandes d'interface en ligne de commande (CLI) qui gèrent l'autorisation des comptes et inscrivent les identifiants directement dans le fichier .env de votre projet.

  • Les bonnes pratiques pour PostHog et Clerk incluent la séparation stricte des environnements et la réduction 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 suit les événements, les pages vues et le comportement des utilisateurs au sein d'une application, puis transforme ces données en entonnoirs, en enregistrements de session, en feature flags et en analyses de cohortes. Clerk est un fournisseur de services 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 profil des utilisateurs.

Pourquoi associer l'analyse PostHog à l'authentification Clerk ?

L'association de PostHog et Clerk vous fournit des analyses sur le trafic en haut de l'entonnoir, comme la prévision du taux d'attrition, l'analyse de l'onboarding ou l'adoption des fonctionnalités, réparties par niveau de compte. PostHog suit les utilisateurs à l'aide d'un ID distinct, qui est initialement un identifiant anonyme généré aléatoirement et lié à un navigateur ou à un appareil. Lorsqu'un utilisateur se connecte via Clerk, vous pouvez appeler la méthode identify() de PostHog et transmettre l'ID utilisateur de Clerk comme nouvel ID distinct. PostHog fusionne alors l'historique des sessions anonymes avec le profil identifié, reliant à cet utilisateur les événements suivis avant la connexion (tels que les pages vues, les clics sur les boutons et les interactions avec les fonctionnalités).

Prêtez une attention particulière à ces éléments :

  • Cohérence du nommage des événements : Décidez très tôt si les événements sont en snake case (par exemple, sans espaces) ou en casse de titre, et s'ils décrivent des actions telles que signed\_up ou des objets tels que signup\_completed. Le mélange des conventions rend vos dashboards PostHog illisibles.

  • Utilisateurs anonymes et identifiés : Si vous appelez identify() à chaque chargement de page, vous accumulerez des événements de fusion dupliqués dans le journal d'activité de PostHog. Appelez cette méthode une seule fois, juste après que Clerk a confirmé une session. Vous pouvez également conditionner l'appel à une vérification permettant de s'assurer que l'utilisateur a déjà été identifié au cours de la session active.

  • Confidentialité et consentement : Dans les juridictions imposant des exigences de consentement pour le suivi, comme le RGPD dans l'UE, recueillez ce consentement avant d'identifier un utilisateur ou de joindre des données personnelles aux propriétés de l'événement. La présence d'un e-mail ou d'un nom sur chaque événement d'analyse est rarement nécessaire et accroît votre périmètre de conformité.

  • Quand associer les deux outils : Si votre application se compose principalement de pages marketing préalables à l'inscription, le suivi anonyme est suffisant. Connectez les événements Clerk et PostHog une fois que vous disposez de flux authentifiés dont la mesure est pertinente, tels que la conversion d'une version d'essai en version payante.

Comment configurer manuellement PostHog et Clerk ?

Vous allez configurer manuellement les deux fournisseurs sur quatre systèmes : deux dashboards et deux SDK.

Voici comment cela fonctionne :

1. Créez un projet PostHog

Inscrivez-vous sur PostHog et créez un projet. Cela vous fournit une clé d'interface de programmation d'application (API) et l'URL de l'hôte du projet. Vous aurez besoin de ces deux valeurs pour le SDK.

2. Créez une application Clerk

Dans le dashboard de Clerk, créez une application et choisissez vos méthodes de connexion, telles que l'e-mail, Google OAuth ou les clés d'accès.

3. Installez les SDK

Exécutez npm install posthog-js et npm install @clerk/nextjs pour une application Next.js. PostHog s'initialise côté client via posthog.init(), tandis que Clerk englobe votre application dans un \<ClerkProvider\> et nécessite un middleware pour gérer la protection des routes.

4. Définissez les variables d'environnement

Ajoutez de quatre à six valeurs à votre fichier .env.local.

5. Testez la configuration

Confirmez que le flux de connexion de Clerk génère une session, puis consultez la vue des événements en direct de PostHog pour vous assurer que les événements sont bien reçus. Vérifiez que identify() se déclenche exactement une fois par session, juste après la validation de l'authentification.

Comment parcourir les fournisseurs d'analyses avec Stripe Projects ?

Stripe Projects est une fonctionnalité de Stripe CLI permettant de provisionner des services d'infrastructure tiers (notamment des bases de données, des outils d'analyse et des fournisseurs d'IA) directement depuis la ligne de commande. Au lieu d'ouvrir des dashboards 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 depuis le répertoire de votre projet afin de lister les fournisseurs disponibles, organisés par catégorie et par niveau de service. Vous pouvez affiner cette liste avec stripe projects catalog \<provider\> ou stripe projects catalog \<category\>, ou effectuer une recherche directe avec stripe projects search \<keyword\>. Si vous recherchez spécifiquement des services d'analyse, PostHog apparaîtra avec d'autres fournisseurs pris en charge, ce qui vous évite de quitter votre terminal ou d'ouvrir un navigateur.

Comment ajouter PostHog et Clerk avec Stripe Projects ?

Une fois PostHog et Clerk choisis, il suffit de deux commandes pour les provisionner à partir d'un projet déjà initialisé avec Stripe CLI. Pour ajouter PostHog, exécutez stripe projects add posthog/analytics afin de lancer le workflow de provisionnement. Stripe Projects gère l'étape d'autorisation du compte, qui vous obligerait normalement à vous connecter directement à PostHog et à copier les clés manuellement. Il inscrit ensuite la clé API obtenue et l'URL de l'hôte dans le fichier .env de votre projet. L'exécution de la commande stripe projects add clerk/auth produit le même résultat pour Clerk : elle gère le flux d'autorisation et récupère la clé publiable et la clé secrète. Ces dernières sont ajoutées au fichier .env, à la suite des éléments inscrits par PostHog.

La différence concrète entre la configuration avec Stripe Projects et la configuration manuelle réside dans la provenance des identifiants. Au lieu de copier les clés depuis deux dashboards pour les coller dans .env.local, Stripe Projects les récupère et les inscrit directement. Toutefois, vous (ou votre agent de codage) devez toujours écrire le code d'initialisation du SDK et configurer vous-même la logique de votre application.

Il est également important de synchroniser vos clés. Si vous configurez le projet sur une nouvelle machine pour la première fois, la commande stripe projects pull \<projectID\> clone le projet existant dans un répertoire vide et inscrit votre fichier .env, ce qui permet de se connecter aux services existants du projet au lieu d'en provisionner de nouveaux. Si vous vous trouvez déjà dans le répertoire du projet et devez actualiser votre fichier .env local après l'ajout ou le renouvellement d'un fournisseur par un membre de votre équipe, exécutez plutôt stripe projects pull env \--pull.

Quelles sont les bonnes pratiques pour PostHog et Clerk ?

Il convient de configurer correctement quelques éléments avant de déployer cette intégration.

Voici ce qu’il faut garder à l’esprit :

  • Séparez clairement les environnements : Utilisez des projets PostHog et des applications Clerk différents pour le développement et la production. Le fait de mélanger les inscriptions de test avec les données réelles des utilisateurs rend vos analyses peu fiables et encombre votre liste d'utilisateurs Clerk avec des 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écurisée pour le navigateur ; ce n'est pas le cas de la clé secrète.

  • Réduisez les données personnelles dans les propriétés d'événements : Envoyez un ID utilisateur plutôt qu'une adresse e-mail, car cet ID permet à lui seul de joindre ultérieurement les données à la table des utilisateurs de Clerk, si nécessaire.

  • Respectez le consentement avant d'identifier les utilisateurs : Si votre juridiction exige le consentement au suivi, conditionnez l'appel identify() à l'obtention de ce consentement.

  • Testez 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 initier un nouveau, déconnecté du précédent.

  • Documentez le schéma de vos événements : Une référence commune pour les noms et les propriétés des événements évite que les différentes parties de votre équipe ne suivent la même action sous trois noms différents.

En quoi Stripe Projects peut vous aider

Stripe Projects permet aux développeurs et à leurs agents d'IA d'ajouter des services, de générer des identifiants et de gérer la facturation depuis l'interface en ligne de commande (CLI).

Stripe Projects vous aide à :

  • Provisionner des services tiers depuis la ligne de commande : Utilisez un seul workflow pour ajouter des services, gérer des identifiants et mettre à niveau des offres, au lieu d'utiliser des outils et des workflows 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 dashboards, de fichiers de configuration ou de code d'infrastructure.

  • Synchroniser automatiquement les identifiants : Maintenez la portabilité des variables d'environnement entre les configurations locales, les machines, les membres de l'équipe et les agents, sans aucun copier-coller de clés d'interface de programmation d'application (API).

  • Gérer la facturation depuis la CLI ou votre agent de codage : Configurez vos informations de facturation une seule fois et partagez-les en toute sécurité avec des services tiers. Mettez à niveau ou rétrogradez les niveaux de service, surveillez votre utilisation et gérez vos abonnements directement depuis la CLI.

Découvrez comment Stripe Projects permet de simplifier le provisionnement d'applications, ou copiez-collez cette commande dans votre terminal pour vous lancer dès aujourd'hui :

Le contenu de cet article est fourni à des fins informatives et pédagogiques uniquement. 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 solliciter l'avis d'un avocat compétent ou d'un comptable agréé dans le ou les territoires concernés pour obtenir des conseils adaptés à votre situation.

Plus d'articles

  • Un problème est survenu. Veuillez réessayer ou contacter le service de support.

Envie de vous lancer ?

Créez un compte et commencez à accepter des paiements rapidement, sans avoir à signer de contrat ni à fournir vos coordonnées bancaires. N'hésitez pas à nous contacter pour discuter de solutions personnalisées pour votre entreprise.
Payments

Payments

Acceptez des paiements en ligne, en personne et dans le monde entier, grâce à une solution de paiement adaptée à toutes les entreprises.

Documentation Payments

Trouvez un guide qui vous aidera à intégrer les API de paiement Stripe.