API Google Analytics – знакомство и создание собственного приложения

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

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

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

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

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

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

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

Доступные API

Доступные API

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

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

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

Загрузка библиотеки 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Давайте получим список браузеров, которыми пользовались посетители блога prometriki.ru за последние 7 дней.

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

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

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

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

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

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

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

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

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

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

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

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

Кейсы и инструкции по настройке в вашем ящике. Подпишитесь сейчас!

18 комментария(ев) к “API Google Analytics – знакомство и создание собственного приложения

    • Роман, поддерживаю, это упрощает формирование запросов, т.к. не все параметры и показатели совместимы между собой.

  1. В последнее время все чаще пользуюсь аддоном GA для google sheets, API посложнее будет

    • Павел, он удобен если нужно получить данные для последующей обработки, если Вы знакомы как построить запрос и что хотите получить в итоге, API более гибкий, но более сложный инструмент, все зависит от задачи

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

  2. Иван, очень интересна информация по визуализации данных полученных из API

  3. Иван, планируется статья в ближайшее время по отображению данных с помощью библиотеки визуализации?)

    • Максим, пока эта тема не вызывает интереса ни у кого кроме Вас, пока не планирую такой материал

      • Ярослав 24.04.2015 в 15:13 -

        Как же не вызывает? Очень даже вызывает! :)

      • Ярослав, пока тема не нашла должной поддержки со стороны читателей, отложу эту тему публикации

  4. Здравствуйте! сразу скажу, что я не программист? но возникла такая задача: выгрузить из аналитикса отчёт по user ID с привязкой к звонкам (колтач был интегрирован с гугл аналитикс). возможно ли это сделать с помощью Api и как?

    • Юлия, если Вы настроили передачу User ID в Google Analytics, выгрузить такие данные не получится. Если у Вас фиксируется Client ID через доп. параметр, то Вы можете выгрузить данные из Google Analytics и сопоставить их с информацией в любой другой системе, где есть это-же значение параметра.

      • Вадим 31.01.2016 в 23:58 -

        Иван, не могли бы подсказать как можно выгружать дополнительные параметры, в частности интересует Client ID ? Если через Core Reporting API, то какая это метрика?

      • Вадим, такого показателя для выгрузки нет, но Вы можете использовать вариант описанный здесь

  5. Здравствуйте. Скажите, можно ли по API в режиме реального времени получать из Google Analytics данные о поле и возрасте конкретного посетителя?

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

Current month ye@r day *