实时维度和指标

Analytics Data API 的 Realtime 方法支持在查询中使用的维度和指标。核心报告方法（例如 RunReport）接受的维度和指标与实时方法不同。

维度

您可以在任何媒体资源的报告中请求以下维度。在 Dimension 资源的 name 字段中，为报告响应中的维度列指定“API 名称”。

API 名称	界面名称	说明
appVersion	应用版本	应用的 versionName (Android) 或简短的软件包版本 (iOS)。
audienceId	受众群体 ID	受众群体的数字标识符。在报告的日期范围内，用户按其所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。
audienceName	受众群体名称	受众群体的指定名称。在报告的日期范围内，用户按其所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。
audienceResourceName	受众群体资源名称	相应受众群体的资源名称。资源名称包含集合标识符和资源标识符，用于唯一标识资源；如需了解详情，请参阅资源名称。
city	城市	发起用户活动的城市。
cityId	城市 ID	用户发起活动时所处城市的地理位置 ID，根据用户的 IP 地址得出。
country	国家/地区	发起用户活动的国家/地区。
countryId	国家/地区 ID	用户发起活动时所处的国家/地区的地理位置 ID，根据用户的 IP 地址得出。根据 ISO 3166-1 alpha-2 标准设置格式。
deviceCategory	设备类别	设备类型：桌面设备、平板电脑或移动设备。
eventName	事件名称	事件名称。
minutesAgo	实时（若干分钟前）	相应事件的收集时间距离现在的时间（以分钟为单位）。00 表示当前分钟，01 表示上一分钟。
platform	平台	指您的应用或网站在哪个平台上运行；例如 Web、iOS 或 Android。如需确定报告中的视频流类型，请同时使用平台和 streamId。
streamId	数据流 ID	应用或网站的数字数据流标识符。
streamName	数据流名称	应用或网站的数据流名称。
unifiedScreenName	网页标题和屏幕名称	记录事件的网页标题（网站）或屏幕名称（应用）。

自定义维度

Realtime Data API 可以根据用户级范围的自定义维度创建报告。如需详细了解自定义维度，请参阅自定义用户属性。自定义维度通过维度参数名称和范围在 API 报告请求中指定。例如，在 Data API 请求中包含 "customUser:last_level"，以针对参数名称为 "last_level" 的用户级范围自定义维度创建报告。如果相应媒体资源尚未注册此用户级自定义维度，此 API 请求将失败。

以下是自定义维度的一般语法。您可以查询 Metadata API 方法，以列出媒体资源的所有自定义维度。

通用 API 名称	说明
customUser:parameter_name	parameter_name 的用户级范围的自定义维度。

实时 API 不支持事件级范围的自定义维度。

指标

您可以在任何媒体资源的报告中请求以下指标。在 Metric 资源的 name 字段中指定报告响应中指标列的“API 名称”。

API 名称	界面名称	说明
activeUsers	活跃用户数	访问过您的网站或应用的去重用户数。
eventCount	事件数	事件数量。
keyEvents	关键事件	关键事件数。将事件标记为关键事件会从创建之时起影响报告，但不会更改历史数据。您可以在 Google Analytics 中将任何事件标记为关键事件，有些事件（例如 first_open 或 purchase）默认情况下会被标记为关键事件。
screenPageViews	观看次数	用户浏览的应用界面或网页的数量。对同一网页或屏幕的重复浏览也会计入。（screen_view 事件数 + page_view 事件数）。

实时 API 不支持事件级范围的自定义指标。