Portare via i dati in CSV o JSON

Sulla pagina delle statistiche c'è un link etichettato CSV, e accanto uno etichettato JSON. Consegnano i numeri sotto forma di file. Nessun account, nessun modulo di richiesta, nessuna attesa di un'email con dentro un link di download.

Questo articolo parla soprattutto del perché quel link esista.

Cosa si ottiene

CSV dà una riga per giorno con quattro colonne — data, hit, visitatori unici e bot. Si apre in qualsiasi foglio di calcolo senza che nulla debba essere configurato, il che è esattamente il motivo per cui è stato scelto questo formato.

JSON dà gli stessi dati giornalieri, più le suddivisioni: paesi, città, browser, risoluzioni dello schermo e le pagine più visitate, insieme a un'indicazione di quando il file è stato generato e quale periodo copre.

Entrambi accettano un periodo. Con &days=90 si ottengono tre mesi, o qualsiasi valore fino a 400 — la stessa finestra temporale per cui vengono conservate le statistiche stesse. Senza, arrivano gli ultimi 30 giorni.

È un indirizzo semplice

L'esportazione è un normale URL, il che significa che può essere recuperata da qualunque cosa sia in grado di recuperare un URL. Per far finire quei numeri in un foglio di calcolo una volta a settimana, o in un piccolo script che mantiene un proprio archivio più esteso di 400 giorni, non c'è nulla che lo impedisca, e non serve alcuna chiave.

È una scelta deliberata. Un pulsante di download che funziona solo quando un essere umano ci clicca sopra in un browser è un pulsante di download pensato per essere usato una volta sola.

Cosa non contiene

Vale la pena essere chiari su questo punto: sono gli stessi dati che la pagina delle statistiche mostra già. Non si sblocca alcun livello nascosto più ricco. L'esportazione esiste per rendere i dati portabili, non per renderli più completi.

In particolare non c'è nulla per singolo visitatore, perché non viene conservato nulla per singolo visitatore. L'hash giornaliero che distingue le visite ripetute viene eliminato dopo 2 giorni e non è nel file. Quello che si può esportare è quello che esiste: conteggi, raggruppati.

Perché preoccuparsene

Perché andarsene deve restare possibile.

Un servizio che tiene in ostaggio la cronologia di chi lo usa non lo trattiene per la sua qualità, lo trattiene per il costo di ricominciare da capo. È un pessimo motivo per restare, e una cosa ancora peggiore da costruire deliberatamente.

La cronologia dei visitatori appartiene a chi gestisce il contatore. Prenderla e andare altrove è una cosa perfettamente ragionevole da fare, e gli strumenti per farlo non dovrebbero essere la parte peggio mantenuta del sito.