API Google Analytics позволяет создавать персонализированные отчеты, выполнять выгрузки различных данных для последующей обработки вне Google Analytics.

Существует несколько вариантов API Google Analytcs: для работы с отчетами (Core Reporting API), для управления аккаунтом (Management API), для получения данных в реальном времени (Real Time Reporting API) и др.

Для начала работы с API Google Analytics необходимо создать проект в консоли разработчика, для этого нужно авторизоваться на Google или пройти процедуру регистрации, а затем перейти по ссылке console.developers.google.com .

Если у вас еще нет созданных проектов вы увидите следующее сообщение:


Создание проекта

Нажмите кнопку Create project. Вам предложат во всплывающем окне указать имя проекта и его идентификатор. Будьте внимательны, затем изменить Project ID нельзя. Запустится процесс создания нового проекта. В это время внизу экрана возможно появление подобного сообщения:


Процесс создания проекта для API Google Analytics

После того, как процесс завершится откроется страница Project Dashbord, на которой есть несколько вариантов дальнейших действий, перейдем к базовым настройкам для работы с API Google Analytics.

Поскольку мы будем работать с API Google Analytics необходимо включить данную возможность. Для этого в меню слева выберите пункт APIs &auth, затем APIs. Найдите в списке Analytics API и если справа от него нет зеленой кнопки ON, кликните по серой OFF:


Активация API Google Analytics

После нажатия выбранный API появится в верхней части страницы:


Доступные API

Пока оставим дальнейшую настройку проекта и получим файлы необходимые для работы API Google Analytics. Поскольку я имею навыки программирования на языке PHP, то и библиотеку для работы я выбрал на этом языке.

Файлы для загрузки доступны по адресу github.com/google/google-api-php-client . Необходимо перейти по ссылке и скачать доступные файлы. Если вы не работали с сервисом GitHub, то для загрузки используется кнопка Download ZIP расположенная в правой части страницы:


Загрузка библиотеки PHP для API Google Analytics

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

Для того, чтобы наше приложение могло успешно работать и получать данные с серверов Google мы должны получить следующие параметры:

  • Client ID
  • Client secret
  • Redirect URIs

Для получения указанных параметров необходимо войти в консоль разработчика, выбрать необходимый проект, после чего в левом меню перейти по Apis & auth -> Credentials и нажать на кнопку Create new Client ID.

Появится форма, в которой выберите тип приложения, укажите доменное имя сайта на котором будет использоваться библиотека PHP для работы с API Google Analytics, а также URL обработчика, который получит результаты авторизации от Google. Укажите свои значения и параметры в соответствующих полях, после выполнения всех действий вы увидите следующую информацию:


Создание Client ID для API Google Analytics

Сейчас вы имеете необходимые ключи для работы с API Google Analytics, вернемся к библиотеке PHP для работы с API сервисов Google, которую мы получили ранее.

Извлеките содержимое архива google-api-php-client-master.zip в отдельную папку, после того как завершится процесс извлечения файлов из архива можете удалить все кроме следующих папок и файлов:


Файлы для работы с API Google Analytics

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

Поскольку логика работы на этапе авторизации, а также варианты реализации могут различаться в зависимости от задач, я не буду приводить пример кода для этих действий, а продемонстрирую несколько запросов использующих PHP библиотеку для API Google Analytics.

Для тестовых запросов я буду использовать следующий основной блок:

PHP

123456

// если авторизация пройдена успешноif (isset($_SESSION[‘access_token’])) {  $client->setAccessToken($_SESSION[‘access_token’]);  $service = new Google_Service_Analytics($client);  // тут код для примеров}

Небольшое замечание, при первом обращении к приложению появится следующее окно (название приложения будет отличаться):


Запрос на доступ к данным

Дальнейшая работа приложения возможна в том случае, если выбран вариант Принять.

 Итак, первый пример – получение списка доступных аккаунтов:

PHP

12

$accounts = $service->management_accounts->listManagementAccounts();echo ‘<pre>’; print_r($accounts); echo ‘</pre>’;

В результате выполнения этого кода мы увидим в браузере вот такую информацию:


Результат выполнения запроса API Google Analytics

Как видите, данные, которые получаются в результате выполнения запросов, имеют формат многомерных массивов. Т.к. мы рассматриваем библиотеку PHP для доступа к API Google Analytics проблем с их разбором не будет, поскольку этот язык имеет достаточное количество стандартных функций для работы с массивами.

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

PHP

12345678

$data = $service->data_ga->get(        ‘ga:0000000000’, // id представления        ‘2015-03-08’,         ‘2015-03-14’,         ‘ga:sessions’,         array(‘dimensions’=>’ga:browser’));echo ‘<pre>’; print_r($data); echo ‘</pre>’;

Вы можете столкнуться с проблемой поиска идентификатора представления, который указывается первым в списке параметров, его можно узнать перейдя в раздел отчетов Google Analytics из адресной строки (справа от символа p):


Идентификатор представления Google Analytics

Вот фрагмент результата, который в “сыром” виде доступен для работы:


Результат по браузерам

Немного приукрасим вывод информации:

PHP

12345678910

$data = $service->data_ga->get(        ‘ga:0000000000’, // id представления         ‘2015-03-08’,         ‘2015-03-14’,         ‘ga:sessions’,         array(‘dimensions’=>’ga:browser’));foreach ($data[‘rows’] as $d) {    echo $d[‘0’] . ‘ — ‘ . $d[1] . ‘<br />’;}

Получим результат:


Посещения по браузерам

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

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *