ข้อมูลเบื้องต้นเกี่ยวกับชุดเมตริก

Google Play Developer Reporting API ช่วยให้คุณเข้าถึงเมตริก รายงาน และข้อมูลเกี่ยวกับไทม์ไลน์ของแอปได้ เพื่อให้การใช้งาน API เป็นเรื่องง่ายที่สุดเท่าที่จะเป็นไปได้ ชุดเมตริกจะเป็นมาตรฐานในการเข้าถึงเมตริก ชุดเมตริกคือการจัดกลุ่มเชิงตรรกะของเมตริกที่เกี่ยวข้องที่แชร์แอตทริบิวต์ทั่วไป (เช่น ความใหม่และความละเอียด) และอาจมีการค้นหาร่วมกันได้ ชุดเมตริกยังมีมิติข้อมูลจํานวนหนึ่งที่คุณสามารถใช้เพื่อกรองหรือแสดงรายละเอียด หากไม่ได้ระบุไว้เป็นอย่างอื่น เมตริกทั้งหมดอาจแจกแจงหรือกรองตามมิติข้อมูลที่มีทั้งหมด

ความใหม่

ทรัพยากรชุดเมตริกแต่ละรายการมีวิธี GET มาตรฐานในการเรียกวันที่และเวลาของจุดข้อมูลล่าสุดที่มีอยู่ หรือที่เรียกว่าความใหม่ เนื่องจากชุดเมตริกรองรับรายละเอียดได้หลายรายการ (รายวัน รายชั่วโมง) การดําเนินการจะแสดงค่าความใหม่ 1 ค่าต่อรายละเอียดที่รองรับ

คุณจะใช้ค่าความใหม่ได้โดยตรงเป็นปลายทางในช่วงเวลาค้นหา

การค้นหาข้อมูล

หากต้องการเข้าถึงข้อมูลในชุดเมตริก คุณควรใช้วิธี QUERY ที่กําหนดเองเพื่อออกคําค้นหา การค้นหาแต่ละรายการต้องระบุรายละเอียดและช่วงเวลา เมื่อพูดถึงเมตริกที่ต้องการเข้าถึง คุณควรระบุมิติข้อมูลที่ควรใช้เพื่อแจกแจงการรวม

โปรดใช้ความระมัดระวังเมื่อขอไทม์ไลน์เพื่อขอช่วงวันที่ เพื่อให้ขนาดของช่วงเวลามีสัดส่วนผกผันกับขนาดของแอปและจํานวนรายละเอียด เช่น แอปขนาดใหญ่ควรเลือกจํานวนวันในคําขอคําขอเดียวให้น้อยลงเพื่อหลีกเลี่ยงระยะหมดเวลาจากการค้นหาที่เกิดจากการอ่านข้อมูลมากเกินไป

ชุดเมตริกที่ใช้ได้

ดัชนีด้านล่างจะแสดงปลายทางและข้อมูลที่เกี่ยวข้องทั้งหมดที่คุณสามารถส่งคําขอได้

ชุดเมตริก	คำอธิบาย	เมตริกที่รองรับ
vitals.anrrate	มีข้อมูล ANR รวมกับข้อมูลการใช้งานเพื่อสร้างเมตริกมาตรฐานโดยไม่ขึ้นอยู่กับจํานวนผู้ใช้	anrRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ํากันในระยะเวลาการรวมที่พบ ANR อย่างน้อย 1 ครั้ง anrRate7dUserweighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ําหนักผู้ใช้ของเมตริก arRate ในช่วง 7 วันจนถึงวันที่ anrRate28dUserweighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ําหนักของผู้ใช้ของเมตริก arRate ในช่วง 28 วันจนถึงวันที่ userPerceivedAnrRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ําในระยะเวลาการรวม ที่พบ ANR อย่างน้อย 1 ครั้งต่อผู้ใช้ ปัจจุบันมีการนับ ANR ของ "การจ่ายงานเข้า" userPerceivedAnrRate7dUserweighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ําหนักผู้ใช้ของเมตริก userPerceivedAnrRate ในช่วง 7 วันจนถึงวันที่ระบุ userPerceivedAnrRate28dUserweighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ําหนักผู้ใช้ของเมตริก userPerceivedAnrRate ในช่วง 28 วันจนถึงวันที่ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่ข้อมูลมี ในระยะเวลาการรวม
vitals.crashrate	มีข้อมูลข้อขัดข้องร่วมกับข้อมูลการใช้งานเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นอยู่กับจํานวนผู้ใช้	crashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ําในระยะเวลาการรวมที่พบการขัดข้องอย่างน้อย 1 ครั้ง crashRate7dUserweighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ําหนักของผู้ใช้จากเมตริกข้อขัดข้องของอัตราราคาในช่วง 7 วันจนถึงวันที่ crashRate28dUserweighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ําหนักผู้ใช้ของเมตริกข้อขัดข้องอัตราภายใน 28 วันจนถึงวันที่ userPerceivedCrashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ําในระยะเวลาการรวมที่พบข้อขัดข้องอย่างน้อย 1 ครั้งขณะที่แอปทํางานอยู่ userPerceivedCrashRate7dUserweighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ําหนักผู้ใช้ของเมตริก userPerceivedCrashRate ในช่วง 7 วันจนถึงวันที่ userPerceivedCrashRate28dUserweighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ําหนักผู้ใช้ของเมตริก userPerceivedCrashRate ในช่วง 28 วันจนถึงวันที่ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่ข้อมูลมี ในระยะเวลาการรวม
vitals.excessivewakeuprate	มีข้อมูลการปลุกระบบของ Alarm Manager ที่รวมกับข้อมูลสถานะการประมวลผลเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นอยู่กับจํานวนผู้ใช้	exติดต่อiveWakeupRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ําในระยะเวลาการรวมที่มีการปลุกระบบมากกว่า 10 ครั้งต่อชั่วโมง exติดต่อiveWakeupRate7dUserweighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ําหนักโดยผู้ใช้ของเมตริกมากเกินไปของ WakeupRate ในช่วง 7 วันจนถึงวันที่ exติดต่อiveWakeupRate28dUserweighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ําหนักของผู้ใช้ของเมตริก WakeupRate ที่มากเกินไปในช่วง 28 วันจนถึงวันที่ระบุ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่ข้อมูลมี ในระยะเวลาการรวม
vitals.stuckbackgroundwakelockrate	มีข้อมูล Wake Lock ของ PowerManager ที่รวมกับข้อมูลสถานะกระบวนการเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นอยู่กับจํานวนผู้ใช้	stuckBgWakelockRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ําในระยะเวลาการรวมที่มี Wake Lock อยู่เบื้องหลังนานกว่า 1 ชั่วโมง stuckBgWakelockRate7dUserweighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ําหนักของผู้ใช้จากเมตริก StickBgWakelockRate ที่ถ่วงน้ําหนักในช่วง 7 วันจนถึงวันที่ stuckBgWakelockRate28dUserweighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ําหนักของผู้ใช้จากเมตริกที่ค้างอยู่ของ adggakeakeRate ในช่วง 28 วันจนถึงวันที่ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่ข้อมูลมี ในระยะเวลาการรวม
vitals.slowstartuprate	มีข้อมูลการเริ่มแอปช้าที่แบ่งตามประเภทการเริ่มต้นแอป (เย็น ร้อน ร้อน)	slowStartRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ําในระยะเวลาการรวมที่มีเหตุการณ์การเริ่มต้นที่ช้า slowStartRate7dUserweighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ําหนักของผู้ใช้จากเมตริกช้าลงของ StartStart ในช่วง 7 วันจนถึงวันที่ slowStartRate28dUserweighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ําหนักผู้ใช้ของเมตริกช้าของ StartStartRate ในช่วง 28 วันจนถึงวันที่ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่ข้อมูลมี ในระยะเวลาการรวม
vitals.errors.counts	มีจํานวนรายงานข้อผิดพลาดที่ไม่ผิดปกติ	หมายเหตุ: ขณะนี้ทรัพยากรนี้มีให้ใช้ใน API เวอร์ชัน v1 อัลฟ่าเท่านั้น errorReportCount (google.type.Decimal): จํานวนสัมบูรณ์ของรายงานข้อผิดพลาดแต่ละรายการที่ได้รับจากแอป

