实时维度和指标

对 Google 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。要确定报告中的数据流类型,请同时使用 platform 和 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 的用户级范围的自定义维度

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

指标

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

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

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