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. Để đơn giản hoá tối đa việc sử dụng API, nhóm chỉ số sẽ chuẩn hoá quyền truy cập vào chỉ số. Tập hợp chỉ số là một nhóm chỉ số có liên quan với nhau theo logic, có chung các thuộc tính (chẳng hạn như độ mới và độ chi tiết) và có thể được truy vấn cùng nhau. Tập hợp 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, bạn có thể chia nhỏ hoặc lọc tất cả các chỉ số theo mọi phương diện có sẵn.
Độ mới mẻ
Mỗi tài nguyên tập hợp 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. Vì một tập hợp 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ị về độ mới cho mỗi mức độ chi tiết được hỗ trợ.
Bạn có thể sử dụng trực tiếp giá trị về độ mới làm điểm cuối trong một 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 tập hợp chỉ số, bạn nên sử dụng phương thức QUERY tuỳ chỉnh để đưa ra các truy vấn.
Mỗi truy vấn phải chỉ định một độ 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 những phương diện cần dùng để chia nhỏ 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 duy nhất để tránh hết thời gian chờ truy vấn do đọc quá nhiều dữ liệu.
Các nhóm chỉ số hiện có
Chỉ mục bên dưới liệt kê tất cả các điểm cuối và dữ liệu liên kết 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 số 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 tính đến hết 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 tính đến hết ngày. userPerceivedAnrRate (google.type.Decimal): Tỷ lệ phần trăm số 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ỉ những lỗi ANR thuộc loại "Gửi dữ liệu đầu vào" mới đượ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 hết 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 hết ngày. distinctUsers (google.type.Decimal): Số lượng người dùng ước chừng có dữ liệu 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 số 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 tính đến hết 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 tính đến hết ngày. userPerceivedCrashRate (google.type.Decimal): Tỷ lệ phần trăm số 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 hết 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 hết ngày. distinctUsers (google.type.Decimal): Số lượng người dùng ước chừng có dữ liệu trong khoảng thời gian tổng hợp. |
vitals.lmkrate
|
Chứa dữ liệu LMK (lỗi tắt ứng dụng khi bộ nhớ thấp) 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 số 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 chủ động dùng ứng dụng của bạn. Một ứng dụng được coi là đang có người sử dụng nếu ứng dụng đó hiển thị hoạt động bất kỳ hoặc thực thi dịch vụ trên nền trước bất kỳ. 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 hết 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 hết ngày. distinctUsers (google.type.Decimal): Số lượng người dùng ước chừng có dữ liệu 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 số 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 tính đến hết 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 hết ngày. distinctUsers (google.type.Decimal): Số lượng người dùng ước chừng có dữ liệu trong khoảng thời gian tổng hợp. |
vitals.stuckbackgroundwakelockrate |
Chứa dữ liệu về thời lượng wakelock 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 số người dùng riêng biệt trong khoảng thời gian tổng hợp có wakelock đượ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 hết 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 hết ngày. distinctUsers (google.type.Decimal): Số lượng người dùng ước chừng có dữ liệu trong khoảng thời gian tổng hợp. |
vitals.slowstartuprate |
Chứa dữ liệu khởi động ứng dụng chậm được phân tích theo loại khởi động ứng dụng (nguội, ấm, nóng). |
slowStartRate (google.type.Decimal): Tỷ lệ phần trăm số người dùng riêng biệt trong khoảng thời gian tổng hợp có 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 hết 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 tính đến hết ngày. distinctUsers (google.type.Decimal): Số lượng người dùng ước chừng có dữ liệu 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. |
Kích thước
Mỗi nhóm chỉ số hỗ trợ một nhóm 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 dữ liệu được ghi lại. 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 lập phiên bản ứng dụng trên Android. |
countryCode |
Giá trị 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ị cũng như 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 ghi lại. 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. Hãy 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 này tương ứng với cấp độ API. |
deviceModel |
Giá trị nhận dạng của một mẫu thiết bị cụ thể, do danh mục thiết bị của Play Console xác định. |
deviceType |
Giá trị nhận dạng của một hệ số hình dạng thiết bị cụ thể, như được dùng trong 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 trên chip chính của thiết bị, ví dụ: Samsung. Xem tại đây. |
deviceSocModel |
Tên mẫu của hệ thống trên vi mạch chính 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 |
Mẫ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ụ: BÌNH THƯỜNG, LỚN. |
deviceScreenDpi |
Mật độ màn hình của thiết bị, ví dụ: mdpi, hdpi. |