指标集简介

利用 Google Play Developer Reporting API,您可以访问与应用相关的指标、报告和时间轴信息。为了尽可能简化 API 的使用,指标集实现了指标访问的标准化。指标集是具有共同特性(例如新鲜度和粒度)的相关指标的逻辑分组,可以一起查询。指标集还包含多个可用于过滤或生成细分的维度。除非另有说明,否则所有指标都可以按所有可用维度进行细分或过滤。

时效性

每个指标集资源都提供了一个标准 GET 方法,用于检索最新可用数据点的日期和时间(称为新鲜度)。由于指标集可以支持多种粒度(每日、每小时),因此操作会返回每个支持粒度的一个新鲜度值。

您可以直接将新鲜度值用作查询时间范围内的端点。

数据查询

如需访问指标集中的数据,您应使用自定义 QUERY 方法发出查询。每个查询都必须指定粒度和时间范围。您应连同您希望访问的指标一起指定用于对汇总数据进行细分的维度。

在请求时间轴请求日期范围时应谨慎,使时间范围的大小与应用的大小和细分数量成反比。例如,大型应用应在单个查询请求中选择较少的天数,以避免因读取过多数据而导致查询超时。

可用的指标集

下面的索引列出了您可以请求的所有端点和相关数据。

指标集 说明 支持的指标
vitals.anrrate 包含 ANR 数据与使用情况数据相结合,可生成独立于用户数的标准化指标。 anrRate (google.type.Decimal):在汇总期间至少遇到一次 ANR 的不同用户所占的百分比。
anrRate7dUserWeighted (google.type.Decimal):7 天(含日期)内 arRate 指标的用户加权平均值。
anrRate28dUserWeighted (google.type.Decimal):arRate 指标在 28 天(含日期)内的用户加权平均值。
userPerceivedAnrRate (google.type.Decimal):在汇总时段内,遇到过至少一次用户感知到的 ANR 的唯一身份用户数所占的百分比。目前,系统会统计“输入调度”的匿名 ANR。
userPerceivedAnrRate7dUserWeighted (google.type.Decimal):截至 7 天(含)的 7 天内,用户 PerceivedAnrRate 指标的用户加权平均值。
userPerceivedAnrRate28dUserWeighted (google.type.Decimal):userPerceivedAnrRate 指标在截至 28 天(含该日期)的按用户加权得出的平均值。
distinctUsers (google.type.Decimal):汇总期间有可用数据的大致用户数。
vitals.crashrate 包含崩溃数据和使用情况数据,以生成独立于用户数的标准化指标。 crashRate (google.type.Decimal):汇总期间至少发生一次崩溃的去重用户数所占的百分比。
crashRate7dUserWeighted (google.type.Decimal):截至 7 天(含该日期)的 7 天内用户发生崩溃率指标的平均值。
crashRate28dUserWeighted (google.type.Decimal):截至 28 天(含该日期)的 crashRate 指标的用户加权平均值。
userPerceivedCrashRate (google.type.Decimal):汇总期间在应用活跃期间遇到至少 1 次崩溃的唯一身份用户所占的百分比。
userPerceivedCrashRate7dUserWeighted (google.type.Decimal):截至 7 天(含)的 7 天内,用户 PerceivedCrashRate 指标的用户加权平均值。
userPerceivedCrashRate28dUserWeighted (google.type.Decimal):截至 28 天(包含该日期)的 userPerceivedCrashRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal):汇总期间有可用数据的大致用户数。
vitals.excessivewakeuprate 包含 AlarmManager 唤醒计数数据与进程状态数据,以生成独立于用户数的标准化指标。 exoveriveWakeupRate (google.type.Decimal):汇总期间每小时唤醒次数超过 10 次的唯一身份用户所占的百分比。exoveriveWakeupRate7dUserWeighted (google.type.Decimal):截至 7 天(含该日期)的 7 天内,用户经过的 OverWakeupRate 指标的加权平均值。
exoveriveWakeupRate28dUserWeighted (google.type.Decimal):在超过 28 天(含该日期)后,overWakeupRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal):汇总期间有可用数据的大致用户数。
vitals.stuckbackgroundwakelockrate 包含 PowerManager 唤醒锁定时长数据与进程状态数据,以生成独立于用户计数的标准化指标。 stuckBgWakelockRate (google.type.Decimal):汇总期间唤醒唤醒持续 1 小时以上的不同用户所占的百分比。stuckBgWakelockRate7dUserWeighted (google.type.Decimal):截至 7 天(含该日期)的 7 天内卡住的 BgWakelockRate 指标的用户加权平均值。
stuckBgWakelockRate28dUserWeighted (google.type.Decimal):截至 28 天(含该日期)内卡住的 BgWakelockRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal):汇总期间有可用数据的大致用户数。
vitals.slowstartuprate 包含按应用启动类型(冷、温、热)细分的缓慢应用启动数据。 slowStartRate (google.type.Decimal):汇总期间出现慢速启动事件的唯一身份用户所占的百分比。slowStartRate7dUserWeighted (google.type.Decimal):截至 7 天(含该日期)的 7 天内,lowStartRate 指标的用户加权平均值。
slowStartRate28dUserWeighted (google.type.Decimal):截至 28 天(含日期)为止的慢速启动指标的用户加权平均值。
distinctUsers (google.type.Decimal):汇总期间有可用数据的大致用户数。
vitals.errors.counts 包含非标准化错误报告计数。 请注意:此资源目前仅在 v1 Alpha 版 API 中提供。
errorReportCount (google.type.Decimal):为应用收到的各个错误报告的绝对数量。

尺寸

每个指标集都支持一组不同的维度,可用于过滤和细分。请查看下面的维度索引,获取 API 中提供的维度列表。

维度 说明
versionCode 捕获数据时用户设备上运行的应用的版本号。此维度的字符串值可以解析为整数。如需详细了解应用版本控制在 Android 平台上的工作原理,请参阅此处
countryCode 用户所在的国家/地区基于其 IP 地址的标识符,以两个字母的 ISO-3166 代码表示(例如,美国代表美国)。

设备尺寸

这些是特定于设备及其软件和硬件特征的尺寸。

维度 说明
apiLevel 捕获数据时用户设备上运行的 Android 的 API 级别。此维度的字符串值可以解析为整数。请参阅此处,了解 Android 版本列表以及这些版本与 API 级别之间的对应关系。
deviceModel 特定设备型号的标识符,由 Play 管理中心设备目录定义。
deviceType 特定设备外形规格的标识符,用于 Play 管理中心设备目录。
deviceRamBucket 设备的 RAM(以 MB 为单位),存储在存储分区中(3GB、4GB 等)。
deviceSocMake 设备的主要系统芯片(例如,三星请点击此处
deviceSocModel 设备的主要系统芯片芯片的型号名称,例如:“Exynos 2100”。请点击此处
deviceCpuMake 设备的 CPU 品牌,例如Qualcomm。
deviceCpuModel 设备的 CPU 型号,例如“Kryo 240”。
deviceGpuMake 设备的 GPU,例如:ARM。
deviceGpuModel 设备 GPU 的型号,例如马里。
deviceGpuVersion 设备 GPU 的版本,例如,T750。
deviceVulkanVersion Vulkan 版本的设备,例如“4198400”。
deviceGlEsVersion 设备的 OpenGL ES 版本,例如,“196610”。
deviceScreenSize 设备的屏幕尺寸,例如,一般,庞大。
deviceScreenDpi 设备的屏幕密度,例如 mdpi、hdpi。