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

API
Google Analytics
Бесплатная версия онлайн курса по Google Tag Manager

7 уроков, более 2 часов обучающих видео материалов. Вы можете начать изучение прямо сейчас!

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 для работы с ним, если развитие этой темы интересно вам, в одном из следующих материалов можно рассмотреть вопрос о визуализации полученных данных.

Еженедельная рассылка кейсов!
Обсуждение
  1. Роман Рыбальченко
    17.03.2015 at 12:42

    Чтобы сильно упростить работу с API лучше всего потренироваться в составлении запросов тут — https://ga-dev-tools.appspot.com/explorer/

    • Ответ автора
      17.03.2015 at 22:56

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

  2. Павел
    17.03.2015 at 18:05

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

    • Ответ автора
      17.03.2015 at 22:58

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

  3. Сергей Гридчин
    17.03.2015 at 19:18

    Плюсую два последних коммента. С аддоном для гугл таблицы попроще работать на деле.

    • Ответ автора
      17.03.2015 at 23:06

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

  4. Максим
    24.03.2015 at 11:54

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

  5. Максим
    25.03.2015 at 17:56

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

    • Ответ автора
      26.03.2015 at 13:01

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

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

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

      • Ответ автора
        06.05.2015 at 18:06

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

  6. Максим
    26.03.2015 at 18:16

    Иван, жаль)

  7. Юлия
    28.01.2016 at 11:34

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

    • Ответ автора
      29.01.2016 at 15:42

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

      • Вадим
        31.01.2016 at 23:58

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

      • Ответ автора
        02.02.2016 at 09:40

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

  8. Валентин
    14.03.2016 at 19:32

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

    • Ответ автора
      16.03.2016 at 16:49

      Такой возможности нет, данные обезличены

Ваш комментарий