Method: vitals.crashrate.query

Mengkueri metrik dalam kumpulan metrik.

Permintaan HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}:query

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource.

Format: apps/{app}/crashRateMetricSet

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Kolom
timelineSpec

object (TimelineSpec)

Spesifikasi parameter agregasi linimasa.

Periode agregasi yang didukung:

  • DAILY: metrik digabungkan dalam interval tanggal kalender. Karena keterbatasan historis, zona waktu default dan satu-satunya yang didukung adalah America/Los_Angeles.
  • HOURLY: metrik digabungkan dalam interval per jam. Zona waktu default dan satu-satunya yang didukung adalah UTC.
dimensions[]

string

Dimensi yang akan digunakan untuk mengelompokkan metrik.

Dimensi yang didukung:

  • apiLevel (string): API level Android yang berjalan di perangkat pengguna, misalnya, 26.
  • versionCode (int64): versi aplikasi yang berjalan di perangkat pengguna.
  • deviceModel (string): ID unik model perangkat pengguna. Bentuk ID-nya adalah 'deviceBrand/device', dengan deviceBrand sesuai dengan Build.BRAND dan perangkat terkait dengan Build.DEVICE, misalnya, google/coral.
  • deviceBrand (string): ID unik merek perangkat pengguna, misalnya, Google.
  • deviceType (string): jenis (juga dikenal sebagai faktor bentuk) perangkat pengguna, misalnya, PONSEL.
  • countryCode (string): negara atau wilayah perangkat pengguna berdasarkan alamat IP, yang direpresentasikan sebagai kode ISO-3166 2 huruf (misalnya, AS untuk Amerika Serikat).
  • deviceRamBucket (int64): RAM perangkat, dalam MB, dalam bucket (3 GB, 4 GB, dll.).
  • deviceSocMake (string): Pembuatan sistem di chip utama perangkat, misalnya, Samsung. Referensi
  • deviceSocModel (string): Model sistem di chip utama perangkat, misalnya, "Exynos 2100". Referensi
  • deviceCpuMake (string): Merek CPU perangkat, misalnya, {i>Qualcomm<i}.
  • deviceCpuModel (string): Model CPU perangkat, misalnya, "Kryo 240".
  • deviceGpuMake (string): Merek GPU perangkat, misalnya, ARM.
  • deviceGpuModel (string): Model GPU perangkat, misalnya, Mali.
  • deviceGpuVersion (string): Versi GPU perangkat, misalnya, T750.
  • deviceVulkanVersion (string): Versi Vulkan perangkat, misalnya, "4198400".
  • deviceGlEsVersion (string): Versi OpenGL ES perangkat, misalnya, "196610".
  • deviceScreenSize (string): Ukuran layar perangkat, misalnya, NORMAL, BESAR.
  • deviceScreenDpi (string): Kepadatan layar perangkat, misalnya, mdpi, hdpi.
metrics[]

string

Metrik yang akan digabungkan.

Metrik yang didukung:

  • crashRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang mengalami setidaknya satu error.
  • crashRate7dUserWeighted (google.type.Decimal): Nilai rata-rata penggiliran crashRate dalam 7 hari terakhir. Nilai harian dihitung berdasarkan jumlah pengguna yang berbeda untuk hari itu.
  • crashRate28dUserWeighted (google.type.Decimal): Nilai rata-rata penggiliran crashRate dalam 28 hari terakhir. Nilai harian dihitung berdasarkan jumlah pengguna yang berbeda untuk hari itu. Tidak didukung dalam perincian PER JAM.
  • userPerceivedCrashRate (google.type.Decimal): Persentase pengguna yang berbeda-beda dalam periode agregasi yang mengalami setidaknya satu error saat mereka aktif menggunakan aplikasi Anda (error yang dirasakan pengguna). Aplikasi dianggap aktif digunakan jika menampilkan aktivitas apa pun atau menjalankan layanan latar depan apa pun.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Nilai rata-rata penggiliran userPerceivedCrashRate dalam 7 hari terakhir. Nilai harian dihitung berdasarkan jumlah pengguna yang berbeda untuk hari itu. Tidak didukung dalam perincian PER JAM.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Nilai rata-rata penggiliran userPerceivedCrashRate dalam 28 hari terakhir. Nilai harian dihitung berdasarkan jumlah pengguna yang berbeda untuk hari itu. Tidak didukung dalam perincian PER JAM.
  • distinctUsers (google.type.Decimal): Jumlah pengguna yang berbeda-beda dalam periode agregasi yang digunakan sebagai nilai normalisasi untuk metrik crashRate dan userPerceivedCrashRate. Pengguna dihitung dalam metrik ini jika mereka menggunakan aplikasi secara aktif selama periode agregasi. Aplikasi dianggap aktif digunakan jika menampilkan aktivitas apa pun atau menjalankan layanan latar depan apa pun. Harus diperhatikan agar tidak menggabungkan jumlah ini lebih lanjut, karena dapat menyebabkan pengguna dihitung beberapa kali. Nilai dibulatkan ke kelipatan terdekat 10, 100, 1.000, atau 1.000.000, bergantung pada besarnya nilai.
filter

string

Filter untuk diterapkan ke data. Ekspresi pemfilteran mengikuti standar AIP-160 dan mendukung pemfilteran berdasarkan kesetaraan semua dimensi perincian.

pageSize

integer

Ukuran maksimum data yang ditampilkan.

Jika tidak ditentukan, maksimal 1.000 baris akan ditampilkan. Nilai maksimum adalah 100.000; nilai di atas 100.000 akan dikonversi menjadi 100.000.

pageToken

string

Token halaman, diterima dari panggilan sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk permintaan harus cocok dengan panggilan yang menyediakan token halaman.

userCohort

enum (UserCohort)

Tampilan pengguna untuk memilih. Data output akan sesuai dengan tampilan yang dipilih.

Nilai yang didukung:

  • OS_PUBLIC Untuk memilih data dari semua versi Android yang dirilis secara publik. Ini adalah defaultnya. Mendukung semua dimensi di atas.
  • APP_TESTERS Untuk memilih data dari pengguna yang telah memilih untuk menjadi penguji. Mendukung semua dimensi di atas.
  • OS_BETA Untuk memilih data hanya dari versi Android beta, tidak termasuk data dari versi Android yang dirilis. Hanya dimensi berikut yang didukung:
  • versionCode (int64): versi aplikasi yang berjalan di perangkat pengguna.

  • osBuild (string): Build OS perangkat pengguna, misalnya, "T1B2.220916.004".

Isi respons

Pesan respons untuk crashrate.query.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Kolom
rows[]

object (MetricsRow)

Menampilkan baris data.

nextPageToken

string

Token lanjutan untuk mengambil halaman data berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.