Metrik Kümelerine Giriş

Google Play Developer Reporting API, uygulamalarınızla ilgili metrikler, raporlar ve zaman çizelgesi bilgilerine erişmenizi sağlar. API kullanımını olabildiğince basitleştirmek için metrik kümeleri, metrik erişimini standartlaştırır. Metrik grubu, ortak özelliklere (ör. güncellik ve ayrıntı düzeyi) sahip olan ve birlikte sorgulanabilen ilgili metriklerin mantıksal olarak gruplandırılmasıdır. Metrik kümesi, filtrelemek veya döküm oluşturmak için kullanabileceğiniz bir dizi boyut da içerir. Aksi belirtilmedikçe tüm metrikler, kullanılabilen tüm boyutlara göre dökümlenebilir veya filtrelenebilir.

Güncellik

Her metrik kümesi kaynağı, kullanılabilir en son veri noktasının tarih ve saatini (güncellik olarak bilinir) almak için standart bir GET yöntemi sunar. Bir metrik grubu birden fazla ayrıntı düzeyini (günlük, saatlik) destekleyebildiğinden işlem, desteklenen her ayrıntı düzeyi için bir yenilik değeri döndürür.

Güncellik değerini, sorgu zaman aralığında doğrudan uç nokta olarak kullanabilirsiniz.

Veri sorguları

Bir metrik kümesindeki verilere erişmek için sorgu göndermek üzere özel QUERY yöntemini kullanmanız gerekir. Her sorguda bir ayrıntı düzeyi ve zaman aralığı belirtilmelidir. Erişmek istediğiniz metriklerle birlikte, toplamaların ayrıştırılması için kullanılacak boyutları belirtmeniz gerekir.

