Method: vitals.anrrate.query

मेट्रिक सेट में मौजूद मेट्रिक के बारे में क्वेरी करता है.

एचटीटीपी अनुरोध

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/anrRateMetricSet}:query

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. संसाधन का नाम.

फ़ॉर्मैट: apps/{app}/anrRateMetricSet

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
फ़ील्ड
timelineSpec

object (TimelineSpec)

ज़रूरी नहीं. टाइमलाइन एग्रीगेशन पैरामीटर की जानकारी.

एग्रीगेशन की ये अवधियां इस्तेमाल की जा सकती हैं:

  • DAILY: मेट्रिक को कैलेंडर की तारीख के इंटरवल के हिसाब से एग्रीगेट किया जाता है. पहले की पाबंदियों की वजह से, डिफ़ॉल्ट और इस्तेमाल किया जा सकने वाला एकमात्र टाइमज़ोन America/Los_Angeles है.
  • HOURLY: मेट्रिक को हर घंटे के इंटरवल में एग्रीगेट किया जाता है. डिफ़ॉल्ट और इस्तेमाल किया जा सकने वाला एकमात्र टाइमज़ोन UTC है.
dimensions[]

string

ज़रूरी नहीं. मेट्रिक को स्लाइस करने के लिए डाइमेंशन.

इस्तेमाल किए जा सकने वाले डाइमेंशन:

  • apiLevel (string): उपयोगकर्ता के डिवाइस पर चल रहे Android का एपीआई लेवल. उदाहरण के लिए, 26.
  • versionCode (int64): उपयोगकर्ता के डिवाइस पर चल रहे ऐप्लिकेशन का वर्शन.
  • deviceModel (string): उपयोगकर्ता के डिवाइस मॉडल का यूनीक आइडेंटिफ़ायर. आइडेंटिफ़ायर का फ़ॉर्मैट 'deviceBrand/device' होता है.इसमें deviceBrand का मतलब Build.BRAND और device का मतलब Build.DEVICE होता है. उदाहरण के लिए, google/coral.
  • deviceBrand (string): उपयोगकर्ता के डिवाइस के ब्रैंड का यूनीक आइडेंटिफ़ायर, जैसे कि google.
  • deviceType (string): उपयोगकर्ता के डिवाइस का टाइप (इसे फ़ॉर्म फ़ैक्टर भी कहा जाता है), जैसे कि फ़ोन.
  • countryCode (string): उपयोगकर्ता के आईपी पते के आधार पर, उसके डिवाइस का देश या इलाका.इसे दो अक्षरों वाले ISO-3166 कोड के तौर पर दिखाया जाता है. जैसे, अमेरिका के लिए US.
  • deviceRamBucket (int64): डिवाइस की रैम, एमबी में, बकेट में (उदाहरण के लिए, 1-1.5 जीबी के लिए 1024, 4-6 जीबी के लिए 4096).
  • deviceSocMake (string): डिवाइस के प्राइमरी सिस्टम-ऑन-चिप का ब्रैंड, जैसे कि Samsung. रेफ़रंस
  • deviceSocModel (string): डिवाइस के प्राइमरी सिस्टम-ऑन-चिप का मॉडल, जैसे कि "Exynos 2100". रेफ़रंस
  • deviceCpuMake (string): डिवाइस के सीपीयू का ब्रैंड, जैसे कि Qualcomm.
  • deviceCpuModel (string): डिवाइस के सीपीयू का मॉडल. जैसे, "Kryo 240".
  • deviceGpuMake (string): डिवाइस के जीपीयू का मेक, जैसे कि ARM.
  • deviceGpuModel (string): डिवाइस के जीपीयू का मॉडल, जैसे कि Mali.
  • deviceGpuVersion (string): डिवाइस के जीपीयू का वर्शन, जैसे कि T750.
  • deviceVulkanVersion (string): डिवाइस का Vulkan वर्शन, जैसे कि "4198400".
  • deviceGlEsVersion (string): डिवाइस का OpenGL ES वर्शन, जैसे कि "196610".
  • deviceScreenSize (string): डिवाइस की स्क्रीन का साइज़, जैसे कि सामान्य, बड़ा.
  • deviceScreenDpi (string): डिवाइस की स्क्रीन डेंसिटी, जैसे कि mdpi, hdpi.
metrics[]

string

ज़रूरी नहीं. एग्रीगेट की जाने वाली मेट्रिक.

