Metrik Kümelerine Giriş

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