ขนาด

ชุดเมตริกแต่ละชุดรองรับชุดมิติข้อมูลที่แตกต่างกันสําหรับการกรองและรายละเอียด ดูรายการมิติข้อมูลที่พร้อมใช้งานใน API ได้ในดัชนีมิติข้อมูลด้านล่าง

มิติข้อมูล	คำอธิบาย
versionCode	รหัสเวอร์ชันของแอปที่ทํางานในอุปกรณ์ของผู้ใช้ในเวลาที่มีการบันทึกข้อมูล ค่าสตริงของมิติข้อมูลนี้สามารถแยกวิเคราะห์เป็นจํานวนเต็ม ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการทํางานของการกําหนดเวอร์ชันแอปใน Android ได้ที่นี่
countryCode	ตัวระบุประเทศหรือภูมิภาคของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น US สําหรับสหรัฐอเมริกา)

ขนาดอุปกรณ์

มิติข้อมูลเหล่านี้เป็นมิติข้อมูลเฉพาะสําหรับอุปกรณ์ รวมถึงลักษณะเฉพาะของซอฟต์แวร์และฮาร์ดแวร์

มิติข้อมูล	คำอธิบาย
apiLevel	ระดับ API ของ Android ที่ทํางานในอุปกรณ์ของผู้ใช้ในขณะที่บันทึกข้อมูล ค่าสตริงของมิติข้อมูลนี้สามารถแยกวิเคราะห์เป็นจํานวนเต็ม ดูรายการรุ่นของ Android และวิธีจับคู่กับระดับ API ได้ที่นี่
deviceModel	ตัวระบุของรุ่นอุปกรณ์หนึ่งๆ ตามที่กําหนดโดยแคตตาล็อกอุปกรณ์ Play Console
deviceType	ตัวระบุปัจจัยของอุปกรณ์หนึ่งๆ ตามที่ใช้ในแคตตาล็อกอุปกรณ์ Play Console
deviceRamBucket	RAM ของอุปกรณ์ หน่วยเป็น MB ในที่เก็บข้อมูล (3GB, 4GB เป็นต้น)
deviceSocMake	ยี่ห้อหลักของอุปกรณ์บนชิป เช่น Samsung ดูที่นี่
deviceSocModel	ชื่อรุ่นของชิปหลักในอุปกรณ์ เช่น "Exynos 2100" ดูที่นี่
deviceCpuMake	ยี่ห้อ CPU ของอุปกรณ์ เช่น คุณภาพ
deviceCpuModel	รุ่นของ CPU ของอุปกรณ์ เช่น "Kryo 240"
deviceGpuMake	ยี่ห้อของ GPU ของอุปกรณ์ เช่น ARM
deviceGpuModel	รุ่นของ GPU ของอุปกรณ์ เช่น มาลี
deviceGpuVersion	เวอร์ชัน GPU ของอุปกรณ์ เช่น T750
deviceVulkanVersion	เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400"
deviceGlEsVersion	เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610"
deviceScreenSize	ขนาดหน้าจอของอุปกรณ์ เช่น ปกติ ใหญ่
deviceScreenDpi	ความหนาแน่นหน้าจอของอุปกรณ์ เช่น mdpi, hdpi