Dane do zabrania w CSV albo JSON

Na stronie statystyk jest link oznaczony CSV, a obok niego kolejny oznaczony JSON. Wydają one liczby licznika w postaci pliku. Bez konta, bez formularza z prośbą, bez czekania na e-mail z linkiem do pobrania w środku.

Ten wpis dotyczy głównie tego, dlaczego ten link w ogóle tam jest.

Co się dostaje

CSV daje jeden wiersz na dzień z czterema kolumnami — data, odsłony, unikalni odwiedzający i boty. Otwiera się w każdym arkuszu kalkulacyjnym bez żadnej konfiguracji, o co właśnie chodzi w wyborze tego formatu.

JSON daje te same dzienne dane, a do tego podziały: kraje, miasta, przeglądarki, rozmiary ekranu i najczęściej odwiedzane strony, wraz z informacją o tym, kiedy plik został wygenerowany i jaki okres obejmuje.

Oba akceptują parametr okresu. Dopisane &days=90 daje trzy miesiące, a dowolna wartość do 400 — tyle samo, ile wynosi okno przechowywania samych statystyk. Bez tego parametru wychodzi ostatnie 30 dni.

To zwykły adres

Eksport to zwykły URL, co oznacza, że może go pobrać wszystko, co potrafi pobrać URL. Nic nie stoi na przeszkodzie, żeby liczby trafiały do arkusza raz w tygodniu albo żeby mały skrypt prowadził własne archiwum sięgające dalej niż 400 dni, i nie jest do tego wymagany żaden klucz.

To celowe. Przycisk pobierania, który działa tylko wtedy, gdy kliknie go człowiek w przeglądarce, to przycisk pobierania zaprojektowany do jednorazowego użytku.

Czego nie zawiera

Warto być szczerym: to te same dane, które już pokazuje strona statystyk. Nie odblokowuje się tu żadnej bogatszej, ukrytej warstwy. Eksport istnieje po to, by dane były przenośne, a nie by były pełniejsze.

W szczególności nie ma w nim niczego dotyczącego pojedynczego odwiedzającego, ponieważ nic takiego nie jest przechowywane. Dzienny skrót, który odróżnia powtórne wizyty, jest usuwany po 2 dniach i nie znajduje się w pliku. Eksportowi podlega to, co istnieje: liczby, pogrupowane.

Po co to wszystko

Ponieważ odejście musi być możliwe.

Usługa, która trzyma cudzą historię jako zakładnika, nie zatrzymuje jakością, tylko kosztem zaczynania od nowa. To słaby powód, żeby ktokolwiek został, a jeszcze gorsza rzecz do celowego budowania.

Historia odwiedzających należy do właściciela licznika. Zabranie jej i przeniesienie gdzie indziej to całkowicie rozsądne posunięcie, a narzędzia do tego nie powinny być najgorzej utrzymaną częścią strony.