Обзор

Здесь представлены общие сведения о Google Analytics Reporting API версии 4. Более подробную информацию можно найти на этой странице.

Введение

Google Analytics Reporting API версии 4 – самый передовой программный способ получения данных из Google Analytics. Этот интерфейс дает следующие возможности:

  • создавать специальные сводки для просмотра данных Google Analytics;
  • автоматизировать создание сложных отчетов;
  • использовать данные Google Analytics в других бизнес-приложениях.

Возможности

В основе Google Analytics лежит хорошо продуманная система сбора данных. Reporting API версии 4 позволяет получать доступ к этой информации. Ниже описываются возможности этого интерфейса.

  • Выражения для показателей

    API позволяет запрашивать не только встроенные показатели, но и сочетания показателей, выраженные с помощью математических операций. Например, можно использовать выражение ga:goal1completions/ga:sessions, чтобы запросить данные о количестве достигнутых целей за сеанс.

  • Диапазоны дат

    API позволяет с помощью одного запроса получить данные за два диапазона дат.

  • Когорты и общая ценность

    API обеспечивает широкие возможности создания отчетов по когортам и общей ценности.

  • Поддержка нескольких сегментов

    API позволяет с помощью одного запроса получить несколько сегментов.

Выбор версии Reporting API

При разработке нового приложения

Советуем использовать Reporting API версии 4 по следующим причинам:

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

Использование API версии 4 в существующих приложениях

  • Если вы используете в своем приложении Core Reporting API версии 3, выполните переход на версию 4, чтобы получить доступ к новым функциям.
  • Перейти на новую версию несложно, поскольку она поддерживает синтаксис сегментов и фильтров версии 3.

Использование API версии 3 и более ранних

  • В отличие от API версии 3 (Management API, Metadata API и пр.), Reporting API версии 4 требует отдельной клиентской библиотеки. Поэтому если вы создаете мобильное приложение и ограничены ресурсами устройств, то имеет смысл использовать API версии 3.
  • Поддержка более ранних версий API продолжится, но новые функции будут разрабатываться только для API 4.
  • Изменения в поддержке API версии 3 отражаются в журналах изменений.

Дополнительная информация

Краткие руководства

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

Сервисное приложение Установленное приложение Веб-приложение
Java Java
Python Python
PHP PHP
JavaScript

Чтобы узнать больше об использовании Reporting API версии 4, изучите статью Как создать отчет.