Google Analytics API на PHP. Инструкция по применению

Те люди, которые много работают с Google Analytics периодически сталкиваются с тем, что получение нужных данных через веб-интерфейс занимает много времени. Это может быть связано с сэмплированием данных или просто медленной работы интерфейса. Чтобы получать большие выборки данных их Analytics можно пользоваться их API. Это может значительно упростить анализ различных данных, но и помочь улучшить функционал сайта без разработки сложных технологий (подобные примеры опишу в одной из следующих статей).

В этом материале я попробую популярно описать как начать пользоваться API Google Analytics используя язык программирования PHP.

Что для этого нужно:

Аккаунт в Google Analytics и сайт, добавленный в систему.
Ключ API для Google Analytics.
Библиотека для PHP.
Базовые знания PHP.

Пункт первый предлагаю пропустить, ибо если вам интересно использование API, то вы уже должны быть знакомы с Analytics.

Важно. Доступ к Google Analytics должен иметь широкий доступ, а не только чтение.

Начнем сразу с получения ключей для работы с API. Для этого нужно зарегистрироваться в консоли разработчиков Google. Для этого нужно зайти на страницу https://console.developers.google.com/start и создать новый проект.

Называем его как душе будет приятно и соглашаемся с условиями работы. После этого сверху, где ранее выбирали «Create a project» появится наш новый проект. Выбираем его. Если все нормально – слева появится меню работы с проектом. Выбираем пункт «APIs & Auth», а в нем подпункт «APIs». После этого попадаем на страницу с перечнем всех возможных сервисов Google, с которыми можно работать по API. Т.к. Analytics не очень популярен, то в базовом наборе сервисов его нет. Нужно воспользоваться строкой поиска и выбрать Analytics.

Страница выбора Analytics API

Дальше нужно активировать доступ нажав на синюю кнопку «Enable API». Теперь можно пользоваться Google Analytics API. Теперь нужно получить ключи для работы. Для этого переходим в левом меню на пункт «Credentials» (сразу под кнопкой «APIs», которую нажимали ранее).

Страница создания ключа API Google Analytics

На этой странице нам предложат создать один из возможных вариантов доступа. Выбирать тут стоит исходя их того, как вы будете пользоваться API. В этой статье я рассмотрю два варианта «API key» и «OAuth 2.0». В данный момент выберем вариант «API key», а затем «Server key». Теперь у нас есть ключ для работы с API Google Analytics.

Библиотеки для работы с GoogleAnalytics API на PHP

Для дальнейших действий есть два сценария: простой и посложнее. В первом достаточно пользоваться лишь аккаунтом с включенным API Analytics. Во втором варианте придется проходить авторизацию через OAuth, что предполагает больше работы на начальном этапе.

Простой вариант

Для начала нужно зайти на страницу https://myaccount.google.com/security#connectedapps и в нижнем правом углу разрешить ненадежные приложения. Теперь можем скачать старенький класс. Достать его можно тут: https://github.com/humanmade/hm-top-posts/blob/master/gapi.class.php. Теперь можем работать с API.

Давайте создадим простой файл, который будет доставать минимум данных. Пишем следующий код:

include ("gapi.class.php"); //Подключаем класс для работы с API
$ga = new gapi('ЛОГИН','ПАРОЛЬ'); // Создаем объект для работы с API
$ga->requestReportData(Идентификатор,array('sourceMedium'),array('pageviews','visits','entrances','uniquePageviews'),'-visits',"", "2015-08-01", "2015-08-27", '1', '100');
if ($ga->getResults())
                foreach($ga->getResults() as $result)
                {
                               $zz = $result->getsourceMedium(); // Источник
                               $zz2 = $result->getPageviews(); // Просмотров страниц
                               $zz3 = $result->getEntrances(); // Посещений
                               echo '
;'.$zz.';'.$zz2.';'.$zz3;
                }
?>

В результате выполнения будет выводиться перечень источников трафика на сайт с числом просмотренных страниц и входов по ним за указанный период. Чтобы у вас он заработал нужно в третьей строке «ЛОГИН» и «ПАРОЛЬ» изменить на соответствующие значения аккаунта, в котором у вас используется Google Analytics.

Самый важный элемент – это функция requestReportData. Ее синтаксис рассмотрим более детально:

requestReportData(Идентификатор, Показатель, Метрики, Сортировка, Фильтр, Начальная_дата, Конечная_дата, Индекс_начала, Число_результатов)

Идентификатор – числовое значение представления, его можно посмотреть в настройках представления сайта в Google Analytics. Или в url отчетов Analytics – число идет сразу после символа «p».
Показатель – параметр, по которому будут доставаться данные. Например, источники, каналы, страницы и т.д.
Метрики – численные значения, которые можно получить для указанных параметров, например, число визитов, число достигнутых целей и т.д.
Сортировка – метрика, по которой мы сортируем результаты. Минус в начале означает сортировку по убыванию.
Фильтр – фильтрование результатов по любому значению любого параметра.
Начальная_дата – дата в формате YYYY-MM-DD, начиная с которой берутся данные.
Конечная_дата - дата в формате YYYY-MM-DD, по которую берутся данные.
Индекс_начала – номер первой строки результата, с которой берутся данные.
Число_результатов – количество результатов, которые пойдут в отчет. Если не ошибаюсь, то максимальное значение 1000.

Все показатели и метрики можно посмотреть в документации https://developers.google.com/analytics/devguides/reporting/core/dimsmets. Примеры настройки под стандартные отчеты показаны тут https://developers.google.com/analytics/devguides/reporting/core/v3/common-queries.

У этого варианта есть один существенный недостаток – нельзя сегментировать данные. Если нужно получать сегментированные данные, то нужно воспользоваться вариантом с OAuth авторизацией.

Вариант с OAuth авторизацией

Эта часть статьи появится в ближайшее время. Подождите немного.

Дата публикации: 19:33 26.08.2015