Zaman çizelgeleri istenirken tarih aralıkları istenirken dikkatli olunmalıdır. Böylece, zaman aralığının boyutu, uygulamanızın boyutu ve döküm sayısı ile ters orantılı olur. Örneğin, büyük bir uygulama, çok fazla veri okumaktan kaynaklanan sorgu zaman aşımlarını önlemek için 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 kümesi Açıklama Desteklenen metrikler
vitals.anrrate Kullanıcı sayılarından bağımsız, normalleştirilmiş bir metrik oluşturmak için kullanım verileriyle birleştirilmiş ANR verilerini içerir. anrRate (google.type.Decimal): Toplama döneminde en az bir ANR yaşayan farklı kullanıcıların yüzdesi.
anrRate7dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 7 gün içindeki anrRate metriğinin kullanıcı ağırlıklı ortalaması.
anrRate28dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 28 gündeki anrRate metriğinin kullanıcı ağırlıklı ortalaması.
userPerceivedAnrRate (google.type.Decimal): Toplama döneminde, kullanıcı tarafından algılanan en az bir ANR yaşayan farklı kullanıcıların yüzdesi. Şu anda yalnızca "Giriş görev dağıtımı" ANR'leri sayılmaktadır.
userPerceivedAnrRate7dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 7 gün içindeki userPerceivedAnrRate metriğinin kullanıcı ağırlıklı ortalaması.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 28 gün içindeki userPerceivedAnrRate metriğinin kullanıcı ağırlıklı ortalaması.
distinctUsers (google.type.Decimal): Toplama döneminde verilerin mevcut olduğu yaklaşık kullanıcı sayısı.
vitals.crashrate Kullanıcı sayılarından bağımsız, normalleştirilmiş bir metrik oluşturmak için kullanım verileriyle birleştirilmiş kilitlenme verilerini içerir. crashRate (google.type.Decimal): Toplama döneminde en az bir kilitlenme yaşayan benzersiz kullanıcıların yüzdesi.
crashRate7dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 7 gün içindeki crashRate metriğinin kullanıcı ağırlıklı ortalaması.
crashRate28dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 28 gündeki crashRate metriğinin kullanıcı ağırlıklı ortalaması.
userPerceivedCrashRate (google.type.Decimal): Uygulama etkin olarak kullanılırken en az bir kilitlenme yaşayan, toplama dönemindeki farklı kullanıcıların yüzdesi.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 7 gün içindeki userPerceivedCrashRate metriğinin kullanıcı ağırlıklı ortalaması.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 28 gün içindeki userPerceivedCrashRate metriğinin kullanıcı ağırlıklı ortalaması.
distinctUsers (google.type.Decimal): Toplama döneminde verilerin mevcut olduğu yaklaşık kullanıcı sayısı.
vitals.lmkrate Kullanıcı sayılarından bağımsız, normalleştirilmiş bir metrik oluşturmak için kullanım verileriyle birleştirilmiş LMK (düşük bellek sorunu nedeniyle işlem sonlandırma) verilerini içerir. userPerceivedLmkRate (google.type.Decimal): Toplama döneminde, uygulamanızı aktif olarak kullanırken en az bir LMK (düşük bellek nedeniyle işlem sonlandırma) yaşayan farklı kullanıcıların yüzdesi. Herhangi bir etkinlik gösteren veya herhangi bir ön plan hizmeti yürüten uygulamalar aktif olarak kullanılıyor kabul edilir.
userPerceivedLmkRate7dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 7 gün içindeki userPerceivedLmkRate metriğinin kullanıcı ağırlıklı ortalaması.
userPerceivedLmkRate28dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 28 gün içindeki userPerceivedLmkRate metriğinin kullanıcı ağırlıklı ortalaması.
distinctUsers (google.type.Decimal): Toplama döneminde verilerin mevcut olduğu yaklaşık kullanıcı sayısı.
vitals.excessivewakeuprate Kullanıcı sayılarından bağımsız normalleştirilmiş bir metrik oluşturmak için AlarmManager uyandırma sayısı verilerini işlem durumu verileriyle birleştirerek içerir. excessiveWakeupRate (google.type.Decimal): Toplama döneminde saat başına 10'dan fazla uyandırma deneyimi yaşayan tekil kullanıcıların yüzdesi. excessiveWakeupRate7dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 7 gün içindeki excessiveWakeupRate metriğinin kullanıcı ağırlıklı ortalaması.
excessiveWakeupRate28dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 28 gündeki excessiveWakeupRate metriğinin kullanıcı ağırlıklı ortalaması.
distinctUsers (google.type.Decimal): Toplama döneminde verilerin mevcut olduğu yaklaşık kullanıcı sayısı.
vitals.stuckbackgroundwakelockrate Kullanıcı sayılarından bağımsız normalleştirilmiş bir metrik oluşturmak için işlem durumu verileriyle birleştirilmiş PowerManager wakelock süresi verilerini içerir. stuckBgWakelockRate (google.type.Decimal): Toplama döneminde, arka planda 1 saatten uzun süre uyanık kalma kilidi tutan farklı kullanıcıların yüzdesi. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 7 gün içinde stuckBgWakelockRate metriğinin kullanıcı ağırlıklı ortalaması.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 28 gün içinde stuckBgWakelockRate metriğinin kullanıcı ağırlıklı ortalaması.
distinctUsers (google.type.Decimal): Toplama döneminde verilerin mevcut olduğu yaklaşık kullanıcı sayısı.
vitals.slowstartuprate Uygulama başlatma türüne (baştan başlatma, hazırda başlatma, çalışır durumda başlatma) göre ayrılmış yavaş uygulama başlatma verilerini içerir. slowStartRate (google.type.Decimal): Toplama döneminde yavaş başlatma etkinliği olan farklı kullanıcıların yüzdesi. slowStartRate7dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 7 gün içindeki slowStartRate metriğinin kullanıcı ağırlıklı ortalaması.
slowStartRate28dUserWeighted (google.type.Decimal): Tarih dahil olmak üzere son 28 gündeki slowStartRate metriğinin kullanıcı ağırlıklı ortalaması.
distinctUsers (google.type.Decimal): Toplama döneminde verilerin mevcut olduğu yaklaşık kullanıcı sayısı.
vitals.errors.counts Normalleştirilmemiş hata raporu sayılarını içerir. Lütfen dikkat: 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 hata raporlarının mutlak sayısı.

Boyutlar

Her metrik kümesi, filtreleme ve dökümler için farklı bir boyut kümesini 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. Android'de uygulama sürüm oluşturma hakkında daha fazla bilgi için burayı inceleyin.
countryCode IP adresine göre kullanıcının ülkesinin veya bölgesinin tanımlayıcısı.2 harfli ISO-3166 kodu olarak gösterilir (ör. ABD için US).

Cihaz Boyutları

Bunlar, cihaza ve cihazın yazılım ve donanım özelliklerine özgü boyutlardır.

Boyut Açıklama
apiLevel Veriler yakalandığı sırada 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 bunların API düzeyleriyle nasıl eşlendiği hakkında bilgi edinmek için buraya bakı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 form faktörünün tanımlayıcısı.
deviceRamBucket Cihazın MB cinsinden RAM'i (3 GB, 4 GB vb.).
deviceSocMake Cihazın birincil çip üzerinde sisteminin markası (ör. Samsung. Buraya bakın.
deviceSocModel Cihazın birincil çip üzerinde sisteminin model adı (ör. "Exynos 2100". Buraya bakın.
deviceCpuMake Cihazın CPU'sunun markası (ör. Qualcomm.
deviceCpuModel Cihazın CPU'sunun modeli (ör. "Kryo 240".
deviceGpuMake Cihazın GPU'sunun markası (ör. ARM.
deviceGpuModel Cihazın GPU'sunun modeli (ör. Mali.
deviceGpuVersion Cihazın GPU'sunun 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, LARGE.
deviceScreenDpi Cihazın ekran yoğunluğu (ör. mdpi, hdpi).