Выгрузка данных в CSV или JSON

На странице статистики есть ссылка с пометкой CSV, а рядом — с пометкой JSON. Они отдают цифры в виде файла. Не нужен аккаунт, не нужна форма запроса, не нужно ждать письма со ссылкой на скачивание.

Эта статья в основном о том, зачем эта ссылка вообще нужна.

Что попадает в файл

CSV даёт одну строку на день с четырьмя столбцами — дата, обращения, уникальные посетители и боты. Он открывается в любой электронной таблице без какой-либо настройки, в чём и есть весь смысл выбора этого формата.

JSON даёт те же ежедневные цифры плюс разбивки: страны, города, браузеры, размеры экрана и самые посещаемые страницы, а также отметку о том, когда файл был сформирован и какой период он охватывает.

Оба принимают период. Достаточно добавить &days=90 для трёх месяцев или любое значение до 400 — это то же окно, в течение которого хранится сама статистика. Без этого параметра отдаются последние 30 дней.

Это обычный адрес

Экспорт — это обычный URL, а значит, его может получить всё, что умеет получать URL. Если цифры должны раз в неделю подтягиваться в таблицу или небольшой скрипт должен вести собственный архив глубже, чем 400 дней, — здесь ничто не мешает, и никакой ключ не нужен.

Это сделано намеренно. Кнопка загрузки, которая работает только тогда, когда её нажимает человек в браузере, — это кнопка загрузки, рассчитанная на то, чтобы ей воспользовались один раз.

Чего в нём нет

Стоит сказать прямо: это те же данные, которые уже показывает страница статистики. Никакого более богатого скрытого слоя тут не открывается. Экспорт существует для того, чтобы данные были переносимыми, а не для того, чтобы они были полнее.

В частности, в нём нет ничего по отдельным посетителям, потому что ничего по отдельным посетителям и не хранится. Ежедневный хеш, который отличает повторные визиты, удаляется через 2 дня и в файл не попадает. Экспортировать можно то, что существует: сгруппированные счётчики.

Зачем это нужно

Потому что возможность уйти должна быть.

Сервис, который держит историю в заложниках, удерживает не качеством, а стоимостью начала с нуля. Это плохая причина для того, чтобы оставаться, и ещё худшая вещь для того, чтобы намеренно её создавать.

История посетителей принадлежит владельцу сайта. Забрать её и уйти куда-то ещё — совершенно разумный поступок, и инструменты для этого не должны быть самой заброшенной частью сайта.