概览

本文说明了 Google Analytics(分析)Real Time Reporting API。有关该 API 的详细参考信息,请参阅 API 参考

简介

利用 Real Time Reporting API,您可以请求经身份验证的用户的实时数据,例如在您的媒体资源上的实时活动。

您可以使用 Real Time Reporting API 执行以下操作:

  • 显示正在浏览网页的用户人数,针对搜寻库存有限的商品的用户,营造一种机不可失、失不再来的氛围。
  • 显示最热门的内容,比如访问量最高的 10 个页面。
  • 创建和显示实时信息中心。

Google Analytics superProxy

Google Analytics superProxy 可用于处理有关使用 Google Analytics(分析)API 的许多实现细节,例如身份验证、缓存以及将 API 响应转换为可直接与可视化库和图表库结合使用的格式。

概念概览

Real Time Reporting API 的基本概念包括:

  • 报告与用户和数据视图(配置文件)的关联方式。
  • 报告的结构以及创建查询的方法。
  • 处理 API 响应。

报告、用户和数据视图(配置文件)

您必须先进行以下操作,然后用户才可以使用您的应用从数据视图(配置文件)请求其报告数据:

  1. 启用 Google Analytics(分析)API。
  2. 为应用访问 API 创建凭据
  3. 将凭据置入应用中。

如果使用您的应用请求他们的报告数据,用户需要授权该应用代表他们访问数据。

数据视图(配置文件)通过数据视图(配置文件)ID 进行识别。数据视图(配置文件)及其他实体均包含在 Google Analytics(分析)帐户、用户、媒体资源和数据视图的层次结构中。您的应用可以使用 Management API 遍历这一层次结构并获取数据视图(配置文件)。

查询维度和指标

您可以向 API 查询 Google Analytics(分析)报告数据,这些数据由维度和指标组成。指标就是对用户活动(例如媒体资源上的当前活跃用户数)的各个测量结果。维度可按一些常见的标准(例如流量来源、地理位置、网页信息,等等)对指标进行细分。

使用维度和指标参考指南来查看该 API 提供的所有维度和指标。另外,参阅 Real Time Reporting API 参考指南,可了解如何在 API 查询中指定维度和指标。

处理报告

从 API 中返回的数据可被视为包含标题和行列表的表格。每个 API 响应均包含一个说明每列名称和数据类型的标题。响应还包含行的列表,其中每一行均是包含数据的单元格的列表,这些单元格的顺序与标题的顺序相同。有关 API 响应的详情,请参阅 Real Time Reporting API 参考指南

配额政策

Real Time Reporting API 需要处理数以百万计的数据查询操作。为避免系统收到的操作量超出其处理能力,并确保公平分配系统资源,我们采用了配额机制。有关详情,请参阅限制和配额

后续步骤

您已经了解了 API 的工作原理,要开始操作,请: