Что такое основной API отчетности — обзор

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

Введение

API Google Analytics Core Reporting предоставляет вам доступ к большинству данных отчетов в Google Analytics. С помощью Core Reporting API вы можете:

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

Выбор версии

Недавно мы запустили новую версию Core Reporting API.

  • Создаете новое приложение? – Мы рекомендуем использовать последнюю версию 3.0.
  • Используете устаревшую версию 2.3? – Прочтите Руководство по миграции , чтобы узнать, как обновить приложение для использования новой версии.

Начиная

Хотите начать прямо сейчас? Прочтите руководство по API Hello Analytics .

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

Концептуальный обзор

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

В основе Core Reporting API лежат три фундаментальные концепции:

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

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

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

Есть несколько способов узнать идентификатор вашего представления (профиля).

  • Ваше приложение может использовать API управления для обхода иерархии конфигурации управления и получения идентификатора представления (профиля).
  • В URL-адресе каждого отчета Google Analytics.
  • В Google Analytics нажмите «Администратор» в строке меню. Выберите аккаунт и ресурс, которому принадлежит представление. В столбце «Представление» нажмите «Настройки просмотра» , чтобы получить идентификатор представления.

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

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

Используйте интерактивное справочное руководство по параметрам и метрикам, чтобы изучить все параметры и метрики, предоставляемые через API. Также прочтите Справочное руководство по Core Reporting API , чтобы узнать, как указывать измерения и показатели в запросе API.

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

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

Прочтите Справочное руководство по Core Reporting API для получения дополнительной информации об ответе API.

Вернуться к началу

Политика квот и устаревания

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

Подробную информацию о том, как обрабатываются изменения в столбцах Core Reporting API (т. е. параметрах и показателях), можно найти в Политике устаревания данных . Чтобы узнать, как можно использовать Metadata API для проверки устаревших столбцов, см. Руководство для разработчиков Metadata API .

Следующие шаги

Теперь, когда вы понимаете, как работает API, у нас есть несколько ресурсов, которые помогут вам начать работу:

  • Прочтите Руководство разработчика , чтобы узнать, как работать с API.
  • Используйте интерактивный инструмент Query Explorer , чтобы визуально создавать запросы и просматривать ответы через API.
  • Прочтите статью «Общие запросы» , в которой перечислены несколько наиболее распространенных запросов к Core Reporting API.
  • В справочнике «Параметры и показатели» приведен список всех данных, доступных через API.
  • Посетите страницу «Библиотеки и примеры» , чтобы найти список всех доступных клиентских библиотек, которые можно использовать с этим API.

Вернуться к началу