Pengantar Set Metrik

Google Play Developer Reporting API memungkinkan Anda mengakses metrik, laporan, dan informasi linimasa tentang aplikasi. Untuk mempermudah penggunaan API, kumpulan metrik menstandarkan akses metrik. Set metrik adalah pengelompokan logis metrik terkait yang memiliki atribut umum yang sama (seperti keaktualan dan perincian) dan dapat dikueri bersama. Kumpulan metrik juga berisi sejumlah dimensi yang dapat Anda gunakan untuk memfilter atau membuat pengelompokan. Kecuali jika ditentukan lain, semua metrik dapat diperinci atau difilter menurut semua dimensi yang tersedia.

Keaktualan

Setiap resource kumpulan metrik menawarkan metode GET standar untuk mengambil tanggal dan waktu titik data terbaru yang tersedia, yang dikenal sebagai keaktualan. Karena kumpulan metrik dapat mendukung beberapa perincian (harian, per jam), operasi ini akan menampilkan satu nilai keaktualan per perincian yang didukung.

Anda dapat menggunakan nilai keaktualan langsung sebagai endpoint dalam rentang waktu kueri.

Kueri data

Untuk mengakses data dalam kumpulan metrik, Anda harus menggunakan metode QUERY kustom untuk mengeluarkan kueri. Setiap kueri harus menentukan perincian dan rentang waktu. Bersama dengan metrik yang ingin Anda akses, Anda harus menentukan dimensi yang harus digunakan untuk menguraikan agregasi.

Anda harus berhati-hati saat meminta linimasa untuk meminta rentang tanggal, sehingga ukuran rentang waktu berbanding terbalik dengan ukuran aplikasi Anda dan jumlah pengelompokan. Misalnya, aplikasi besar harus memilih lebih sedikit hari dalam satu permintaan kueri untuk menghindari waktu tunggu kueri yang disebabkan oleh pembacaan terlalu banyak data.

Kumpulan metrik yang tersedia

Indeks di bawah ini mencantumkan semua endpoint dan data terkait yang bisa Anda minta.

Kumpulan metrik Deskripsi Metrik yang didukung
vitals.anrrate Berisi data ANR yang digabungkan dengan data penggunaan untuk menghasilkan metrik yang dinormalkan, terlepas dari jumlah pengguna. anrRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang mengalami setidaknya satu ANR.
anrRate7dUserWeighted (google.type.Decimal): Rata-rata metrik anrRate dari pengguna untuk pengguna dalam 7 hari hingga dan termasuk tanggal.
anrRate28dUserWeighted (google.type.Decimal): Rata-rata metrik anrRate dari pengguna dalam 28 hari hingga dan pada tanggal tersebut.
userPerceivedAnrRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang mengalami setidaknya satu ANR yang dipersepsikan pengguna. ANR 'Pengiriman input' saat ini dihitung.
userPerceivedAnrRate7dUserWeighted (google.type.Decimal): Rata-rata metrik pengguna berdasarkan pengguna perceivedAnrRate dalam 7 hari hingga dan termasuk tanggal.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal): Rata-rata metrik pengguna pengguna PerceivedAnrRate dalam 28 hari hingga dan termasuk tanggal.
distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi.
vitals.crashrate Berisi data error yang digabungkan dengan data penggunaan untuk menghasilkan metrik yang dinormalkan, terlepas dari jumlah pengguna. crashRate (google.type.Decimal): Persentase pengguna berbeda dalam periode agregasi yang mengalami setidaknya satu error.
crashRate7dUserWeighted (google.type.Decimal): Rata-rata metrik errorRate yang ditimbang pengguna dalam 7 hari hingga dan termasuk tanggal tersebut.
crashRate28dUserWeighted (google.type.Decimal): Rata-rata metrik crashRate untuk pengguna dalam 28 hari hingga dan termasuk tanggalnya.
userPerceivedCrashRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang mengalami setidaknya satu error saat aplikasi sedang digunakan aktif.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Rata-rata metrik pengguna pengguna perceivedCrashRate dalam 7 hari hingga dan termasuk tanggal.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Rata-rata metrik pengguna perceivedCrashRate dalam 28 hari hingga dan termasuk tanggal.
distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi.
vitals.excessivewakeuprate Berisi data bangun AlarmManager yang menggabungkan data status proses untuk menghasilkan metrik yang dinormalkan, terlepas dari jumlah pengguna. exsesiiveWakeupRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang memiliki lebih dari 10 bangun per jam. exsessioniveWakeupRate7dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari metrik WakeWakeRate yang berlebihan dalam 7 hari hingga dan termasuk tanggal.
exsesiiveWakeupRate28dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari metrik WakeWakeRate dalam 28 hari hingga dan termasuk tanggal.
distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi.
vitals.stuckbackgroundwakelockrate Berisi data durasi wakelock PowerManager yang dikombinasikan dengan data status proses untuk menghasilkan metrik yang dinormalkan terlepas dari jumlah pengguna. stuckBgWakelockRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang memiliki wakelock yang ditahan di latar belakang selama lebih dari 1 jam. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna dari metrik stubBgWakelockRate dalam 7 hari hingga dan termasuk tanggal.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna dari metrik stubBgWakelockRate dalam 28 hari hingga dan termasuk tanggal.
distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi.
vitals.slowstartuprate Berisi data startup aplikasi lambat yang dikelompokkan berdasarkan jenis start aplikasi (cold, warm, hot). slowStartRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang memiliki peristiwa awal yang lambat. slowStartRate7dUserWeighted (google.type.Decimal): Rata-rata metrik pengguna startStart yang berbobot pengguna dalam 7 hari hingga dan termasuk tanggal.
slowStartRate28dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna dari metrik slowStartRate dalam 28 hari hingga dan termasuk tanggal.
distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi.
vitals.errors.counts Berisi jumlah laporan error yang tidak dinormalisasi. Perlu diingat: Saat ini, resource ini hanya tersedia dalam API versi alfa v1.
errorReportCount (google.type.Decimal): Jumlah absolut setiap laporan error yang telah diterima untuk aplikasi.

