Яндекс Метрика API: как зарегистрироваться в приложении и получить токен
Яндекс Метрика API – это инструмент, который позволяет получать статистику по сайту за определенные промежутки времени, а также управлять аккаунтами и счетчиками. Но средство имеет ограничение для формирования отчета – 30 запросов в секунду. Чтобы воспользоваться приложением API, необходимо авторизоваться с помощью токена OAuth. О том, как использовать API для Ваших целей, можно узнать в нашей статье.
Для чего нужен API Метрики
Благодаря использованию API Yandex Metrika можно расширить базовый функционал счетчика. Особенно удобен API при работе с большим количеством счетчиков. API позволяет автоматизировать работу с получением данных и значительно упростить найстроку целей.
Регистрация приложения API
Приложения, которые взаимодействуют с системой Яндекс, находятся на специальной странице – https://oauth.yandex.ru/. Для регистрации нужно нажать на соответствующую кнопку, после чего откроется специальная форма, которую нужно заполнить:
- Ввести название приложения, добавить описание, вставить ссылки на сайт и иконку.
- В разделе «Права» выбрать «Яндекс.Метрика».
- В появившемся чекбоксе поставить галочку напротив пункта «Получение статистики».
- Напротив параметра Callback URL щелкнуть по надписи «Подставить URL для разработки», чтобы в специальном поле появилась сгенерированный адрес.
После нажатия на кнопку сохранения открывается окно с информацией о приложении: URL-ссылка, пароль и ID. Затем можно переходить к следующему этапу.
Получение OAuth-токена
Чтобы получить Яндекс токен, в адресную строку браузера нужно ввести следующую ссылку:
На месте части адреса «ID_приложения» нужно ввести идентификационный номер, который отобразился после регистрации. После ввода адреса, нужно нажать на клавишу Enter для перехода, затем дать разрешение. Яндекс OAuth предоставит код, который является токеном. Его срок действия – один год.
Показатели сайта
Скрипт для работы с API содержит несколько методов и свойств. Для начала необходимо подставить свои значения в строках $token и $counter_id. Метод get_data() предназначен для прямого обращения Метрике API и получения данных из нее. Публичный метод служит для отображения статистики, сформированной по определенному URL-адресу. Он принимает временной период выборки: начало и конец.
Таким образом, все показатели Яндекс Метрики возможно получить одним запросом через счетчик, установленный на сайте. В текстовом окне отображается количество посетителей, просмотров, отказов, визитов и других параметров. Формирование отчета по определенной странице происходит с помощью фильтрации по URL.