Обзор API данных Google Analytics

Вы можете использовать API данных для программного доступа к данным отчетов Google Analytics. Этот API несовместим с устаревшими свойствами Universal Analytics.

Узнайте больше о свойствах Google Analytics .

Вот несколько примеров того, как вы можете создавать отчеты, используя Google Analytics Data API версии 1:

  • Сколько ежедневных активных пользователей было у вашего Android-приложения за последнюю неделю?
  • Сколько просмотров получили 10 самых популярных страниц вашего сайта за последние 28 дней?
  • Сколько активных пользователей в каждой стране было у вашего iOS-приложения за последние 30 минут?

Вы также можете использовать API данных Google Analytics версии 1 для выполнения следующих действий:

  • Создавайте пользовательские панели мониторинга для отображения данных Google Analytics.
  • Автоматизируйте сложные задачи по составлению отчетов, чтобы сэкономить время.
  • Интегрируйте данные Google Analytics с другими бизнес-приложениями.

Согласованность данных и идентификация отчетности

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

Чтобы узнать больше о том, как различные пространства идентификации могут влиять на ваши отчеты, см. раздел «Идентификация в отчетах» .

Начать

Для начала ознакомьтесь с руководством по быстрому запуску клиентской библиотеки . Существуют клиентские библиотеки на Java, Python, Node.js и других языках, которые упростят вашу реализацию.

Доступные методы

Ниже приведён список методов Data API. Для получения более подробной информации см. справочную документацию .

  • Метод runReport возвращает настраиваемый отчет на основе данных о событиях Google Analytics и является предпочтительным методом для простых запросов к отчету .
  • batchRunReports — это пакетная версия метода runReport, позволяющая создавать несколько отчетов с помощью одного вызова API.
  • Метод runPivotReport возвращает настраиваемый сводной отчет на основе данных о событиях Google Analytics. Сводные отчеты — это более продвинутый и выразительный формат, чем обычные отчеты. Каждый сводной отчет описывает видимые столбцы и строки измерений в ответе.
  • batchRunPivotReports — это пакетная версия метода runPivotReport, позволяющая создавать несколько отчетов с помощью одного вызова API.
  • Метод getMetadata возвращает метаданные для измерений и метрик, доступных в методах отчетности. Используется для изучения измерений и метрик. Ответ этого метода также включает пользовательские измерения и метрики, доступные для указанного свойства Google Analytics.
  • Метод checkCompatibility перечисляет измерения и метрики, которые можно добавить в запрос отчета, сохраняя при этом совместимость.
  • Метод runRealtimeReport возвращает настраиваемый отчет с данными о событиях в реальном времени для вашего ресурса. События отображаются в отчетах в реальном времени через несколько секунд после их отправки в Google Analytics. Отчеты в реальном времени показывают события и данные об использовании за периоды времени от настоящего момента до 30 минут назад (до 60 минут для ресурсов Google Analytics 360).
  • properties.audienceExports группа методов, позволяющих создавать экспорты аудитории , содержащие снимок пользователей в аудитории.
  • properties.recurringAudienceLists (Предварительная версия) Группа методов, позволяющих управлять повторяющимися экспортами аудиторий. Повторяющийся экспорт аудитории создает новые списки аудиторий каждый день.
  • runFunnelReport (Предварительная версия) Этот метод возвращает настраиваемый отчет по воронке продаж на основе данных о событиях из Google Analytics. Исследование воронки продаж позволяет визуализировать шаги, которые пользователи предпринимают для выполнения задачи, и быстро увидеть, насколько успешно или неуспешно они справляются с каждым этапом.

Поддерживаемые параметры и метрики

Список всех параметров и метрик, поддерживаемых API данных, см. в документации по схеме API .