Dimensi

Setiap kumpulan metrik mendukung kumpulan dimensi yang berbeda untuk pemfilteran dan pengelompokan. Lihat indeks dimensi di bawah ini untuk daftar dimensi yang tersedia di API.

Dimensi Deskripsi
versionCode Kode versi aplikasi yang berjalan di perangkat pengguna pada saat data diambil. Nilai string dimensi ini dapat diuraikan sebagai bilangan bulat. Lihat di sini untuk mengetahui detail tambahan tentang cara kerja pembuatan versi aplikasi di Android.
countryCode ID negara atau wilayah pengguna berdasarkan alamat IP mereka, yang direpresentasikan sebagai kode ISO-3166 2 huruf (misalnya, AS untuk Amerika Serikat).

Dimensi Perangkat

Ini adalah dimensi yang spesifik untuk perangkat serta karakteristik software dan hardware-nya.

Dimensi Deskripsi
apiLevel API level Android yang berjalan di perangkat pengguna pada saat data diambil. Nilai string dimensi ini dapat diuraikan sebagai bilangan bulat. Lihat di sini untuk mengetahui daftar rilis Android dan cara mereka memetakan ke API level.
deviceModel ID model perangkat tertentu, seperti yang ditentukan oleh katalog perangkat Konsol Play.
deviceType ID faktor bentuk perangkat tertentu, seperti yang digunakan oleh katalog perangkat Konsol Play.
deviceRamBucket RAM perangkat, dalam MB, dalam bucket (3 GB, 4 GB, dll.).
deviceSocMake Merek sistem utama di chip perangkat, mis., Samsung Lihat di sini.
deviceSocModel Nama model sistem-on-chip utama perangkat, mis., "Exynos 2100". Lihat di sini.
deviceCpuMake Pembuatan CPU perangkat, misalnya, Prosesor
deviceCpuModel Model CPU perangkat, misalnya, "Kryo 240".
deviceGpuMake Pembuatan GPU perangkat, misalnya, ARM.
deviceGpuModel Model GPU perangkat, mis., Mali
deviceGpuVersion Versi GPU perangkat, mis., T750.
deviceVulkanVersion Versi perangkat Vulkan, misalnya, "4198400".
deviceGlEsVersion Versi perangkat OpenGL ES, misalnya, "196610".
deviceScreenSize Ukuran layar perangkat, misalnya, NORMAL, BESAR.
deviceScreenDpi Kepadatan layar perangkat, mis., mdpi, hdpi.