Google Analytics（分析）superProxy

Pete Frisella，Google Analytics（分析）开发技术推广工程师 - 2013 年 7 月

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

简介

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

Google Analytics（分析）superProxy 可与 Core Reporting API、Real Time Reporting API 和 Multi-Channel Funnels Reporting API 配合使用。

功能亮点：

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

工作方式

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

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

提示：您可以使用查询浏览器生成报告，然后复制 Query URI 以用于 Google Analytics（分析）superProxy。

设置和创建查询

Google Analytics（分析）superProxy 是一款在 Google App Engine 环境中运行的 Web 应用。您可以按照一组简单的说明下载和部署此应用。

管理用户

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

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

  1. 在 Google Analytics（分析）superProxy 管理员界面（例如 https://your-application-id.appspot.com/admin）中，点击 Manage Users 按钮。
  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，它允许您将应用限制为仅供您的网域管理的用户使用。如需了解详情，请参阅配置应用的身份验证。

配额方面的注意事项

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

App Engine

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

社区与问题跟踪器

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

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