Суперпрокси Google Аналитики

Пит Фризелла, адвокат разработчиков Google Analytics – июль 2013 г.

Этот документ посвящен суперпрокси Google Analytics. В нем объясняется, как начать работу, использовать определенные функции, а также обсуждаются важные соображения.

Введение

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

Суперпрокси Google Analytics работает с Core Reporting API , API отчетов в реальном времени и 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 . Вы можете загрузить и развернуть это приложение, следуя простому набору инструкций.

Управление пользователями

Суперпрокси Google Analytics включает в себя простой интерфейс управления пользователями, который вы можете использовать для добавления пользователей. Каждый пользователь сможет только перечислять и управлять запросами API, которые он создает.

Только администраторы могут управлять пользователями. Чтобы добавить нового пользователя:

  1. В интерфейсе администратора Google Analytics superProxy (например, https://your-application-id.appspot.com/admin ) нажмите кнопку «Управление пользователями» .
  2. На странице «Управление пользователями» введите адрес электронной почты пользователя, которого хотите добавить, и нажмите кнопку «Добавить пользователя» . Пользователь будет добавлен, но у него не будет доступа, пока он не активирует учетную запись.
  3. Попросите пользователя активировать свою учетную запись, посетив страницу /admin/activate . Например, https://your-application-id.appspot.com/admin/activate . Чтобы активация работала, им необходимо будет войти в учетную запись Google для добавленного вами адреса электронной почты.
  4. Как только пользователь успешно активирует свою учетную запись, он сможет посетить страницу /admin , авторизовать доступ к своей учетной записи Google Analytics и начать создавать свои собственные запросы API.

Администраторы пользователей

Пользователи-администраторы Google Analytics superProxy добавляются с помощью консоли администрирования App Engine. Любой пользователь, добавленный через эту консоль, любой роли будет администратором.

Администраторы могут составлять список запросов к API любых пользователей и управлять ими .

Ограничения домена

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

Если вы хотите еще больше ограничить доступ к своему приложению, вам необходимо реализовать собственный уровень аутентификации перед Google Analytics SuperProxy или использовать G Suite, который позволяет вам ограничить доступ к приложению пользователями, управляемыми вашим доменом. Подробности см. в разделе Настройка аутентификации вашего приложения .

Вопросы квот

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

Механизм приложений

Бесплатные квоты по умолчанию для приложений App Engine щедры и, вероятно, будут достаточными для большинства случаев использования. Однако вы можете включить выставление счетов, чтобы увеличить или удалить ограничения по умолчанию. Подробности см. в разделе «Квоты App Engine» .

Сообщество и отслеживание проблем

Форум Google Analytics superProxy – это дискуссионная группа, где вы можете задавать вопросы, делиться идеями и получать отзывы о своих замечательных проектах.

Система отслеживания проблем — это место, где вы можете сообщать и отслеживать проблемы и запросы функций для суперпрокси Google Analytics.