API Яндекс Метрики: выгрузка данных для собственных отчётов

API Яндекс Метрики — программный доступ к данным счётчика. Через него можно выгружать статистику в таблицы, BI-системы и собственные дашборды, сводить данные Метрики с CRM, Search Console и другими источниками. Для разового анализа хватает интерфейса, а API нужен, когда отчёты строятся регулярно и вручную это занимает часы.

Какие есть интерфейсы

• API отчётов — агрегированные данные: визиты, источники, цели, страницы, как в интерфейсе
• Logs API — неагрегированные данные о визитах и просмотрах, строка на каждое событие
• API управления — работа с настройками: счётчики, цели, фильтры, доступы

Для SEO-отчётности чаще всего достаточно API отчётов. Logs API нужен, если вы строите собственную модель атрибуции или храните историю в своей базе.

Доступ

Запросы авторизуются через OAuth-токен Яндекса. Создаётся приложение, выдаётся токен с правами на чтение статистики, токен передаётся в заголовке запроса. Храните токен как пароль: не публикуйте в коде на GitHub и не пересылайте в открытых чатах. Подробный порядок получения — в документации Метрики, он иногда меняется.

Что выгружать для SEO

1. Визиты из поисковых систем по дням с разбивкой по поисковику
2. Страницы входа из поиска с визитами, отказами и достижением целей
3. Конверсии по главным целям для поискового трафика
4. Те же данные по устройствам

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

Сведение с другими источниками

Метрика не знает поисковых запросов в полном объёме, а Search Console и Вебмастер не знают, что человек сделал на сайте. Через API можно соединить данные по адресу страницы: показы и клики из поисковых инструментов плюс поведение и заявки из Метрики. Так видно, какие страницы получают много показов, но мало кликов, и какие получают клики, но не дают заявок.

Ограничения и квоты

У API есть лимиты на число запросов и объём данных. Большие выгрузки разбивайте по периодам. Учитывайте семплирование: при больших объёмах агрегированные данные могут считаться по выборке — для точных цифр задайте параметр точности или используйте Logs API. Сверяйте итог выгрузки с интерфейсом хотя бы раз после настройки.

Типичные ошибки

• Разные часовые пояса в разных источниках, из-за чего дни не совпадают
• Сравнение данных с семплированием и без
• Выгрузка без фильтра роботов
• Токен привязан к личному аккаунту сотрудника, который ушёл из компании

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

Когда API не нужен

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

Промежуточный вариант — готовые коннекторы: многие BI-инструменты и табличные сервисы умеют подключаться к Метрике без программирования. Они сами используют API, а вам остаётся выбрать метрики и группировки. Ограничения те же — лимиты, семплирование, права токена, — поэтому проверку итоговых цифр не пропускайте и здесь.

Как поставить задачу разработчику

Опишите не «подключить API», а конечный отчёт: какие показатели, с какой группировкой, за какой период, как часто обновлять и куда складывать. Укажите номер счётчика, нужные цели и сегмент поискового трафика. Попросите, чтобы скрипт записывал дату последней успешной выгрузки и сообщал об ошибках, — иначе однажды отчёт тихо перестанет обновляться, и это заметят только через месяц.