Method: vitals.lmkrate.query

Truy vấn các chỉ số trong nhóm chỉ số.

Yêu cầu HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/lmkRateMetricSet}:query

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên tài nguyên.

Định dạng: apps/{app}/lmkRateMetricSet

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Trường
timelineSpec

object (TimelineSpec)

Không bắt buộc. Quy cách về các tham số tổng hợp theo dòng thời gian.

Các khoảng thời gian tổng hợp được hỗ trợ:

  • DAILY: các chỉ số được tổng hợp theo khoảng thời gian theo ngày dương lịch. Do các quy định ràng buộc trước đây, múi giờ mặc định và duy nhất được hỗ trợ là America/Los_Angeles.
dimensions[]

string

Không bắt buộc. Phương diện để phân chia chỉ số.

Các phương diện được hỗ trợ:

  • apiLevel (string): cấp độ API của Android đang chạy trên thiết bị của người dùng, ví dụ: 26.
  • versionCode (int64): phiên bản ứng dụng đang chạy trên thiết bị của người dùng.
  • deviceModel (string): giá trị nhận dạng riêng biệt của mẫu thiết bị của người dùng. Giá trị nhận dạng có dạng "deviceBrand/device", trong đó deviceBrand tương ứng với Build.BRAND và device tương ứng với Build.DEVICE, ví dụ: google/coral.
  • deviceBrand (string): giá trị nhận dạng riêng biệt của thương hiệu thiết bị của người dùng, ví dụ: google.
  • deviceType (string): loại (còn gọi là kiểu dáng) của thiết bị mà người dùng sử dụng, ví dụ: PHONE (ĐIỆN THOẠI).
  • countryCode (string): quốc gia hoặc khu vực của thiết bị 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ỳ).
  • deviceRamBucket (int64): RAM của thiết bị, tính bằng MB, theo nhóm (ví dụ: 1024 cho 1-1,5 GB, 4096 cho 4-6 GB).
  • deviceSocMake (string): Nhà sản xuất hệ thống trên chip chính của thiết bị, ví dụ: Samsung. Tệp đối chiếu
  • deviceSocModel (string): Kiểu hệ thống trên chip chính của thiết bị, ví dụ: "Exynos 2100". Tệp đối chiếu
  • deviceCpuMake (string): Nhà sản xuất CPU của thiết bị, ví dụ: Qualcomm.
  • deviceCpuModel (string): Kiểu CPU của thiết bị, ví dụ: "Kryo 240".
  • deviceGpuMake (string): Hãng sản xuất GPU của thiết bị, ví dụ: ARM.
  • deviceGpuModel (string): Kiểu GPU của thiết bị, ví dụ: Mali.
  • deviceGpuVersion (string): Phiên bản GPU của thiết bị, ví dụ: T750.
  • deviceVulkanVersion (string): Phiên bản Vulkan của thiết bị, ví dụ: "4198400".
  • deviceGlEsVersion (string): Phiên bản OpenGL ES của thiết bị, ví dụ: "196610".
  • deviceScreenSize (string): Kích thước màn hình của thiết bị, ví dụ: NORMAL (BÌNH THƯỜNG), LARGE (LỚN).
  • deviceScreenDpi (string): Mật độ màn hình của thiết bị, ví dụ: mdpi, hdpi.
metrics[]

string

Không bắt buộc. Chỉ số cần tổng hợp.

Các chỉ số được hỗ trợ:

  • 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 khi họ đang chủ động dùng ứng dụng của bạn (một lỗi LMK mà người dùng nhận thấy). 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ụ nền trước bất kỳ.
  • userPerceivedLmkRate7dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của userPerceivedLmkRate trong 7 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày.
  • userPerceivedLmkRate28dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của userPerceivedLmkRate trong 28 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày.
  • distinctUsers (google.type.Decimal): Số người dùng riêng biệt trong khoảng thời gian tổng hợp được dùng làm giá trị chuẩn hoá cho các chỉ số userPerceivedLmkRate. Người dùng được tính vào chỉ số này nếu họ sử dụng ứng dụng ở nền trước trong khoảng thời gian tổng hợp. Bạn phải cẩn thận để không tổng hợp thêm số lượng này, vì điều này có thể khiến người dùng được tính nhiều lần. Giá trị được làm tròn đến bội số gần nhất của 10, 100, 1.000 hoặc 1.000.000, tuỳ thuộc vào độ lớn của giá trị.
filter

string

Không bắt buộc. Bộ lọc để áp dụng cho dữ liệu. Biểu thức bộ lọc tuân theo tiêu chuẩn AIP-160 và hỗ trợ lọc theo mức độ tương đương của tất cả phương diện bảng chi tiết.

pageSize

integer

Không bắt buộc. Kích thước tối đa của dữ liệu được trả về.

Nếu không được chỉ định, hệ thống sẽ trả về tối đa 1.000 hàng. Giá trị tối đa là 10.000; các giá trị trên 10.000 sẽ được chuyển thành 10.000.

pageToken

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho yêu cầu phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

userCohort

enum (UserCohort)

Không bắt buộc. Chế độ xem của người dùng để chọn. Dữ liệu đầu ra sẽ tương ứng với chế độ xem đã chọn.

Giá trị được hỗ trợ:

  • OS_PUBLIC Để chọn dữ liệu từ tất cả phiên bản Android được phát hành công khai. Đây là tuỳ chọn mặc định. Hỗ trợ tất cả các phương diện nêu trên.
  • APP_TESTERS Để chọn dữ liệu của những người dùng đã chọn tham gia làm người thử nghiệm. Hỗ trợ tất cả các phương diện nêu trên.
  • OS_BETA Chỉ chọn dữ liệu từ các phiên bản Android thử nghiệm, không bao gồm dữ liệu từ các phiên bản Android đã phát hành. Chỉ hỗ trợ các phương diện sau:
  • versionCode (int64): phiên bản ứng dụng đang chạy trên thiết bị của người dùng.

  • osBuild (string): Bản dựng hệ điều hành của thiết bị người dùng, ví dụ: "T1B2.220916.004".

Nội dung phản hồi

Tin nhắn phản hồi cho lmkrate.query.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Trường
rows[]

object (MetricsRow)

Các hàng dữ liệu được trả về.

nextPageToken

string

Mã thông báo tiếp tục để tìm nạp trang dữ liệu tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/playdeveloperreporting

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.