Intégration PostHog pour JavaScript Node

Cette skill vous aide à ajouter PostHog analytics à vos applications JavaScript Node.

Flux de travail

Suivez ces étapes dans l'ordre pour compléter l'intégration :

1. basic-integration-1.0-begin.md - Configuration PostHog - Début ← Commencez ici
2. basic-integration-1.1-edit.md - Configuration PostHog - Édition
3. basic-integration-1.2-revise.md - Configuration PostHog - Révision
4. basic-integration-1.3-conclude.md - Configuration PostHog - Conclusion

Fichiers de référence

• references/node.md - Node.js - docs
• references/posthog-node.md - PostHog Node.js SDK
• references/identify-users.md - Identifier les utilisateurs - docs
• references/basic-integration-1.0-begin.md - Configuration PostHog - début
• references/basic-integration-1.1-edit.md - Configuration PostHog - édition
• references/basic-integration-1.2-revise.md - Configuration PostHog - révision
• references/basic-integration-1.3-conclude.md - Configuration PostHog - conclusion

Le projet exemple montre le modèle d'implémentation cible. Consultez la documentation pour les détails de l'API.

Principes clés

• Variables d'environnement : Utilisez toujours des variables d'environnement pour les clés PostHog. Ne les codez jamais en dur.
• Modifications minimales : Ajoutez le code PostHog aux côtés des intégrations existantes. Ne remplacez pas ou ne restructurez pas le code existant.
• Suivre l'exemple : Votre implémentation doit suivre les modèles du projet exemple d'aussi près que possible.

Directives du framework

• posthog-node est le nom du package SDK côté serveur Node.js – n'utilisez PAS posthog-js sur le serveur
• Incluez enableExceptionAutocapture: true dans les options du constructeur PostHog
• Ajoutez des appels posthog.capture() dans les gestionnaires de routes pour les actions utilisateur significatives – chaque route qui crée, met à jour ou supprime des données doit tracker un événement avec des propriétés contextuelles
• Ajoutez posthog.captureException(err, distinctId) dans le gestionnaire d'erreurs de l'application (par exemple, middleware d'erreur Express, setErrorHandler Fastify, app.on('error') Koa)
• Sur les serveurs à longue exécution, le SDK traite les événements par batch automatiquement – ne définissez pas flushAt ou flushInterval sauf si vous avez une raison spécifique
• Pour les processus courte durée (scripts, CLIs, serverless), définissez flushAt à 1 et flushInterval à 0 pour envoyer les événements immédiatement
• Le reverse proxy n'est PAS nécessaire pour Node.js côté serveur – seul le JavaScript côté client a besoin d'un proxy pour éviter les bloqueurs de publicités
• Rappelez-vous que le code source est disponible dans le répertoire node_modules
• Vérifiez package.json pour les scripts de vérification de type ou de build afin de valider les modifications

Identifier les utilisateurs

Identifiez les utilisateurs lors des événements de connexion et d'inscription. Référez-vous au code exemple et à la documentation pour le modèle identify correct pour ce framework. Si du code frontend et backend existe, passez la session côté client et l'ID distinct en utilisant les headers X-POSTHOG-DISTINCT-ID et X-POSTHOG-SESSION-ID pour maintenir la corrélation.

Suivi des erreurs

Ajoutez le suivi des erreurs PostHog aux fichiers pertinents, particulièrement autour des flux critiques utilisateur et des limites API.