Google Play Developer Reporting API, uygulamalarınızla ilgili metriklere, raporlara ve zaman çizelgesi bilgilerine erişmenizi sağlar. Metrik grupları, API kullanımını mümkün olduğunca kolaylaştırmak için metrik erişimini standart hale getirir. Metrik kümesi, ortak özellikleri (yenilik ve ayrıntı düzeyi gibi) paylaşan ve birlikte sorgulanabilen ilgili metriklerin mantıksal bir gruplamasıdır. Metrik kümesi, dökümleri filtrelemek veya oluşturmak için kullanabileceğiniz çeşitli boyutlar da içerir. Aksi belirtilmedikçe, tüm metrikler kullanılabilir tüm boyutlara göre ayrılabilir veya filtrelenebilir.
Güncellik
Metrik kümesi içeren her kaynak, güncellik olarak bilinen en son veri noktasının tarih ve saatini almak için standart bir GET yöntemi sunar. Bir metrik grubu birden fazla ayrıntı düzeyini (günlük, saatlik) destekleyebileceğinden işlem, desteklenen ayrıntı düzeyi başına bir güncellik değeri döndürür.
Güncellik değerini doğrudan sorgu zaman aralığında uç nokta olarak kullanabilirsiniz.
Veri sorguları
Bir metrik kümesindeki verilere erişmek için sorguda özel QUERY yöntemini kullanmanız gerekir.
Her sorgu bir ayrıntı düzeyi ve zaman aralığı belirtmelidir. Erişmek istediğiniz metriklerle birlikte, toplamaları ayırmak için kullanılması gereken boyutları da belirtmeniz gerekir.
Tarih aralıklarını istemek için zaman çizelgeleri istenirken zaman aralığının boyutunun uygulamanızın boyutu ve döküm sayısıyla orantılı olarak orantılı olması gerekir. Örneğin, çok büyük bir uygulamanın çok fazla veri okumasından kaynaklanan sorgu zaman aşımlarını önlemek için büyük bir uygulama tek bir sorgu isteğinde daha az gün seçmelidir.
Kullanılabilir metrik kümeleri
Aşağıdaki dizinde, isteyebileceğiniz tüm uç noktalar ve ilişkili veriler listelenmiştir.
| Metrik ayarlandı | Açıklama | Desteklenen metrikler |
|---|---|---|
vitals.anrrate |
Kullanıcı sayılarından bağımsız olarak normalleştirilmiş bir metrik üretmek için kullanım verileriyle birleştirilmiş ANR verilerini içerir. |
anrRate (google.type.Decimal): Toplama döneminde en az bir ANR sorunu yaşayan farklı kullanıcıların yüzdesi. anrRate7dUserweighted (google.type.Decimal): Tarihe kadar 7 gün içinde anrRate metriğinin kullanıcı ağırlıklı ortalaması. anrRate28dUserweighted (google.type.Decimal): Tarihe kadar 28 gün içinde anrRate metriğinin kullanıcı ağırlıklı ortalaması. userPerceivedAnrRate (google.type.Decimal): Toplamda en az bir kullanıcı tarafından algılanan ANR sorunu yaşayan farklı kullanıcıların yüzdesi. Şu anda "Giriş gönderme" işlevindeki bağımsız ANR'ler sayılmaktadır. userPerceivedAnrRate7dUserweighted (google.type.Decimal): Tarihe kadar ve dahil olmak üzere 7 gün içinde userPerceivedAnrRate metriğinin kullanıcı ağırlıklı ortalaması. userPerceivedAnrRate28dUserweighted (google.type.Decimal): Tarihe kadarki (tarih dahil) 28 gün içinde userPerceivedAnrRate metriğinin kullanıcı ağırlıklı ortalaması. distinctUsers (google.type.Decimal): Toplama döneminde veri bulunan kullanıcıların yaklaşık sayısı. |
vitals.crashrate |
Kullanıcı sayılarından bağımsız olarak normalleştirilmiş bir metrik üretmek için kullanım verileriyle birleştirilmiş kilitlenme verilerini içerir. |
crashRate (google.type.Decimal): Toplama aralığında en az bir kilitlenme deneyimi yaşayan farklı kullanıcıların yüzdesi. crashRate7dUserweighted (google.type.Decimal): Tarihi 7 güne kadar olan ve tarihi de içeren kilitlenme oranı metriğinin kullanıcı ağırlıklı ortalaması. crashRate28dUserweighted (google.type.Decimal): Tarihe kadar ve tarih dahil olmak üzere 28 gün içindeki kilitlenme oranı metriğinin kullanıcı ağırlıklı ortalaması. userPerceivedCrashRate (google.type.Decimal): Toplama sürecinde, uygulama etkin durumdayken en az bir kilitlenme deneyimi yaşayan farklı kullanıcıların yüzdesi. userPerceivedCrashRate7dUserAğırlıklı (google.type.Decimal): Tarihe kadar 7 gün içinde userPerceivedCrashRate metriğinin kullanıcı ağırlıklı ortalaması. userPerceivedCrashRate28dUserweighted (google.type.Decimal): Tarihe kadarki (tarih dahil) 28 gün içinde userPerceivedCrashRate metriğinin kullanıcı ağırlıklı ortalaması. distinctUsers (google.type.Decimal): Toplama döneminde veri bulunan kullanıcıların yaklaşık sayısı. |
vitals.excessivewakeuprate |
Kullanıcı sayılarından bağımsız olarak normalleştirilmiş bir metrik üretmek için AlarmManager uyandırma sayısı verilerini işlem durumu verileriyle birlikte içerir. |
excessiveWakeupRate (google.type.Decimal): Toplama sırasında, saatte 10'dan fazla uyandırma deneyimi yaşatan farklı kullanıcıların yüzdesi.
aşırı WakeupRate7dUserweighted (google.type.Decimal): Tarihe kadar ve tarih dahil olmak üzere 7 gün içinde aşırı WakeupRate metriğinin kullanıcı ağırlıklı ortalaması. AşırılıkWakeupRate28dUserweighted (google.type.Decimal): Tarihe kadar ve tarih dahil olmak üzere son 28 gün içinde aşırı WakeupRate metriğinin kullanıcı ağırlıklı ortalaması. distinctUsers (google.type.Decimal): Toplama döneminde veri bulunan kullanıcıların yaklaşık sayısı. |
vitals.stuckbackgroundwakelockrate |
Kullanıcı sayılarından bağımsız olarak normalleştirilmiş bir metrik üretmek için işlem durumu verileriyle birlikte PowerManager uyanık kalma süresi verilerini içerir. |
stuckBgWakelockRate (google.type.Decimal): Toplama süresi içinde, arka planda 1 saatten uzun bir uyanık kalma süresine sahip olan farklı kullanıcıların yüzdesi.
stuckBgWakelockRate7dUserweighted (google.type.Decimal): Tarihe kadar olan ve dahil olan 7 gün içinde takılı kalan BgWakelockRate metriğinin kullanıcı ağırlıklı ortalaması. stuckBgWakelockRate28dUserweighted (google.type.Decimal): Tarihe kadarki (tarih dahil) 28 gün boyunca takılı kalan BgWakelockRate metriğinin kullanıcı ağırlıklı ortalaması. distinctUsers (google.type.Decimal): Toplama döneminde veri bulunan kullanıcıların yaklaşık sayısı. |
vitals.slowstartuprate |
Uygulama başlatma türüne (soğuk, sıcak, sıcak) göre ayrılmış yavaş uygulama başlatma verileri içerir. |
slowStartRate (google.type.Decimal): Yavaş bir başlangıç etkinliğine sahip toplama döneminde farklı kullanıcıların yüzdesi.
slowStartRate7dUserAğırlıklı (google.type.Decimal): Tarihe kadar ve tarih dahil olmak üzere 7 gün içindeki yavaş gerçekleşen StartRate metriğinin kullanıcı ağırlıklı ortalaması. slowStartRate28dUserweighted (google.type.Decimal): Tarihin dahil olduğu 28 gün içinde, startStart metriğinin kullanıcı başına ağırlıklı ortalaması. distinctUsers (google.type.Decimal): Toplama döneminde veri bulunan kullanıcıların yaklaşık sayısı. |
vitals.errors.counts |
Normalleştirilmemiş hata raporu sayılarını içerir. |
Not: Bu kaynak şu anda yalnızca API'nin v1 alfa sürümünde kullanılabilir. errorReportCount (google.type.Decimal): Bir uygulama için alınan bağımsız hata raporlarının mutlak sayısı. |
Boyutlar
Her metrik grubu, filtreleme ve dökümler için farklı boyutlar destekler. API'de kullanılabilen boyutların listesi için aşağıdaki boyut dizinine göz atın.
| Boyut | Açıklama |
|---|---|
versionCode |
Veriler yakalandığı sırada kullanıcının cihazında çalışan uygulamanın sürüm kodu. Bu boyutun dize değeri tam sayı olarak ayrıştırılabilir. Sürüm oluşturmanın Android'de nasıl çalıştığı hakkında daha fazla bilgiyi burada bulabilirsiniz. |
countryCode |
Kullanıcının IP adresine göre 2 harfli ISO-3166 koduyla (ör. ABD için) gösterilen ülke veya bölge tanımlayıcısı. |
Cihaz Boyutları
Bunlar, cihaza özel olarak sunulan boyutlar ile yazılım ve donanım özellikleridir.
| Boyut | Açıklama |
|---|---|
apiLevel |
Veriler yakalanırken kullanıcının cihazında çalışan Android'in API düzeyi. Bu boyutun dize değeri tam sayı olarak ayrıştırılabilir. Android sürümlerinin listesi ve API düzeyleriyle eşlenmeleri için buraya göz atın. |
deviceModel |
Play Console cihaz kataloğunda tanımlandığı şekilde belirli bir cihaz modelinin tanımlayıcısı. |
deviceType |
Play Console cihaz kataloğu tarafından kullanılan belirli bir cihaz formu faktörünün tanımlayıcısı. |
deviceRamBucket |
Cihazın RAM cinsinden MB cinsinden RAM'leri (3 GB, 4 GB vb.) belirleyin. |
deviceSocMake |
Cihazın birincil çipinin (ör. Samsung'a dokunun. Burayı tıklayın. |
deviceSocModel |
Cihazın çip üzerinde birincil sisteminin model adı (ör. "Exynos 2100". Burayı tıklayın. |
deviceCpuMake |
Cihazın CPU'sunu (ör. Qualcomm'a gidin. |
deviceCpuModel |
Cihazın CPU modeli (ör. "Kryo 240" |
deviceGpuMake |
Cihazın GPU'sunu oluşturun (ör. Arm. |
deviceGpuModel |
Cihazın GPU modeli.Ör. Mali. |
deviceGpuVersion |
Cihazın GPU sürümü (ör. T750 |
deviceVulkanVersion |
Cihazın Vulkan sürümü (ör. "4198400". |
deviceGlEsVersion |
Cihazın OpenGL ES sürümü (ör. "196610". |
deviceScreenSize |
Cihazın ekran boyutu, ör. NORMAL, BÜYÜK HARF |
deviceScreenDpi |
Cihazın ekran yoğunluğu (ör. mdpi, hdpi). |