De gegevens exporteren als CSV of JSON

Op de statistiekpagina staat een link met CSV erop, en daarnaast een met JSON. Beide geven de getallen als bestand mee. Geen account, geen aanvraagformulier, geen wachten op een e-mail met een downloadlink erin.

Dit bericht gaat vooral over waarom die link er überhaupt staat.

Wat eruit komt

CSV geeft één regel per dag met vier kolommen — datum, treffers, unieke bezoekers en bots. Het opent in elk rekenblad zonder dat er iets ingesteld hoeft te worden, en dat is de hele reden om dat formaat te kiezen.

JSON geeft dezelfde dagcijfers plus de uitsplitsingen: landen, steden, browsers, schermformaten en de meest bezochte pagina's, samen met een notitie wanneer het bestand gemaakt is en welke periode het bestrijkt.

Beide nemen een periode aan. Voeg &days=90 toe voor drie maanden, of wat dan ook tot 400 — hetzelfde venster waarvoor de statistieken zelf bewaard blijven. Zonder die parameter beslaat het bestand de laatste 30 dagen.

Het is een gewoon adres

De export is een gewone URL, wat betekent dat alles wat een URL kan ophalen hem kan ophalen. Voor getallen die eens per week in een rekenblad worden getrokken, of een klein script dat een eigen archief bijhoudt dat verder teruggaat dan 400 dagen, staat hier niets in de weg en is er geen sleutel nodig.

Dat is met opzet. Een downloadknop die alleen werkt wanneer een mens er in een browser op klikt, is een downloadknop die bedoeld is om één keer gebruikt te worden.

Wat er niet in zit

Hier past duidelijkheid: dit zijn dezelfde gegevens die de statistiekpagina al toont. Er wordt geen rijkere verborgen laag ontsloten. De export bestaat opdat de gegevens overdraagbaar zijn, niet opdat ze vollediger zijn.

In het bijzonder zit er niets per bezoeker in, want er wordt niets per bezoeker bewaard. De dagelijkse hash die herhaalbezoeken uit elkaar houdt wordt na twee dagen gewist en staat niet in het bestand. Wat de export bevat, is wat er bestaat: aantallen, gegroepeerd.

Waarom de moeite

Omdat weggaan mogelijk moet zijn.

Een dienst die een geschiedenis gijzelt, houdt haar gebruikers niet vast met kwaliteit, maar met de kosten van opnieuw beginnen. Dat is een slechte reden voor iemand om te blijven, en een nog slechter ding om met opzet te bouwen.

Bezoekersgeschiedenis hoort toe aan wie haar verzameld heeft. Haar elders mee naartoe nemen is volstrekt redelijk, en het gereedschap ervoor hoort niet het slechtst onderhouden deel van de site te zijn.