对 Google Analytics(分析)Data API 的实时方法的查询中支持的维度和指标。核心报告方法(例如 RunReport
)接受与实时方法不同的一组维度和指标。
维度
您可以在任何媒体资源的报告中请求以下维度。在 Dimension
资源的 name
字段中为报告响应中维度的列指定“API 名称”。
API 名称 | 界面名称 | 说明 |
---|---|---|
appVersion | 应用版本 | 应用的 versionName (Android) 或简短的软件包版本 (iOS)。 |
audienceId | 受众群体 ID | 受众群体的数字标识符。在报告日期范围内,用户按用户所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。 |
audienceName | 受众群体名称 | 受众群体的给定名称。在报告日期范围内,用户按用户所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。 |
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 | attribute_name 的用户级范围的自定义维度 |
Realtime API 不支持事件级范围的自定义维度。
指标
您可以在任何媒体资源的报告中请求以下指标。在 Metric
资源的 name
字段中为报告响应中指标列指定“API 名称”。
API 名称 | 界面名称 | 说明 |
---|---|---|
activeUsers | 活跃用户数 | 访问过您的网站或应用的去重用户数。 |
转化次数增幅 | 转化次数 | 转化事件的数量。事件会在收集时标记为转化;对事件转化标记所做的更改今后会生效。您可以在 Google Analytics(分析)中将任何事件标记为转化,有些事件(例如 first_open、purchase)会默认标记为转化。如需了解详情,请参阅转化简介。 |
eventCount | 事件数 | 事件的数量。 |
screenPageViews | 次观看 | 用户浏览的应用屏幕或网页的数量。对同一网页或屏幕的重复浏览也会计入。(screen_view 事件数 + page_view 事件数)。 |
Realtime API 不支持事件级范围的自定义指标。