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. |