Зачем выгружать статистику по всем ссылкам
Когда коротких ссылок много, смотреть на каждую по отдельности неудобно. Нужна общая картина: какие ссылки работают, сколько переходов, откуда приходят люди, что меняется со временем. Вручную собирать эти данные по одной ссылке — долго и утомительно. API позволяет выгрузить статистику по всем ссылкам сразу и собрать её в таблицу, с которой удобно работать.
Эта статья о том, как через API выгрузить статистику по всем коротким ссылкам в таблицу для отчёта, какие данные стоит запрашивать, как их структурировать и что учесть, чтобы данные были точными и полезными. Она не про то, как создать ссылку, а про то, как собрать по ним аналитику.
Какие данные можно получить через API
API для коротких ссылок обычно позволяет получить несколько типов данных.
Список ссылок. Основная информация: короткий адрес, конечный адрес, дата создания, статус.
Статистика по каждой ссылке. Количество переходов, уникальные переходы, переходы по дням, по источникам, по устройствам, по странам.
Данные по UTM-меткам. Если ссылки размечены, можно увидеть, какие кампании и источники дают больше переходов.
Данные по ограничениям. Если у ссылки есть срок действия или лимит переходов, можно увидеть, когда она перестанет работать.
Данные по активности. Когда ссылка последний раз использовалась, сколько времени прошло с последнего перехода.
Не все сервисы дают все данные. Стоит проверить, что доступно в вашем API.
Как подготовиться к выгрузке
Прежде чем запрашивать данные, стоит подготовиться.
Первое — определить, какие данные нужны. Не стоит выгружать всё, если для отчёта нужна только часть. Это упростит работу.
Второе — определить период. За какой срок нужна статистика: за день, за неделю, за месяц, за всё время.
Третье — определить формат. В каком виде нужны данные: таблица, CSV, JSON. Это зависит от того, как вы будете их использовать.
Четвёртое — проверить лимиты API. Некоторые сервисы ограничивают количество запросов в минуту или в час. Если ссылок много, это может занять время.
Пятое — подготовить ключ API. Убедиться, что он действителен и имеет нужные права.
Шестое — продумать структуру таблицы. Какие столбцы будут, как они называются, в каком порядке.
Как получить список ссылок
Первый шаг — получить список всех ссылок. Это основа для дальнейшей выгрузки.
Обычно API возвращает список ссылок с основной информацией. Если ссылок много, может понадобиться пагинация: API возвращает часть списка, потом следующую часть, и так далее.
Что стоит сохранить из списка:
— короткий адрес;
— конечный адрес;
— дату создания;
— статус;
— идентификатор, если он есть.
Эти данные станут первой частью таблицы. Остальные данные добавятся позже.
Подробнее о том, как использовать API для работы со ссылками, рассказано в материале про API для автоматизации работы с ссылками.
Как получить статистику по каждой ссылке
Второй шаг — получить статистику по каждой ссылке. Это может быть отдельный запрос для каждой ссылки или один запрос, который возвращает статистику по всем ссылкам сразу.
Если API требует отдельный запрос для каждой ссылки, это может занять время. Стоит учитывать лимиты и добавлять паузы между запросами.
Что стоит сохранить из статистики:
— количество переходов;
— количество уникальных переходов;
— переходы по дням;
— переходы по источникам;
— переходы по устройствам;
— переходы по странам.
Эти данные добавятся к таблице. В итоге получится полная картина по каждой ссылке.
Как структурировать таблицу
Структура таблицы зависит от того, что вы хотите увидеть. Но есть несколько общих принципов.
Первое — каждая ссылка — одна строка. Это удобно для сортировки и фильтрации.
Второе — основные данные в начале: короткий адрес, конечный адрес, дата создания.
Третье — статистика в середине: переходы, уникальные переходы, переходы по дням.
Четвёртое — дополнительные данные в конце: источники, устройства, страны.
Пятое — если данных много, можно разбить таблицу на несколько листов: один для основной информации, другой для статистики, третий для источников.
Шестое — добавить столбец с датой выгрузки. Это поможет понять, когда данные были актуальны.
Хорошая таблица — это таблица, с которой удобно работать. Не стоит перегружать её лишними столбцами.
Как выгрузить данные в таблицу
Способ зависит от того, какие инструменты вы используете.
Вариант первый — вручную. Получить данные через API, скопировать в таблицу. Это подходит для небольших объёмов и разовых задач.
Вариант второй — скрипт. Написать скрипт, который запрашивает данные и записывает их в файл CSV или в таблицу. Это подходит для регулярных выгрузок.
Вариант третий — готовые инструменты. Некоторые сервисы предлагают готовые интеграции с таблицами. Это самый простой вариант, если он доступен.
Вариант четвёртый — BI-инструменты. Если вы используете инструменты визуализации, можно подключить API напрямую.
Для регулярных отчётов лучше подходит скрипт или готовая интеграция. Для разовых задач — ручная выгрузка.
Подробнее о том, как выгружать статистику по ссылкам, рассказано в материале про автоматизацию сбора данных.
Как не ошибиться в данных
Выгрузка через API может дать неполные или неточные данные, если не учесть несколько вещей.
Первое — период. Убедитесь, что данные за тот период, который нужен. Разные периоды дают разные цифры.
Второе — часовой пояс. Некоторые API возвращают данные в UTC, другие — в локальном времени. Это может сдвигать цифры.
Третье — уникальные переходы. Разные сервисы считают уникальные переходы по-разному. Убедитесь, что понимаете, что именно означает эта цифра.
Четвёртое — боты. Некоторые API не фильтруют ботов. Это может завышать цифры.
Пятое — лимиты. Если API ограничивает количество запросов, часть данных может не загрузиться. Проверьте, что все данные получены.
Шестое — ошибки. Если запрос вернул ошибку, данные по этой ссылке могут отсутствовать. Стоит обработать ошибки и повторить запрос.
Седьмое — обновление. Если данные выгружаются регулярно, убедитесь, что они не дублируются и не теряются.
Подробнее о том, как проверять работоспособность ссылок через API, рассказано в материале про проверку работоспособности ссылок.
Как использовать данные
Выгрузка — это не конечная цель. Цель — использовать данные для решений.
Что можно делать с данными:
— сравнивать ссылки между собой;
— находить ссылки, которые работают лучше или хуже;
— видеть, какие источники дают больше переходов;
— замечать аномалии: резкие падения или всплески;
— планировать кампании на основе того, что работает;
— отключать ссылки, которые не дают результата.
Данные без действий бесполезны. Поэтому стоит заранее подумать, какие решения вы будете принимать на основе выгрузки.
Когда выгрузка через API не нужна
Выгрузка через API — не универсальное решение.
Если ссылок мало, можно посмотреть статистику вручную.
Если API не даёт нужных данных, выгрузка может быть неполной.
Если нет ресурсов на настройку, можно начать с ручной выгрузки и автоматизировать позже.
Если данные нужны разово, проще посмотреть их в интерфейсе сервиса.
Главное — чтобы выгрузка решала задачу, а не создавала новую.
Частые вопросы
Как выгрузить статистику по всем ссылкам через API?
Получить список ссылок, затем для каждой ссылки запросить статистику. Собрать данные в таблицу. Если ссылок много, учесть лимиты API и пагинацию.
Какие данные стоит запрашивать?
Основную информацию о ссылке, количество переходов, уникальные переходы, переходы по дням, источникам, устройствам и странам. Дополнительно — данные по ограничениям и активности.
Как структурировать таблицу?
Каждая ссылка — одна строка. Основные данные в начале, статистика в середине, дополнительные данные в конце. Добавить дату выгрузки.
Как не ошибиться в данных?
Учесть период и часовой пояс. Понять, как считаются уникальные переходы. Проверить, фильтруются ли боты. Обработать ошибки. Убедиться, что все данные получены.
Как использовать данные?
Сравнивать ссылки, находить лучшие и худшие, видеть источники, замечать аномалии, планировать кампании, отключать неэффективные ссылки.
Когда выгрузка через API не нужна?
Когда ссылок мало, когда API не даёт нужных данных, когда нет ресурсов на настройку, когда данные нужны разово. В этих случаях можно использовать другие способы.
