Emporter ses données en CSV ou JSON

Il y a un lien sur la page de statistiques marqué CSV, et à côté un autre marqué JSON. Ils remettent les chiffres sous forme de fichier. Pas de compte, pas de formulaire de demande, pas d'attente d'un e-mail contenant un lien de téléchargement.

Cet article porte surtout sur la raison d'être de ce lien.

Ce que contient le fichier

CSV donne une ligne par jour avec quatre colonnes — date, requêtes, visiteurs uniques et bots. Il s'ouvre dans n'importe quel tableur sans qu'il y ait rien à configurer, ce qui est tout l'intérêt de ce format.

JSON donne les mêmes chiffres quotidiens, plus les répartitions : pays, villes, navigateurs, résolutions d'écran, et les pages les plus visitées, ainsi qu'une indication du moment où le fichier a été généré et de la période qu'il couvre.

Les deux acceptent une période. Le paramètre &days=90 donne trois mois, et n'importe quelle valeur jusqu'à 400 fonctionne — la même fenêtre pendant laquelle les statistiques elles-mêmes sont conservées. Sans cela, le fichier couvre les 30 derniers jours.

C'est une adresse toute simple

L'export est une URL ordinaire, ce qui signifie qu'elle peut être récupérée par tout ce qui est capable de récupérer une URL. Pour que les chiffres soient importés dans un tableur une fois par semaine, ou par un petit script qui conserve sa propre archive remontant plus loin que 400 jours, rien ici ne fait obstacle et aucune clé n'est nécessaire.

C'est délibéré. Un bouton de téléchargement qui ne fonctionne que lorsqu'un humain clique dessus dans un navigateur est un bouton de téléchargement conçu pour n'être utilisé qu'une seule fois.

Ce qu'il ne contient pas

Autant être clair : ce sont les mêmes données que la page de statistiques affiche déjà. Il n'y a pas de couche cachée plus riche qui se débloquerait. L'export existe pour que les données soient portables, pas pour qu'elles soient plus complètes.

En particulier, il n'y a rien par visiteur, parce que rien par visiteur n'est conservé. Le hachage quotidien qui distingue les visites répétées est supprimé au bout de 2 jours et ne figure pas dans le fichier. Ce qui est exportable, c'est ce qui existe : des décomptes, regroupés.

Pourquoi s'en donner la peine

Parce que partir doit rester possible.

Un service qui retient l'historique en otage ne retient pas par la qualité, il retient par le coût de tout recommencer. C'est une mauvaise raison de rester pour qui que ce soit, et une chose encore pire à construire délibérément.

L'historique des visiteurs appartient au propriétaire du compteur. Le récupérer pour aller ailleurs est parfaitement raisonnable, et les outils prévus pour cela ne devraient pas être la partie la moins bien entretenue du site.