analytics

Clamp Analytics est un SDK JavaScript léger qui permet de collecter des données d'utilisation produit sans cookies ni identifiants personnels. Après initialisation de la bibliothèque avec votre project ID, les pageviews et les informations de session sont enregistrés automatiquement, et vous pouvez envoyer des événements personnalisés, identifier les utilisateurs connectés, capturer les transactions de revenu et logger les erreurs. L'installation est simple : ajoutez le package avec npm ou collez un seul script tag pointant vers le CDN. Le script lit l'identifiant du projet depuis un attribut data-clamp-project et démarre le tracking immédiatement. Pour les frameworks comme React, Next.js, Vite, Nuxt, SvelteKit, Astro et d'autres, le SDK fournit des guides dédiés et un composant React qui peut être placé dans la mise en page racine. L'API comprend init, track, identify, reset, revenue, getAnonymousId et getUserId. Track permet d'enregistrer tout événement nommé avec des propriétés key-value plates. Revenue est un helper typé qui émet des événements canoniques d'abonnement et d'achat, calculant automatiquement les variations de MRR (Monthly Recurring Revenue) basé sur la période de facturation. Identify lie un user ID stable aux événements futurs, tandis que reset efface l'association lors de la déconnexion. Des mappings d'événements typés peuvent être définis en TypeScript, offrant l'autocomplétion et la validation à la compilation pour les événements personnalisés. Les événements revenue suivent un union type strict qui impose la combinaison correcte de champs pour les abonnements, achats ponctuels et remboursements. Le gestionnaire d'erreurs peut être activé pour capturer les exceptions non gérées et les rejets de promesses non traités en tant qu'événements $error, groupés par fingerprint pour faciliter l'analyse. Des extensions optionnelles ajoutent le auto-tracking pour les liens sortants, téléchargements de fichiers, pages 404, événements pilotés par data-attributes, web vitals et visibilité des sections. Chaque extension est chargée à la demande, maintenant la taille du bundle minimale. L'utilisation server-side est supportée via un build séparé nécessitant une API key. Vous pouvez émettre les mêmes événements depuis des services backend, webhooks ou server actions, assurant un flux d'événements unifié. Toutes les données collectées sont stockées sur la plateforme Clamp Analytics, qui offre un plan gratuit de 100k événements par mois et un serveur Model Context Protocol intégré. Cela rend les événements directement interrogeables par des agents IA comme Claude, Cursor ou des extensions VS Code, permettant des analytics en langage naturel et des insights automatisés. Le SDK est publié sous licence MIT et maintenu dans le repository clamp-sh/analytics.