Vue d’ensemble
Par site ou pour tout un espace : visiteurs, pages vues, événements, taux de rebond, un graphique par jour, pages, référents, tags UTM, pays, appareils, navigateurs, systèmes, et les web vitals si vous les envoyez.
Fonctionnalités
Ce qui existe aujourd’hui, et ce qui n’existe pas.
Tout ce qui est sur cette page existe dans le dépôt et tourne sur une instance de test. Il n’a pas encore rencontré de vrai trafic. Ce qui manque encore est listé à la fin.
La bibliothèque
packages/trailic, environ 1,5 Ko compressé, avec React pour seule dépendance. Les événements attendent jusqu’à 5 secondes, ou d’être 10, et partent en une seule requête. Un collecteur en panne ne change rien à la page : toute erreur est avalée, et rien n’est retenté.
- <Trailic />
- Compte la page de départ et chaque déplacement par l’API d’historique. N’affiche rien.
- track(name, props)
- Un événement. Chaînes, nombres et booléens, 16 au plus.
- identify(userId, traits)
- Qui c’est à partir de maintenant. Seulement quand votre projet l’appelle, en général après la connexion.
- reset()
- L’oublie, en général à la déconnexion.
- setConsent(granted)
- Garde tout en mémoire jusqu’à ce qu’il passe à vrai.
- trackServer(name, props, options)
- Depuis trailic/server, pour les route handlers. Dit si l’événement a été pris, et ne lève jamais d’erreur.
- <TrailicVitals />
- Depuis trailic/vitals, facultatif : LCP, CLS et INP.
- trailicRelay()
- Depuis trailic/next, pour collecter par le domaine de votre projet.
Le paquet n’est pas encore sur npm : pour l’instant, il se construit depuis le dépôt.
Les écrans
Funnels
De deux à huit étapes, chacune une page (un * final couvre tout ce qui est dessous) ou un événement, et le temps dont les gens disposent depuis la première.
Rétention
Des cohortes par le lundi de la semaine où quelqu’un a été identifié pour la première fois, et la part qui revient chaque semaine ensuite, sur toute activité ou sur un événement choisi.
Parcours
Depuis une page : la première fois de chaque visiteur sur cette page dans la journée, et les trois pages suivantes dans la demi-heure, les plus fréquentes d’abord.
Un vrai écran de l’application. Acme et ses chiffres sont inventés, sur une base de données jetable.
- Événements
- Chacun avec son nombre, ses visiteurs et ses jours.
- Personnes
- Celles qu’un site a identifiées, leur activité récente et leurs attributs, et un bouton pour effacer les données d’une personne quand elle le demande.
- Sites
- Chacun avec sa clé, son code d’installation, sa clé de relais, ses domaines et sa rétention, de 14 à 730 jours d’événements bruts.
- Espaces de travail
- Plusieurs sociétés sur une instance, séparées par la sécurité au niveau des lignes, avec un sélecteur, une équipe et des invitations.
Le lire d’ailleurs
Un serveur MCP
À l’adresse /api/mcp, en HTTP streamable. Un assistant s’enregistre, un membre se connecte et l’approuve, et chaque outil s’exécute au nom de ce membre. Ils ne font que lire, sauf create_site et create_workspace.
Une API de chiffres
GET /api/v1/figures avec une clé portant le droit figures:read : par site et par jour, des comptes seulement, ni pages ni personnes.
Collecter et stocker
Un collecteur qui ne réveille pas la base
POST /api/e vérifie la taille, une clé signée, les domaines du site, les robots connus et les limites de débit, puis confie le lot au tampon. Seul ce que le tampon a gardé reçoit une réponse 202.
Écrit une fois, quel que soit le nombre de livraisons
Les lots de chaque espace passent dans une seule transaction : le registre des identifiants de lots, les événements, les personnes, les agrégats du jour. Un lot écrit mais non acquitté est relivré, trouve son identifiant, et n’ajoute rien.
Du Postgres simple
Sans extension. Les événements bruts sont partitionnés par mois et les agrégats restent jusqu’à la suppression du site. Chaque table et chaque partition porte la sécurité au niveau des lignes, et un test échoue sur celles qui ne l’auraient pas.
Ce qui n’est pas construit
Rien de tout ceci n’existe encore : le replay de session, la capture automatique de chaque clic, les heatmaps, les feature flags et tests A/B, les sondages, la santé des comptes. Si l’un d’eux vous est nécessaire aujourd’hui, un outil plus mûr vous servira mieux. La section 9 de la spécification