Обзор Google Analytics Data API

Data API позволяет получать программный доступ к данным отчетов Google Аналитики.

Подробнее о ресурсах Google Аналитики…

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

Вот несколько примеров отчетов, которые можно создать с помощью Google Analytics Data API v1:

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

С помощью Google Analytics Data API v1 также можно:

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

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

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

Подробнее о том, как способы идентификации влияют на отчеты…

Начать

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

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

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

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

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

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