Klickbee Tracking est l'analytics sans cookies que je développe pour Klickbee. Le premier commit date du 25 juin 2026, et le dépôt en compte 489 au 9 novembre. L'architecture tient en trois pièces : une application Next.js qui reçoit les événements et affiche les tableaux de bord, une base Postgres, et un SDK publié sur npm. Pas de file d'attente, pas de base analytique spécialisée.
01L'architecture réelle
Le dépôt est un monorepo pnpm avec Turborepo. Les pièces principales :
Les événements sont écrits directement en base. Une seule transaction Prisma crée ou met à jour le visiteur, puis la session, puis insère le lot d'événements. Les doublons sont écartés grâce à un identifiant unique par message. Seules les conversions envoyées côté serveur passent par une table de travaux, vidée toutes les cinq minutes par une tâche planifiée.
La base est un Postgres managé chez Neon, à Francfort. L'application tourne sur Vercel dans la région fra1, juste à côté. Les enregistrements de sessions sont compressés et stockés dans S3.
03Les choix revus en route
Deux décisions ont changé très tôt. Le jour même du premier commit, toute la pile est passée aux dernières versions majeures : Next 16, React 19.2, Prisma 7. Mieux valait partir à jour que migrer plus tard avec des données en production.
Cinq jours plus tard, le 30 juin, l'application a quitté la région de Singapour pour Francfort. La base était à Francfort, et chaque requête payait l'aller-retour entre les deux continents. Comme le temps de chaque requête dépendait surtout de la base, rapprocher le calcul de la base était le choix évident.
04Les trois bugs de production qui m'ont le plus appris
Aucun n'est venu de l'architecture. Tous sont venus d'un détail de configuration.
Le deuxième est le plus vicieux. À la fermeture d'une page, le SDK envoie son dernier lot avec sendBeacon, qui part toujours avec les identifiants du navigateur. La réponse de prévalidation CORS ne renvoyait pas l'en-tête Access-Control-Allow-Credentials, donc le navigateur jetait l'envoi sans erreur visible. Sur une visite courte, c'était souvent le seul lot.
Le troisième tient à un fichier mal placé. Le projet Vercel lit sa configuration dans apps/web, et le fichier vercel.json était à la racine du dépôt. Vercel l'ignorait sans rien dire : ni les tâches planifiées, ni les en-têtes de sécurité n'étaient appliqués. Voici l'essentiel du fichier, une fois à sa place :
La leçon commune : une configuration ignorée ne produit pas d'erreur. Depuis, un test vérifie que le fichier est bien à l'endroit que Vercel lit. J'en parle plus largement dans mon article sur la supervision.
05Ce que ça coûte
En octobre 2026, la part Vercel de Klickbee Tracking sur la facture de l'équipe est de 1,00 $ d'utilisation, au-dessus de l'abonnement Pro partagé entre tous nos projets. La base Neon et le stockage S3 sont facturés à part. Une architecture simple sur Vercel coûte peu tant que le trafic reste raisonnable, comme je l'explique dans pourquoi Vercel pour un SaaS.
L'outil est en ligne sur tracking.klickbee.com, avec une offre gratuite jusqu'à 1 000 sessions par mois.
06Questions fréquentes
Pourquoi Postgres plutôt qu'une base analytique comme ClickHouse ?
Parce qu'à ce stade, Postgres avec de bons index suffit, et qu'une seule base est plus simple à tenir. Une base spécialisée aura du sens quand les volumes l'exigeront, pas avant.
Pourquoi pas de file d'attente pour les événements ?
Une transaction par lot, avec dédoublonnage sur un identifiant unique, couvre le besoin actuel. Seules les conversions côté serveur passent par une table de travaux, parce qu'elles appellent des services externes qui peuvent échouer.
Un analytics sans cookies est-il exempté de consentement ?
Pas automatiquement. L'exemption de la CNIL pour la mesure d'audience dépend de conditions précises, dont la durée de vie des identifiants, que le SDK respecte avec son renouvellement à 395 jours. Chaque site reste responsable de sa propre conformité.
07Sources
Klickbee Tracking tient sur une architecture volontairement simple : une app Next.js, une base Postgres et un SDK. Les vrais problèmes sont venus des détails de configuration, pas de l'architecture.
Parlons de ton projet ↗