Здесь представлены общие сведения о 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, изучите статью Как создать отчет.