API Google Play Developer Reporting cho phép bạn truy cập các chỉ số, báo cáo và thông tin về tiến trình của ứng dụng. Để việc sử dụng API đơn giản nhất có thể, các bộ chỉ số chuẩn hoá quyền truy cập vào chỉ số. Tập hợp chỉ số là một nhóm các chỉ số liên quan với nhau theo logic, có chung các thuộc tính chung (chẳng hạn như độ mới và độ chi tiết) và có thể được truy vấn cùng nhau. Một tập hợp chỉ số cũng chứa một số phương diện mà bạn có thể sử dụng để lọc hoặc tạo bảng chi tiết. Trừ khi có quy định khác, bạn có thể chia nhỏ hoặc lọc tất cả các chỉ số theo tất cả các phương diện có sẵn.
Độ mới
Mỗi tài nguyên tập hợp chỉ số cung cấp một phương thức GET 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 chi tiết (hằng ngày, hằng giờ) nên toán tử sẽ trả về một giá trị độ mới cho mỗi độ chi tiết được hỗ trợ.
Bạn có thể sử dụng trực tiếp giá trị độ mới 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 tập hợp chỉ số, bạn nên dùng phương thức QUERY tuỳ chỉnh để thực hiện truy vấn.
Mỗi truy vấn phải chỉ định độ chi tiết và 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 nên được sử dụng để chia nhỏ dữ liệu tổng hợp.
Bạn nên cẩn thận khi yêu cầu tiến trình yêu cầu phạm vi ngày để 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 chi tiết. Ví dụ: một ứng dụng lớn sẽ chọn ít ngày hơn trong một yêu cầu truy vấn để tránh hết thời gian chờ truy vấn do đọc quá nhiều dữ liệu.
Các tập hợp chỉ số có sẵn
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 quan mà bạn có thể yêu cầu.
| Tập hợp 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 chỉ số chuẩn hóa không phụ thuộc vào số lượng người dùng. |
anrRate (google.type.Integer): Tỷ lệ phần trăm người dùng riêng biệt trong giai đoạn tổng hợp gặp phải ít nhất một lỗi ANR. anrRate7dUserWeight (google.type.DIGITS): Mức trung bình theo trọng số người dùng của chỉ số anrRate trong 7 ngày tính đến ngày hiện tại. anrRate28dUserWeight (google.type.DIGITS): Mức trung bình theo trọng số người dùng của chỉ số anrRate trong 28 ngày tính đến ngày hiện tại. userPerceivedAnrRate (google.type.DIGITS): Tỷ lệ phần trăm người dùng riêng biệt trong giai đoạn tổng hợp gặp phải ít nhất một lỗi ANR do người dùng nhận thấy. Các lỗi ANR hiện tại của "Dịch vụ điều phối đầu vào" được tính. userPerceivedAnrRate7dUserWeight (google.type.DIGITS): Mức trung bình theo trọng số người dùng của chỉ số userPerceivedAnrRate trong 7 ngày tính đến nay và bao gồm cả ngày tháng. userPerceivedAnrRate28dUserWeight (google.type.DIGITS): Mức trung bình theo trọng số người dùng của chỉ số userPerceivedAnrRate trong 28 ngày tính đến nay và bao gồm cả ngày tháng. distinctUsers (google.type.DIGITS): Số người dùng gần đúng mà dữ liệu có sẵn trên giai đoạn 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 chỉ số chuẩn hóa không phụ thuộc vào số lượng người dùng. |
crashRate (google.type.DIGITS): Tỷ lệ phần trăm người dùng riêng biệt trong giai đoạn tổng hợp gặp phải ít nhất một sự cố. crashRate7dUserWeight (google.type.DIGITS): Mức trung bình theo trọng số người dùng của chỉ số sự cố trong 7 ngày tính đến nay và bao gồm cả ngày tháng. crashRate28dUserWeight (google.type.DIGITS): Mức trung bình theo trọng số người dùng của chỉ số sự cố trong 28 ngày tính đến nay và bao gồm cả ngày tháng. userPerceivedCrashRate (google.type.DIGITS): Tỷ lệ phần trăm người dùng riêng biệt trong giai đoạn tổng hợp gặp phải ít nhất một sự cố khi ứng dụng đang dùng. userPerceivedsự userPerceivedSựTỷ lệ distinctUsers (google.type.DIGITS): Số người dùng gần đúng mà dữ liệu có sẵn trên giai đoạn tổng hợp. |
vitals.excessivewakeuprate |
Chứa dữ liệu số lần đánh thức AlarmManager kết hợp với dữ liệu trạng thái quy trình để tạo ra chỉ số chuẩn hóa không phụ thuộc vào số lượng người dùng. |
excessiveWakeupRate (google.type.Integer): Tỷ lệ phần trăm người dùng riêng biệt trong
giai đoạn tổng hợp có hơn 10 lần đánh thức mỗi giờ.
excessiveWakeupRate7dUserweighted (google.type.Integer): Giá trị trung bình lấy trọng số của người dùng về
chỉ số vượt quá tỷ lệ đánh thức trong 7 ngày tính đến nay và bao gồm cả ngày. Vượt quá tỷ lệ người dùng đánh thức distinctUsers (google.type.DIGITS): Số người dùng gần đúng mà dữ liệu có sẵn trên giai đoạn tổng hợp. |
vitals.stuckbackgroundwakelockrate |
Chứa dữ liệu thời lượng khóa chế độ thức PowerManager kết hợp với dữ liệu trạng thái quy trình để tạo ra chỉ số chuẩn hóa không phụ thuộc vào số lượng người dùng. |
stuckBgWakelockRate (google.type.DIGITS): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp đã khoá chế độ thức trong nền hơn 1 giờ.
stuckBgWakelockRate7dUserweighted (google.type.Integer): Giá trị trung bình lấy trọng số của người dùng
của chỉ số kẹtBgWakelockRate trong 7 ngày tính đến nay và bao gồm cả ngày. stuckBgWakelockRate28dUserWeight (google.type.DIGITS): Giá trị trung bình lấy trọng số của người dùng của chỉ số kẹtBgWakelockRate trong 28 ngày tính đến nay và bao gồm cả ngày tháng. distinctUsers (google.type.DIGITS): Số người dùng gần đúng mà dữ liệu có sẵn trên giai đoạn tổng hợp. |
vitals.slowstartuprate |
Chứa dữ liệu khởi động ứng dụng chậm được chia nhỏ theo loại khởi động ứng dụng (nguội, ấm, nóng). |
slowStartRate (google.type.DIGITS): Tỷ lệ phần trăm người dùng riêng biệt trong
giai đoạn tổng hợp có sự kiện khởi động chậm.
slowStartRate7dUserWeight (google.type.Integer): Giá trị trung bình lấy trọng số từ người dùng
của chỉ số SlowStartRate trong 7 ngày tính đến hiện tại và bao gồm cả ngày. slowStartRate28dUserWeight (google.type.Integer): Giá trị trung bình lấy trọng số của người dùng của chỉ số SlowStartRate trong 28 ngày tính đến hiện tại và bao gồm cả ngày. distinctUsers (google.type.DIGITS): Số người dùng gần đúng mà dữ liệu có sẵn trên giai đoạn tổng hợp. |
vitals.errors.counts |
Chứa số lượng báo cáo lỗi không bình thường. |
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.DIGITS): Số lượng báo cáo lỗi tuyệt đối riêng lẻ đã nhận được cho một ứng dụng. |
Kích thước
Mỗi bộ chỉ số hỗ trợ một bộ phương diện riêng biệt để 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ó sẵn 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. Bạn có thể phân tích cú pháp giá trị chuỗi của phương diện này dưới dạng số nguyên. Hãy xem tại đây để biết thêm thông tin chi tiết về cách hoạt động của 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ã gồm 2 chữ cái theo ISO-3166 (ví dụ: Hoa Kỳ cho Hoa Kỳ). |
Kích thước thiết bị
Đây là các kích thước dành riêng cho thiết bị cũng như các đặc điểm 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 thu thập dữ liệu. Bạn có thể phân tích cú pháp giá trị chuỗi của phương diện này 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 chúng liên kết với các cấp độ API. |
deviceModel |
Giá trị nhận dạng của một mẫu thiết bị cụ thể, theo định nghĩa trong Danh mục thiết bị của Play Console. |
deviceType |
Giá trị nhận dạng của một kiểu dáng thiết bị cụ thể, như danh mục thiết bị Play Console sử dụng. |
deviceRamBucket |
RAM của thiết bị, tính bằng MB, theo bộ chứa (3 GB, 4 GB, v.v.). |
deviceSocMake |
Cấu trúc của chip hệ thống chính trên thiết bị, ví dụ: Samsung. Xem tại đây. |
deviceSocModel |
Tên mẫu hệ thống trên chip chính của thiết bị, ví dụ: "Exynos 2100". Xem tại đây. |
deviceCpuMake |
Tạo nên CPU của thiết bị, ví dụ: Qualcomm. |
deviceCpuModel |
Mẫu CPU của thiết bị, ví dụ: "Kryo 240". |
deviceGpuMake |
Tạo GPU của thiết bị, ví dụ: ARM (ARM). |
deviceGpuModel |
Mẫ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 LUẬN, LỚN. |
deviceScreenDpi |
Mật độ màn hình của thiết bị, ví dụ: mdpi, hdpi. |