Core Reporting API: обзор

В этом документе представлены общие сведения о Core Reporting API версии 3.0 для Google Analytics. Подробную информацию вы найдете в этом руководстве.

Введение

Core Reporting API обеспечивает доступ к данным большинства отчетов Google Analytics и позволяет:

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

Выбор версии

Мы рады представить новую версию Core Reporting API.

  • Мы рекомендуем использовать для создания новых приложений последнюю версию – 3.0.
  • Информацию по переходу на новую версию вы найдете в этом руководстве.

Начало работы

Не знаете, с чего начать? Ознакомьтесь с вводным руководством по Google Analytics API.

Из него вы узнаете, как использовать API, зарегистрировать приложение, реализовать авторизацию пользователей и выполнить другие типовые задачи, чтобы получить готовое к работе приложение.

Общая структура

Core Reporting API возвращает отчеты на основе статистических данных, собранных кодом отслеживания Google Analytics. Каждый отчет содержит определенные параметры и показатели. Кроме того, вы можете создавать специальные отчеты, запрашивая отдельные параметры и показатели.

Для работы с Core Reporting API важно знать с:

  1. Как отчеты связаны с пользователями и представлениями (профилями).
  2. Какова структура отчета и как создавать запросы.
  3. Как обрабатывать ответы API.

Отчеты, пользователи и представления (профили)

Чтобы запросить данные отчета, в приложении необходимо указать пользователя и представление (профиль), для которых они будут извлечены. Для этого в каждом запросе API передаются учетные данные пользователя. Представление (профиль) определяется уникальным идентификатором в иерархии Google Analytics.

Как узнать этот идентификатор?

  • С помощью методов Management API для работы с иерархией конфигурации.
  • Из URL самого отчета Google Analytics.
  • В аккаунте Google Analytics нажмите Администратор на панели меню и выберите аккаунт и ресурс, к которому относится представление. Затем в столбце Представление нажмите Настройки представления.

Запрос параметров и показателей

Отчет Google Analytics состоит из параметров и показателей. Показатели позволяют отслеживать отдельные действия пользователей с вашим ресурсом, например количество сеансов и просмотров страниц. С помощью параметров эти данные разбиваются по более общим категориям, таким как страна или тип браузера. В каждом запросе необходимо указывать параметры и показатели, которые будут включены в отчет.

Подробнее о том, какие параметры и показатели представлены в API и как задавать их в запросах

Работа с отчетами

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

Подробнее об ответе Core Reporting API

К началу

Квоты и прекращение поддержки

Google Analytics API обрабатывает миллионы операций. Чтобы защитить систему от перегрузки и равномерно распределить ее ресурсы, мы применяем определенные квоты. Подробнее…

О том, что делать при изменении столбцов, параметров и показателей Core Reporting API, читайте здесь. Как проверить неподдерживаемые столбцы с помощью Metadata API, вы узнаете из руководства разработчика.

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

Другие полезные ресурсы по работе с API:

К началу