Пит Фризелла, советник разработчиков Google Analytics, июль 2013 г.
Этот документ посвящен суперпрокси-серверу Google Analytics. В нем объясняется, как начать работу, как использовать определенные функции, а также обсуждаются важные вопросы.
Введение
Суперпрокси Google Analytics позволяет вам публиковать данные отчетов Google Analytics. Вы можете использовать его для создания собственных настраиваемых информационных панелей и виджетов, преобразования ответов в различные форматы, тестирования и многого другого.
Google Analytics superProxy работает с Core Reporting API , Real Time Reporting API и Multi-Channel Funnels Reporting API .
Особенности:
- Публично делитесь своими данными Google Analytics.
- Используйте прокси-сервер для управления своими собственными панелями мониторинга.
- Преобразование в CSV, таблицу данных, TSV.
- Поддерживаются относительные даты (например, последние 7 дней).
- Автоматически обновляет данные отчета.
- Кэширование - быстрые ответы и эффективное использование квоты.
Как это работает
Создайте запрос для ваших данных Google Analytics, и эти конкретные отчетные данные будут общедоступны по новому URL-адресу, которым вы можете поделиться. Любой, кто посетит URL-адрес, будет иметь доступ к данным отчетов без какой-либо авторизации.
Например, вы можете создать запрос для получения 10 лучших браузеров на основе просмотров страниц за последнюю неделю, один запрос для количества сеансов за вчерашний день и так далее. Вы сами решаете, какие запросы вы хотите сделать общедоступными и как часто вы хотите, чтобы данные обновлялись, а суперпрокси Google Analytics позаботится обо всем остальном.
Совет. Вы можете использовать Query Explorer для создания отчетов, а затем скопировать Query URI для использования с суперпрокси Google Analytics.
Настройка и создание запроса
Google Analytics superProxy — это веб-приложение, работающее в среде Google App Engine . Вы можете загрузить и развернуть это приложение, следуя простым инструкциям.
Управление пользователями
SuperProxy Google Analytics включает простой интерфейс управления пользователями, который можно использовать для добавления пользователей. Каждый пользователь сможет только перечислять и управлять запросами API, которые они создают.
Только администраторы могут управлять пользователями. Чтобы добавить нового пользователя:
- В административном интерфейсе Google Analytics superProxy (например,
https://your-application-id.appspot.com/admin) нажмите кнопку « Управление пользователями ». - На странице « Управление пользователями » введите адрес электронной почты пользователя, которого хотите добавить, и нажмите кнопку « Добавить пользователя ». Пользователь будет добавлен, но у него не будет доступа, пока он не активирует учетную запись.
- Попросите пользователя активировать свою учетную запись, посетив страницу
/admin/activate. Например,https://your-application-id.appspot.com/admin/activate. Они должны будут войти в учетную запись Google для электронной почты, которую вы добавили, чтобы активация работала. - После того, как пользователь успешно активирует свою учетную запись, он сможет посетить страницу
/admin, авторизовать доступ к своей учетной записи Google Analytics и начать создавать свои собственные запросы API.
Пользователи-администраторы
Пользователи-администраторы Google Analytics superProxy добавляются с помощью консоли администрирования App Engine. Любой пользователь, добавленный через эту консоль, с любой ролью, будет администратором.
Администраторы могут составлять список запросов API любых пользователей и управлять ими .
Ограничения домена
В некоторых случаях вы можете захотеть воспользоваться функциями, предлагаемыми суперпрокси Google Analytics, но вы не хотите публиковать какие-либо данные за пределами определенного набора пользователей или домена. По умолчанию для любого бесплатного приложения, размещенного в App Engine, любой пользователь, выполнивший вход с помощью учетной записи Google, может получить доступ к вашим общедоступным конечным точкам.
Если вы хотите еще больше ограничить доступ к своему приложению, вы должны внедрить собственный уровень аутентификации перед суперпрокси Google Analytics или использовать G Suite, который позволяет ограничить доступ к приложению пользователями, управляемыми вашим доменом. Дополнительные сведения см. в разделе Настройка аутентификации вашего приложения .
Квоты
Google Analytics superProxy помогает вам сэкономить квоту, предоставляя отчетные данные из кеша/хранилища данных. Однако установка коротких интервалов обновления может привести к быстрому расходованию квоты. Чтобы избежать этого, убедитесь, что вы обновляете запросы с разумным интервалом для типа запрашиваемых данных.
Механизм приложений
Пределы бесплатной квоты по умолчанию для приложений App Engine велики и, вероятно, будут достаточными для большинства случаев использования. Однако вы можете включить выставление счетов, чтобы увеличить или удалить лимиты по умолчанию. Дополнительные сведения см. в разделе Квоты App Engine .
Сообщество и система отслеживания проблем
Форум Google Analytics superProxy — это дискуссионная группа, где вы можете задавать вопросы, делиться идеями и получать отзывы о своих замечательных проектах.
В средстве отслеживания проблем вы можете сообщать и отслеживать проблемы и запросы функций для суперпрокси Google Analytics.