Intégration PostHog pour Astro (View Transitions)

Cette skill vous aide à ajouter l'analytique PostHog aux applications Astro (View Transitions).

Workflow

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/EXAMPLE.md - Code du projet exemple Astro (View Transitions)
• references/astro.md - Astro - docs
• 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 pattern d'implémentation cible. Consultez la documentation pour les détails de l'API.

Principes clés

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

Directives du framework

• Utilisez toujours la directive is:inline sur les balises de script PostHog pour empêcher Astro de les traiter et causer des erreurs TypeScript
• Utilisez le préfixe PUBLIC_ pour les variables d'environnement côté client dans Astro (ex. PUBLIC_POSTHOG_PROJECT_TOKEN)
• Créez un composant posthog.astro dans src/components/ pour l'initialisation réutilisable sur plusieurs pages
• Importez le composant PostHog dans un Layout et enveloppez toutes les pages avec ce layout
• Enveloppez l'initialisation PostHog avec une garde window.__posthog_initialized pour prévenir le débordement de pile lors de la navigation soft
• Définissez l'option capture_pageview à 'history_change' pour le suivi automatique des pageviews lors de la navigation soft
• Utilisez l'événement page-load d'Astro au lieu de seulement DOMContentLoaded pour réexécuter les scripts après la navigation soft

Identification des utilisateurs

Identifiez les utilisateurs lors des événements de connexion et d'inscription. Reportez-vous au code exemple et à la documentation pour le pattern d'identification correct pour ce framework. Si du code frontend et backend coexiste, transmettez 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 utilisateur critiques et des limites API.