API Google Play Developer Reporting cho phép bạn truy cập vào các chỉ số, báo cáo và thông tin về dòng thời gian của ứng dụng. Để giúp việc sử dụng API trở nên đơn giản nhất có thể, bộ chỉ số sẽ chuẩn hoá quyền truy cập vào chỉ số. Bộ chỉ số là một nhóm logic gồm các chỉ số liên quan có chung thuộc tính (chẳng hạn như độ mới mẻ và mức độ chi tiết) và có thể được truy vấn cùng nhau. Bộ chỉ số cũng chứa một số phương diện mà bạn có thể dùng để lọc hoặc tạo thông tin chi tiết. Trừ phi có quy định khác, tất cả chỉ số đều có thể được phân tích hoặc lọc theo tất cả phương diện hiện có.
Độ mới mẻ
Mỗi tài nguyên bộ chỉ số đều cung cấp một phương thức GET tiêu chuẩn để truy xuất
ngày và giờ của điểm dữ liệu mới nhất hiện có, được gọi là độ mới mẻ. Vì một bộ chỉ số có thể
hỗ trợ nhiều mức độ chi tiết (hằng ngày, hằng giờ), nên thao tác này sẽ trả về một giá trị độ mới mẻ
cho mỗi mức độ chi tiết được hỗ trợ.
Bạn có thể sử dụng trực tiếp giá trị độ mới mẻ làm điểm cuối trong phạm vi thời gian truy vấn.
Truy vấn dữ liệu
Để truy cập vào dữ liệu trong một bộ chỉ số, bạn nên sử dụng phương thức QUERY tuỳ chỉnh để đưa ra truy vấn.
Mỗi truy vấn phải chỉ định một mức độ chi tiết và một phạm vi thời gian. Cùng với các chỉ số mà bạn muốn
truy cập, bạn nên chỉ định các phương diện cần dùng để phân tích các giá trị tổng hợp.
Bạn cần thận trọng khi yêu cầu dòng thời gian để yêu cầu phạm vi ngày, sao cho kích thước của phạm vi thời gian tỷ lệ nghịch với kích thước của ứng dụng và số lượng thông tin chi tiết. Ví dụ: một ứng dụng lớn nên chọn ít ngày hơn trong một yêu cầu truy vấn để tránh tình trạng hết thời gian chờ truy vấn do đọc quá nhiều dữ liệu.
Các bộ chỉ số hiện có
Chỉ mục bên dưới liệt kê tất cả điểm cuối và dữ liệu liên quan mà bạn có thể yêu cầu.
| Bộ chỉ số | Mô tả | Chỉ số được hỗ trợ |
|---|---|---|
vitals.anrrate |
Chứa dữ liệu ANR kết hợp với dữ liệu sử dụng để tạo ra một chỉ số chuẩn hoá độc lập với số lượng người dùng. |
anrRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp
gặp phải ít nhất một lỗi ANR. anrRate7dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số anrRate trong 7 ngày cho đến và bao gồm cả ngày. anrRate28dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số anrRate trong 28 ngày cho đến và bao gồm cả ngày. userPerceivedAnrRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp gặp phải ít nhất một lỗi ANR mà người dùng nhận thấy. Hiện tại, chỉ có lỗi ANR "Gửi dữ liệu đầu vào" được tính. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số userPerceivedAnrRate trong 7 ngày cho đến và bao gồm cả ngày. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số userPerceivedAnrRate trong 28 ngày cho đến và bao gồm cả ngày. distinctUsers (google.type.Decimal): Số lượng người dùng gần đúng mà dữ liệu có sẵn trong khoảng thời gian tổng hợp. |
vitals.crashrate |
Chứa dữ liệu sự cố kết hợp với dữ liệu sử dụng để tạo ra một chỉ số chuẩn hoá độc lập với số lượng người dùng. |
crashRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp
gặp phải ít nhất một sự cố. crashRate7dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số crashRate trong 7 ngày cho đến và bao gồm cả ngày. crashRate28dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số crashRate trong 28 ngày cho đến và bao gồm cả ngày. userPerceivedCrashRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp gặp phải ít nhất một sự cố khi ứng dụng đang được sử dụng. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số userPerceivedCrashRate trong 7 ngày cho đến và bao gồm cả ngày. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số userPerceivedCrashRate trong 28 ngày cho đến và bao gồm cả ngày. distinctUsers (google.type.Decimal): Số lượng người dùng gần đúng mà dữ liệu có sẵn trong khoảng thời gian tổng hợp. |
vitals.lmkrate
|
Chứa dữ liệu LMK (tắt ứng dụng do thiếu bộ nhớ) kết hợp với dữ liệu sử dụng để tạo ra một chỉ số chuẩn hoá độc lập với số lượng người dùng. |
userPerceivedLmkRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp gặp phải ít nhất một lỗi LMK (tắt ứng dụng do thiếu bộ nhớ) khi họ đang tích cực sử dụng ứng dụng của bạn. Một ứng dụng được coi là đang được sử dụng nếu ứng dụng đó đang hiển thị bất kỳ hoạt động nào hoặc đang thực thi bất kỳ dịch vụ trên nền trước nào. userPerceivedLmkRate7dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số userPerceivedLmkRate trong 7 ngày cho đến và bao gồm cả ngày. userPerceivedLmkRate28dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số userPerceivedLmkRate trong 28 ngày cho đến và bao gồm cả ngày. distinctUsers (google.type.Decimal): Số lượng người dùng gần đúng mà dữ liệu có sẵn trong khoảng thời gian tổng hợp. |
vitals.excessivewakeuprate |
Chứa dữ liệu về số lần đánh thức AlarmManager kết hợp với dữ liệu về trạng thái quy trình để tạo ra một chỉ số chuẩn hoá độc lập với số lượng người dùng. |
excessiveWakeupRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong
khoảng thời gian tổng hợp có hơn 10 lần đánh thức mỗi giờ.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của
chỉ số excessiveWakeupRate trong 7 ngày cho đến và bao gồm cả ngày. excessiveWakeupRate28dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số excessiveWakeupRate trong 28 ngày cho đến và bao gồm cả ngày. distinctUsers (google.type.Decimal): Số lượng người dùng gần đúng mà dữ liệu có sẵn trong khoảng thời gian tổng hợp. |
vitals.stuckbackgroundwakelockrate |
Chứa dữ liệu về thời lượng khoá đánh thức PowerManager kết hợp với dữ liệu về trạng thái quy trình để tạo ra một chỉ số chuẩn hoá độc lập với số lượng người dùng. |
stuckBgWakelockRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp có một khoá đánh thức được giữ ở chế độ nền trong hơn 1 giờ.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng
của chỉ số stuckBgWakelockRate trong 7 ngày cho đến và bao gồm cả ngày. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số stuckBgWakelockRate trong 28 ngày cho đến và bao gồm cả ngày. distinctUsers (google.type.Decimal): Số lượng người dùng gần đúng mà dữ liệu có sẵn trong khoảng thời gian tổng hợp. |
vitals.slowstartrate |
Chứa dữ liệu về việc khởi động ứng dụng chậm được phân tích theo loại khởi động ứng dụng (khởi động nguội, khởi động ấm, khởi động nóng). |
slowStartRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong
khoảng thời gian tổng hợp có một sự kiện khởi động chậm.
slowStartRate7dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng
của chỉ số slowStartRate trong 7 ngày cho đến và bao gồm cả ngày. slowStartRate28dUserWeighted (google.type.Decimal): Giá trị trung bình có trọng số theo người dùng của chỉ số slowStartRate trong 28 ngày cho đến và bao gồm cả ngày. distinctUsers (google.type.Decimal): Số lượng người dùng gần đúng mà dữ liệu có sẵn trong khoảng thời gian tổng hợp. |
vitals.errors.counts |
Chứa số lượng báo cáo lỗi chưa được chuẩn hoá. |
Xin lưu ý: tài nguyên này hiện chỉ có trong phiên bản alpha v1 của API. errorReportCount (google.type.Decimal): Số lượng tuyệt đối của từng báo cáo lỗi đã nhận được cho một ứng dụng. |
Phương diện
Mỗi bộ chỉ số đều hỗ trợ một tập hợp riêng biệt gồm các phương diện để lọc và phân tích. Hãy xem chỉ mục phương diện bên dưới để biết danh sách các phương diện có trong API.
| Phương diện | Mô tả |
|---|---|
versionCode |
Mã phiên bản của ứng dụng đang chạy trên thiết bị của người dùng tại thời điểm thu thập dữ liệu. Giá trị chuỗi của phương diện này có thể được phân tích cú pháp dưới dạng số nguyên. Xem tại đây để biết thêm thông tin chi tiết về cách hoạt động của tính năng kiểm soát phiên bản ứng dụng trên Android. |
countryCode |
Mã nhận dạng quốc gia hoặc khu vực của người dùng dựa trên địa chỉ IP của họ, được biểu thị dưới dạng mã ISO-3166 gồm 2 chữ cái (ví dụ: US cho Hoa Kỳ). |
Phương diện thiết bị
Đây là các phương diện dành riêng cho thiết bị và các đặc điểm về phần mềm và phần cứng của thiết bị.
| Phương diện | Mô tả |
|---|---|
apiLevel |
Cấp độ API của Android đang chạy trên thiết bị của người dùng tại thời điểm dữ liệu được thu thập. Giá trị chuỗi của phương diện này có thể được phân tích cú pháp dưới dạng số nguyên. Xem tại đây để biết danh sách các bản phát hành Android và cách các bản phát hành đó tương ứng với cấp độ API. |
deviceModel |
Mã nhận dạng của một kiểu thiết bị cụ thể, như được xác định bởi danh mục thiết bị của Play Console. |
deviceType |
Mã nhận dạng của một hệ số hình thức thiết bị cụ thể, như được sử dụng bởi danh mục thiết bị của Play Console. |
deviceRamBucket |
RAM của thiết bị, tính bằng MB, theo nhóm (3 GB, 4 GB, v.v.). |
deviceSocMake |
Nhà sản xuất hệ thống chính trên chip của thiết bị, ví dụ: Samsung. Xem tại đây. |
deviceSocModel |
Tên kiểu của hệ thống chính trên chip của thiết bị, ví dụ: "Exynos 2100". Xem tại đây. |
deviceCpuMake |
Nhà sản xuất CPU của thiết bị, ví dụ: Qualcomm. |
deviceCpuModel |
Kiểu CPU của thiết bị, ví dụ: "Kryo 240". |
deviceGpuMake |
Nhà sản xuất GPU của thiết bị, ví dụ: ARM. |
deviceGpuModel |
Kiểu GPU của thiết bị, ví dụ: Mali. |
deviceGpuVersion |
Phiên bản GPU của thiết bị, ví dụ: T750. |
deviceVulkanVersion |
Phiên bản Vulkan của thiết bị, ví dụ: "4198400". |
deviceGlEsVersion |
Phiên bản OpenGL ES của thiết bị, ví dụ: "196610". |
deviceScreenSize |
Kích thước màn hình của thiết bị, ví dụ: NORMAL, LARGE. |
deviceScreenDpi |
Mật độ màn hình của thiết bị, ví dụ: mdpi, hdpi. |