В этом документе представлены общие сведения о 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 важно знать с:
- Как отчеты связаны с пользователями и представлениями (профилями).
- Какова структура отчета и как создавать запросы.
- Как обрабатывать ответы 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:
- Руководство разработчика.
- Интерактивный инструмент для создания запросов и просмотра ответов с помощью API.
- Список типовых запросов к Core Reporting API.
- Справка по параметрам и показателям, доступным с помощью API.
- Библиотеки и примеры кода.