Google Analytics superProxy

Pete Frisella,Google Analytics(分析)开发倡导者 - 2013 年 7 月

本文档介绍 Google Analytics(分析)superProxy 的相关内容,说明了如何上手以及如何使用某些功能,并讨论了一些重要注意事项。

简介

Google Analytics(分析)superProxy 允许您公开分享自己的 Google Analytics(分析)报告数据。您可以使用该平台来创建自己的自定义信息中心和微件、将响应转换为各种格式、进行测试等等。

Google Analytics(分析)superProxy 可与 Core Reporting APIReal Time Reporting APIMulti-Channel Funnels Reporting API 配合使用。

功能亮点:

  • 公开分享您的 Google Analytics(分析)数据。
  • 使用代理轻松构建您自己的自定义信息中心。
  • 转换为 CSV、数据表、TSV。
  • 支持相对日期(例如,过去 7 天)。
  • 自动刷新报告数据。
  • 缓存 - 快速响应与高效的配额使用。

工作方式

创建 Google Analytics(分析)数据查询后,您可以分享一个新网址,以便其他用户公开访问该查询得到的特定报告数据。任何访问该网址的用户都有权访问这些报告数据,而无需请求任何授权。

例如,您可以创建一个查询,基于过去一周的网页浏览量来获取 10 大热门浏览器,另外创建一个查询来获取昨天的会话数,等等。您需要确定自己想公开哪些查询以及理想的数据更新频率,之后 Google Analytics(分析)superProxy 就会自动完成其余的工作。

提示:您可以使用 Query Explorer 生成报告,然后复制 Query URI 以便与 Google Analytics(分析)superProxy 配合使用。

设置和创建查询

Google Analytics(分析)superProxy 是一款 Web 应用,可在 Google App 引擎环境中运行。 您只需按照一组简单的说明即可下载并部署此应用。

管理用户

Google Analytics(分析)superProxy 包含一个简单的用户管理界面,您可以使用该界面添加用户。每位用户只能列出管理他们创建的 API 查询。

只有管理员能够管理用户。要添加新用户,请执行以下操作:

  1. 在 Google Analytics(分析)superProxy 管理员界面(例如 https://your-application-id.appspot.com/admin)中,点击管理用户按钮。
  2. Manage Users 页上,输入您要添加的用户的电子邮件地址,然后点击 Add User 按钮。此操作虽然添加了用户,但他们只有在激活其账户后,才能获得相应的访问权限。
  3. 让用户通过访问 /admin/activate 页面激活帐号。例如,https://your-application-id.appspot.com/admin/activate。他们需要登录到您添加的电子邮件地址对应的 Google 账号,才能激活激活。
  4. 用户成功激活账号后,就能访问“/admin”页面,授予 Google Analytics(分析)账号访问权限,然后开始创建自己的 API 查询。

管理员用户

您可以使用 App 引擎管理控制台添加 Google Analytics(分析)superProxy 管理员用户。通过此控制台添加的任何角色的任何用户都将成为管理员。

管理员能够列出管理任意用户的 API 查询。

网域限制

在某些情况下,您可能需要利用 Google Analytics(分析)superProxy 提供的功能,但您不想在某些用户或网域外公开任何数据。默认情况下,对于托管在 App 引擎上的免费应用,任何使用 Google 账户登录的人都有权访问您的公共端点。

如果您想进一步限制对自己应用的访问权限,则必须在 Google Analytics(分析)superProxy 上实施您自己的身份验证层,或者使用 G Suite。通过 G Suite,您可以将应用限制为仅供您的网域管理的用户使用。如需了解详情,请参阅配置应用的身份验证

配额方面的注意事项

Google Analytics(分析)superProxy 可从 cache/datastore 提供报告数据,帮助您节省配额。但是,如果自动刷新间隔设置得较短,仍有可能导致您快速消耗配置。为了避免这种情况,请确保您以合理的时间间隔刷新针对所请求的数据类型的查询。

App Engine

默认情况下,App 引擎应用的免费配额非常充足,通常足以处理大多数使用情况。但是,您可以启用结算功能来提高或移除默认的配额限制。有关详情,请参阅 App 引擎配额

社区与问题跟踪器

您可以在 Google Analytics(分析)superProxy 论坛中询问问题、分享想法,并获得关于您的项目的反馈。

此外,您还可以在问题跟踪器中报告和跟踪关于 Google Analytics(分析)superProxy 的问题和功能请求。