Яндекс Метрика API – основи роботи
Нещодавно один користувач «ВКонтакте» запитав мене: як отримати Яндекс токен для роботи з API Метрикою? Проблема, по суті, не викликає складнощів, хоча на той момент я не міг дати вичерпної відповіді. На пошук рішення у «непідготовленого» читача може піти тривалий проміжок часу. У цій статті я розгляну простий приклад роботи з API Яндекс Метрикою та детально розпишу всі етапи.
Тепер варто намітити план дій для роботи з API Яндекс Метрикою, він включатиме кілька пунктів:
- Реєстрація нового Яндекс-додатка;
- отримання Яндекс токена;
- Написання скрипта для взаємодії з даними Метрики.
В останньому пункті я напишу простий скрипт, який підключатиметься до API та отримуватиме статистику відвідуваності за сьогоднішній та вчорашній дні. Думаю, це хороший приклад, який буде корисний читачеві і допоможе йому краще розібратися з принципом роботи API Яндекса.
Реєстрація програми
Всі Яндекс додатки, які взаємодіють з Яндекс сервісами знаходитися на цій сторінці oauth.yandex.ru . Там же можна знайти посилання на додавання нової програми - клікнемо по ній!
Далі нам належить заповнити форму: вказуємо назву нашої програми, вибираємо права «Яндекс.Метрика», в чекбоксах, що з'явилися, вказуємо на другий – «отримання статистики». В останньому полі форми тиснемо на посилання "Підставити URL для розробки".
Все - програма налаштована!
Тиснемо зберегти, і потрапляє на сторінку з інформацією про нього. Там ми бачимо ID програми, пароль та Callback URL. З усього цього нам знадобиться лише ID.
З реєстрацією покінчено, переходимо донаступного етапу.
Отримання Яндекс токена
Є всього три способи, як отримати токен, про них ви можете дізнатися на цій сторінці - способи отримання Яндекс токенів. Я ж опишу найпростіший і найшвидший варіант - це отримання «налагоджувального токена».
Далі, у повідомленні, що з'явилося, вибираємо «Дозволити»:
Ось і все, ми отримали заповітний токен:
Скрипт для роботи з API
Сам код досить простий: це клас, що містить кілька властивостей та методів. Щоб почати користуватися ним необхідно, замінити значення змінних $token і $counter_id на свої.
Тепер поговоримо трохи про методи класу. Перший метод, і він головний, get_data() – є внутрішнім, служить звернення до API Метрики та отримання даних. Другий метод - публічний, за допомогою нього можна отримувати статистику за сформованим у ньому URL. Сам метод приймає два параметри: дату початку та дату закінчення вибірки.
Ось гарний приклад використання цього класу: отримання статистики відвідувань за сьогоднішній та вчорашній дні.
Виводимо на сторінку:
Ось так, легко і просто ми впоралися з API Метрикою.