В этом документе описывается API отчетов Google Analytics в реальном времени. Подробную информацию об API можно найти в справочнике API .
Введение
API отчетов в реальном времени позволяет вам запрашивать данные в реальном времени — например, активность в реальном времени на вашем ресурсе — для аутентифицированного пользователя.
Вы можете использовать API отчетов в реальном времени, чтобы:
- Отобразите активных зрителей страницы и создайте ощущение срочности у пользователей, просматривающих товар с ограниченным запасом.
- Отображение самого популярного контента, например 10 самых активных страниц.
- Создайте и отобразите панель мониторинга в реальном времени.
Суперпрокси Google Analytics
Используйте Google Analytics superProxy для обработки многих деталей реализации работы с API Google Analytics по аутентификации, кэшированию и преобразованию ответов API в форматы, используемые непосредственно с библиотеками визуализации и диаграмм.
Концептуальный обзор
Фундаментальными концепциями, лежащими в основе API отчетов в реальном времени, являются:
- Как отчеты связаны с пользователями и представлениями (профилями).
- Структура отчета и способы построения запросов.
- Работа с ответом API.
Отчеты, пользователи и представления (профили)
Прежде чем пользователи смогут использовать ваше приложение для запроса данных своего отчета из представления (профиля), вы должны:
- Включите API Google Analytics.
- Создайте учетные данные для вашего приложения для доступа к API.
- Поместите учетные данные в свое приложение.
При использовании вашего приложения для запроса данных отчета пользователям необходимо авторизовать его для доступа к данным от их имени.
Представление (профиль) идентифицируется идентификатором представления (профиля). Представления (профили), среди других объектов, являются частью иерархии учетных записей, пользователей, свойств и представлений Google Analytics. Ваше приложение может использовать Management API для обхода этой иерархии и получения представления (профиля).
Запрос параметров и показателей
Вы запрашиваете у API данные отчета Google Analytics, состоящие из параметров и показателей. Метрики — это отдельные измерения активности пользователей, например количество активных пользователей на ресурсе прямо сейчас. В измерениях показатели разбиваются по некоторым общим критериям, таким как источники трафика, географическое местоположение, информация о странице и т. д.
Используйте Справочное руководство по измерениям и метрикам , чтобы изучить все параметры и метрики, доступные через API. Также прочтите Справочное руководство по API отчетов в реальном времени , чтобы узнать, как указывать измерения и метрики в запросе API.
Работа с отчетами
Данные, возвращаемые API, можно рассматривать как таблицу с заголовком и списком строк. Каждый ответ API состоит из заголовка, описывающего имя и тип данных каждого столбца. Ответ также содержит список строк, где каждая строка представляет собой список ячеек с данными в том же порядке, что и заголовки. Прочтите Справочное руководство по API отчетов в реальном времени , чтобы получить дополнительную информацию об ответе API.
Политика квот
API отчетов в реальном времени обрабатывает миллионы операций запроса данных. Мы используем систему квот, чтобы защитить систему от получения большего количества операций, чем она может обработать, а также обеспечить справедливое распределение системных ресурсов. Для получения более подробной информации прочтите руководство по лимитам и квотам .
Следующие шаги
Теперь, когда вы понимаете, как работает API, приступим:
- Прочтите Руководство разработчика , чтобы узнать, как работать с API.
- Список всех данных, доступных через API, можно найти в Справочном руководстве по параметрам и показателям .
- Посетите страницу «Библиотеки и примеры» , чтобы найти список всех доступных клиентских библиотек, которые вы можете использовать с API.