Google Play Developer Reporting API memungkinkan Anda mengakses metrik, laporan, dan informasi linimasa tentang aplikasi Anda. Untuk membuat penggunaan API sesederhana mungkin, kumpulan metrik menstandardisasi akses metrik. Kumpulan metrik adalah pengelompokan logis metrik terkait yang memiliki atribut umum (seperti keaktualan dan perincian) dan dapat dikueri bersama-sama. Set metrik juga berisi sejumlah dimensi yang dapat Anda gunakan untuk memfilter atau menghasilkan perincian. Kecuali jika ditentukan lain, semua metrik dapat dikelompokkan atau difilter menurut semua dimensi yang tersedia.
Keaktualan
Setiap resource set metrik menawarkan metode GET standar untuk mengambil
tanggal dan waktu titik data terbaru yang tersedia, yang dikenal sebagai keaktualan. Karena set metrik dapat mendukung beberapa perincian (harian, per jam), operasi ini akan menampilkan satu nilai keaktualan per perincian yang didukung.
Anda dapat menggunakan nilai keaktualan secara langsung sebagai endpoint dalam rentang waktu kueri.
Kueri data
Untuk mengakses data dalam set 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 akan digunakan untuk mengelompokkan agregasi.
Anda harus berhati-hati saat meminta rentang tanggal untuk rentang waktu, sehingga ukuran rentang waktu berbanding terbalik dengan ukuran aplikasi dan jumlah perincian. Misalnya, aplikasi besar harus memilih lebih sedikit hari dalam satu permintaan kueri untuk menghindari waktu tunggu kueri habis karena membaca terlalu banyak data.
Set metrik yang tersedia
Indeks di bawah mencantumkan semua endpoint dan data terkait yang dapat Anda minta.
| Set metrik | Deskripsi | Metrik yang didukung |
|---|---|---|
vitals.anrrate |
Berisi data ANR yang digabungkan dengan data penggunaan untuk menghasilkan metrik yang dinormalisasi dan tidak bergantung pada jumlah pengguna. |
anrRate (google.type.Decimal): Persentase pengguna unik dalam periode
agregasi yang mengalami setidaknya satu ANR. anrRate7dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari metrik anrRate dalam 7 hari hingga dan termasuk tanggal. anrRate28dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari metrik anrRate dalam 28 hari hingga dan termasuk tanggal tersebut. userPerceivedAnrRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang mengalami setidaknya satu ANR yang dirasakan pengguna. Saat ini, hanya ANR 'Pengiriman input' yang dihitung. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna dari metrik userPerceivedAnrRate dalam 7 hari hingga dan termasuk tanggal tersebut. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna dari metrik userPerceivedAnrRate dalam 28 hari hingga dan termasuk tanggal tersebut. 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 dan tidak bergantung pada jumlah pengguna. |
crashRate (google.type.Decimal): Persentase pengguna unik dalam periode
agregasi yang mengalami setidaknya satu error. crashRate7dUserWeighted (google.type.Decimal): Rata-rata crashRate yang diberi bobot pengguna dalam 7 hari hingga dan termasuk tanggal tersebut. crashRate28dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari metrik crashRate dalam 28 hari hingga dan termasuk tanggal tersebut. userPerceivedCrashRate (google.type.Decimal): Persentase pengguna unik dalam periode agregasi yang mengalami setidaknya satu error saat aplikasi sedang digunakan secara aktif. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari metrik userPerceivedCrashRate dalam 7 hari hingga dan termasuk tanggal tersebut. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna dari metrik userPerceivedCrashRate dalam 28 hari hingga dan termasuk tanggal tersebut. distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi. |
vitals.lmkrate
|
Berisi data LMK (low memory kill) yang digabungkan dengan data penggunaan untuk menghasilkan metrik yang dinormalisasi terlepas dari jumlah pengguna. |
userPerceivedLmkRate (google.type.Decimal): Persentase pengguna unik dalam
periode agregasi yang mengalami setidaknya satu LMK (low memory kill) saat mereka
aktif menggunakan aplikasi Anda. Aplikasi dianggap sedang digunakan secara aktif jika menampilkan
aktivitas apa pun atau menjalankan layanan latar depan apa pun. userPerceivedLmkRate7dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari metrik userPerceivedLmkRate dalam 7 hari hingga dan termasuk tanggal tersebut. userPerceivedLmkRate28dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna dari metrik userPerceivedLmkRate dalam 28 hari hingga dan termasuk tanggal. distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi. |
vitals.excessivewakeuprate |
Berisi data jumlah aktif AlarmManager yang digabungkan dengan data status proses untuk menghasilkan metrik yang dinormalisasi dan tidak bergantung pada jumlah pengguna. |
excessiveWakeupRate (google.type.Decimal): Persentase pengguna unik dalam
periode agregasi yang mengalami lebih dari 10 kali bangun per jam.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari
metrik excessiveWakeupRate dalam 7 hari hingga dan termasuk tanggal tersebut. excessiveWakeupRate28dUserWeighted (google.type.Decimal): Rata-rata berbobot pengguna dari metrik excessiveWakeupRate 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 digabungkan dengan data status proses untuk menghasilkan metrik yang dinormalkan dan tidak bergantung pada jumlah pengguna. |
stuckBgWakelockRate (google.type.Decimal): Persentase pengguna berbeda 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 stuckBgWakelockRate dalam 7 hari hingga dan termasuk tanggal tersebut. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna dari metrik stuckBgWakelockRate dalam 28 hari hingga dan termasuk tanggal tersebut. distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi. |
vitals.slowstartuprate |
Berisi data startup aplikasi lambat yang dikelompokkan menurut jenis mulai aplikasi (cold, warm, hot). |
slowStartRate (google.type.Decimal): Persentase pengguna unik dalam
periode agregasi yang mengalami peristiwa mulai lambat.
slowStartRate7dUserWeighted (google.type.Decimal): Rata-rata tertimbang pengguna
dari metrik slowStartRate 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 tersebut. distinctUsers (google.type.Decimal): Perkiraan jumlah pengguna yang datanya tersedia pada periode agregasi. |
vitals.errors.counts |
Berisi jumlah laporan error yang tidak dinormalisasi. |
Perhatikan: untuk saat ini, resource ini hanya tersedia di API versi alfa v1. errorReportCount (google.type.Decimal): Jumlah absolut laporan error individual yang telah diterima untuk aplikasi. |
Dimensi
Setiap set metrik mendukung serangkaian dimensi yang berbeda untuk pemfilteran dan perincian. Lihat indeks dimensi di bawah untuk mengetahui daftar dimensi yang tersedia di API.
| Dimensi | Deskripsi |
|---|---|
versionCode |
Kode versi aplikasi yang berjalan di perangkat pengguna pada saat data diperoleh. 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-nya, yang ditampilkan sebagai kode ISO-3166 2 huruf (misalnya, US untuk Amerika Serikat). |
Dimensi Perangkat
Dimensi ini khusus untuk perangkat dan karakteristik software serta hardware-nya.
| Dimensi | Deskripsi |
|---|---|
apiLevel |
Level API 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 pemetaannya ke level API. |
deviceModel |
ID model perangkat tertentu, sebagaimana 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 |
Pembuat system-on-chip utama perangkat, misalnya, Samsung. Lihat di sini. |
deviceSocModel |
Nama model system-on-chip utama perangkat, misalnya, "Exynos 2100". Lihat di sini. |
deviceCpuMake |
Merek CPU perangkat, misalnya, Qualcomm. |
deviceCpuModel |
Model CPU perangkat, misalnya, "Kryo 240". |
deviceGpuMake |
Merek GPU perangkat, misalnya, ARM. |
deviceGpuModel |
Model GPU perangkat, misalnya, Mali. |
deviceGpuVersion |
Versi GPU perangkat, misalnya, T750. |
deviceVulkanVersion |
Versi Vulkan perangkat, misalnya, "4198400". |
deviceGlEsVersion |
Versi OpenGL ES perangkat, misalnya, "196610". |
deviceScreenSize |
Ukuran layar perangkat, misalnya, NORMAL, LARGE. |
deviceScreenDpi |
Kepadatan layar perangkat, misalnya, mdpi, hdpi. |