इस्तेमाल की जा सकने वाली मेट्रिक:

  • anrRate (google.type.Decimal): एग्रीगेशन की अवधि के दौरान, यूनीक उपयोगकर्ताओं का वह प्रतिशत जिन्हें कम से कम एक बार एएनआर की गड़बड़ी का सामना करना पड़ा.
  • anrRate7dUserWeighted (google.type.Decimal): पिछले सात दिनों में anrRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से तय किया जाता है. यह सुविधा, हर घंटे के हिसाब से डेटा देखने के लिए उपलब्ध नहीं है.
  • anrRate28dUserWeighted (google.type.Decimal): पिछले 28 दिनों में anrRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से तय किया जाता है. यह सुविधा, हर घंटे के हिसाब से डेटा देखने के लिए उपलब्ध नहीं है.
  • userPerceivedAnrRate (google.type.Decimal): एग्रीगेशन की अवधि के दौरान, यूनीक उपयोगकर्ताओं का प्रतिशत जिन्हें कम से कम एक बार यूज़र-पर्सीव्ड एएनआर का सामना करना पड़ा. फ़िलहाल, यूज़र-पर्सीव्ड एएनआर, 'इनपुट भेजने' से जुड़े एएनआर होते हैं.
  • userPerceivedAnrRate7dUserWeighted (google.type.Decimal): पिछले सात दिनों में userPerceivedAnrRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेटेज दिया जाता है. यह सुविधा, हर घंटे के हिसाब से डेटा देखने के लिए उपलब्ध नहीं है.
  • userPerceivedAnrRate28dUserWeighted (google.type.Decimal): पिछले 28 दिनों में userPerceivedAnrRate की रोलिंग औसत वैल्यू. हर दिन की वैल्यू को, उस दिन के यूनीक उपयोगकर्ताओं की संख्या के हिसाब से वेटेज दिया जाता है. नहीं . घंटे के हिसाब से उपलब्ध है.
  • distinctUsers (google.type.Decimal): एग्रीगेशन की अवधि के दौरान, यूनीक उपयोगकर्ताओं की संख्या. इसका इस्तेमाल, anrRate और userPerceivedAnrRate मेट्रिक के लिए नॉर्मलाइज़ेशन वैल्यू के तौर पर किया जाता है. अगर किसी उपयोगकर्ता ने एग्रीगेशन की अवधि के दौरान, ऐप्लिकेशन को फ़ोरग्राउंड में इस्तेमाल किया है, तो उसे इस मेट्रिक में गिना जाता है. इस संख्या को आगे एग्रीगेट न करने का ध्यान रखना चाहिए, क्योंकि इससे उपयोगकर्ताओं की गिनती कई बार हो सकती है. वैल्यू को उसके मैग्नीट्यूड के आधार पर, 10, 100,1,000 या 10,00, 000 के सबसे नज़दीकी मल्टीपल में राउंड किया जाता है.
filter

string

ज़रूरी नहीं. डेटा पर लागू करने के लिए फ़िल्टर. फ़िल्टर एक्सप्रेशन, AIP-160 स्टैंडर्ड का पालन करता है. साथ ही, यह सभी ब्रेकडाउन डाइमेंशन की समानता के हिसाब से फ़िल्टर करने की सुविधा देता है.

pageSize

integer

ज़रूरी नहीं. वापस किए गए डेटा का ज़्यादा से ज़्यादा साइज़.

अगर इसे तय न किया गया हो, तो ज़्यादा से ज़्यादा 1,000 लाइनें दिखेंगी. ज़्यादा से ज़्यादा वैल्यू 10,000 हो सकती है. इससे ज़्यादा वैल्यू डालने पर,उसे 10,000 कर दिया जाएगा.

pageToken

string

ज़रूरी नहीं. पिछले कॉल से मिला पेज टोकन. अगला पेज वापस पाने के लिए, यह जानकारी दें.

पेज पर नंबर डालते समय, अनुरोध में दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मैच होने चाहिए.

userCohort

enum (UserCohort)

ज़रूरी नहीं. उपयोगकर्ता के लिए चुनने के लिए व्यू. आउटपुट डेटा, चुने गए व्यू के हिसाब से होगा.

इस्तेमाल की जा सकने वाली वैल्यू:

  • OS_PUBLIC इससे सार्वजनिक तौर पर रिलीज़ किए गए Android के सभी वर्शन का डेटा चुना जा सकता है. यह डिफ़ॉल्ट रूप से होता है. ऊपर दिए गए सभी डाइमेंशन के साथ काम करता है.
  • APP_TESTERS उन उपयोगकर्ताओं का डेटा चुनने के लिए जिन्होंने टेस्टर बनने के लिए शामिल होना चुना है. ऊपर दिए गए सभी डाइमेंशन के साथ काम करता है.
  • OS_BETA सिर्फ़ Android के बीटा वर्शन से डेटा चुनने के लिए. इसमें Android के रिलीज़ किए गए वर्शन का डेटा शामिल नहीं होता. सिर्फ़ इन डाइमेंशन का इस्तेमाल किया जा सकता है:
  • versionCode (int64): उपयोगकर्ता के डिवाइस पर चल रहे ऐप्लिकेशन का वर्शन.

  • osBuild (string): उपयोगकर्ता के डिवाइस का ओएस बिल्ड, जैसे कि "T1B2.220916.004".

जवाब का मुख्य भाग

anrrate.query के लिए जवाब वाला मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
rows[]

object (MetricsRow)

डेटा की पंक्तियां दिखाई गईं.

nextPageToken

string

डेटा का अगला पेज फ़ेच करने के लिए, कंटिन्यूएशन टोकन.

अनुमति पाने के लिंक

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/playdeveloperreporting

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.