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

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

ความใหม่

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

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

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

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

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

ชุดเมตริกที่พร้อมใช้งาน

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

ชุดเมตริก คำอธิบาย เมตริกที่รองรับ
vitals.anrrate มีข้อมูล ANR รวมกับข้อมูลการใช้งานเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นอยู่กับจำนวนผู้ใช้ anrRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในช่วงเวลาการรวม ที่พบ ANR อย่างน้อย 1 ครั้ง
anrRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของเมตริก anrRate ในช่วง 7 วันจนถึงวันที่ที่ระบุ
anrRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของเมตริก anrRate ในช่วง 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): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของเมตริก crashRate ในช่วง 7 วันจนถึงวันที่ที่ระบุ
crashRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของเมตริก crashRate ในช่วง 28 วันจนถึงวันที่ที่ระบุ
userPerceivedCrashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในช่วงเวลาการรวม ที่พบการขัดข้องอย่างน้อย 1 ครั้งขณะที่แอปมีการใช้งานอยู่
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของเมตริก userPerceivedCrashRate ในช่วง 7 วันจนถึงวันที่ที่ระบุ
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของเมตริก userPerceivedCrashRate ในช่วง 28 วันจนถึงวันที่ที่ระบุ
distinctUsers (google.type.Decimal): จำนวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงเวลาการรวม
vitals.lmkrate มีข้อมูล LMK (การหยุดทำงานเนื่องจากหน่วยความจำไม่เพียงพอ) รวมกับข้อมูลการใช้งานเพื่อสร้างเมตริกมาตรฐาน ที่ไม่ขึ้นอยู่กับจำนวนผู้ใช้ userPerceivedLmkRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในช่วงเวลาการรวมที่พบ LMK (การหยุดทำงานเนื่องจากหน่วยความจำไม่เพียงพอ) อย่างน้อย 1 ครั้งขณะที่กำลังใช้แอปของคุณอยู่ แอปจะถือว่ามีการใช้งานอยู่หากแสดงกิจกรรมใดๆ หรือเรียกใช้บริการที่ทำงานอยู่เบื้องหน้า
userPerceivedLmkRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของ เมตริก userPerceivedLmkRate ในช่วง 7 วันจนถึงวันที่ที่ระบุ
userPerceivedLmkRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ ของเมตริก userPerceivedLmkRate ในช่วง 28 วันจนถึงวันที่ที่ระบุ
distinctUsers (google.type.Decimal): จำนวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงเวลาการรวม
vitals.excessivewakeuprate มีข้อมูลจำนวนการปลุกระบบของ AlarmManager รวมกับข้อมูลสถานะกระบวนการเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นอยู่กับจำนวนผู้ใช้ excessiveWakeupRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันใน ช่วงเวลาการรวมที่พบการปลุกระบบมากกว่า 10 ครั้งต่อชั่วโมง excessiveWakeupRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของ เมตริก excessiveWakeupRate ในช่วง 7 วันจนถึงวันที่ที่ระบุ
excessiveWakeupRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ของ เมตริก excessiveWakeupRate ในช่วง 28 วันจนถึงวันที่ที่ระบุ
distinctUsers (google.type.Decimal): จำนวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงเวลาการรวม
vitals.stuckbackgroundwakelockrate มีข้อมูลระยะเวลาการล็อกการปลุกของ PowerManager รวมกับข้อมูลสถานะกระบวนการเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นอยู่กับจำนวนผู้ใช้ stuckBgWakelockRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในช่วงเวลาการรวมที่มีการล็อกการปลุกในเบื้องหลังนานกว่า 1 ชั่วโมง stuckBgWakelockRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ ของเมตริก stuckBgWakelockRate ในช่วง 7 วันจนถึงวันที่ที่ระบุ
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ ของเมตริก stuckBgWakelockRate ในช่วง 28 วันจนถึงวันที่ที่ระบุ
distinctUsers (google.type.Decimal): จำนวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงเวลาการรวม
vitals.slowstartrate มีข้อมูลการเริ่มต้นแอปช้าซึ่งแบ่งตามประเภทการเริ่มต้นแอป (เย็น อุ่น ร้อน) slowStartRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในช่วงเวลาการรวมที่พบเหตุการณ์การเริ่มต้นช้า slowStartRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ ของเมตริก slowStartRate ในช่วง 7 วันจนถึงวันที่ที่ระบุ
slowStartRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ ของเมตริก slowStartRate ในช่วง 28 วันจนถึงวันที่ที่ระบุ
distinctUsers (google.type.Decimal): จำนวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงเวลาการรวม
vitals.errors.counts มีจำนวนรายงานข้อผิดพลาดที่ไม่ได้ทำให้เป็นมาตรฐาน โปรดทราบว่า ขณะนี้ทรัพยากรนี้พร้อมใช้งานใน API เวอร์ชัน v1 alpha เท่านั้น
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 ในบัคเก็ต (3 GB, 4 GB ฯลฯ)
deviceSocMake ผู้ผลิตระบบหลักบนชิปของอุปกรณ์ เช่น Samsung ดู ที่นี่.
deviceSocModel ชื่อรุ่นของระบบหลักบนชิปของอุปกรณ์ เช่น "Exynos 2100" ดู ที่นี่.
deviceCpuMake ผู้ผลิต CPU ของอุปกรณ์ เช่น Qualcomm
deviceCpuModel รุ่น CPU ของอุปกรณ์ เช่น "Kryo 240"
deviceGpuMake ผู้ผลิต GPU ของอุปกรณ์ เช่น ARM
deviceGpuModel รุ่น GPU ของอุปกรณ์ เช่น Mali
deviceGpuVersion เวอร์ชัน GPU ของอุปกรณ์ เช่น T750
deviceVulkanVersion เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400"
deviceGlEsVersion เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610"
deviceScreenSize ขนาดหน้าจอของอุปกรณ์ เช่น ปกติ ใหญ่
deviceScreenDpi ความหนาแน่นของหน้าจอของอุปกรณ์ เช่น mdpi, hdpi