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.anonrssandswapmemoryusage |
มีข้อมูลการใช้งานหน่วยความจำ RSS แบบไม่ระบุตัวตนและ Swap รวมกับข้อมูลการใช้งาน |
anonRssAndSwapMemoryUsageP50 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 50 ของ RSS แบบไม่ระบุตัวตนและ
การใช้งานหน่วยความจำ Swap anonRssAndSwapMemoryUsageP75 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 75 ของ RSS แบบไม่ระบุตัวตนและ การใช้งานหน่วยความจำ Swap anonRssAndSwapMemoryUsageP90 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 90 ของ RSS แบบไม่ระบุตัวตนและ การใช้งานหน่วยความจำ Swap anonRssAndSwapMemoryUsageP95 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 95 ของ RSS แบบไม่ระบุตัวตนและ การใช้งานหน่วยความจำ Swap anonRssAndSwapMemoryUsageP99 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 99 ของ RSS แบบไม่ระบุตัวตนและ การใช้งานหน่วยความจำ Swap distinctUsers (google.type.Decimal): จำนวนผู้ใช้ที่ไม่ซ้ำกันที่มีการรายงานเมตริกหน่วยความจำ ในช่วงการรวมข้อมูล โปรดระมัดระวังไม่ให้รวมจำนวนนี้ เพิ่มเติม เนื่องจากอาจส่งผลให้ระบบนับผู้ใช้หลายครั้ง ระบบจะปัดเศษค่าเป็น ค่าทวีคูณที่ใกล้เคียงที่สุดของ 10, 100, 1,000 หรือ 1,000,000 โดยขึ้นอยู่กับขนาดของค่า |
vitals.bitmapmemoryusage |
มีข้อมูลการใช้งานหน่วยความจำบิตแมปรวมกับข้อมูลการใช้งาน |
bitmapMemoryUsageP50 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 50 ของการใช้งานหน่วยความจำบิตแมป
bitmapMemoryUsageP75 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 75 ของหน่วยความจำบิตแมป ที่ใช้ bitmapMemoryUsageP90 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 90 ของการใช้งานหน่วยความจำบิตแมป bitmapMemoryUsageP95 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 95 ของหน่วยความจำบิตแมป การใช้งาน bitmapMemoryUsageP99 (google.type.Decimal): เปอร์เซ็นไทล์ที่ 99 ของการใช้งานหน่วยความจำบิตแมป distinctUsers (google.type.Decimal): จำนวนผู้ใช้ที่ไม่ซ้ำกันที่มีการรายงานเมตริกหน่วยความจำ ในช่วงการรวมข้อมูล โปรดระมัดระวังไม่ให้รวมจำนวนนี้ เพิ่มเติม เนื่องจากอาจส่งผลให้ระบบนับผู้ใช้หลายครั้ง ระบบจะปัดเศษค่าเป็น ค่าทวีคูณที่ใกล้เคียงที่สุดของ 10, 100, 1,000 หรือ 1,000,000 โดยขึ้นอยู่กับขนาดของค่า |
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 |
มีข้อมูลระยะเวลา WakeLock ของ PowerManager รวมกับข้อมูลสถานะกระบวนการเพื่อสร้างเมตริกที่ได้มาตรฐานซึ่งไม่ขึ้นอยู่กับจํานวนผู้ใช้ |
stuckBgWakelockRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันใน
ระยะเวลาการรวบรวมข้อมูลที่มี Wakelock ค้างอยู่ในเบื้องหลังนานกว่า 1 ชั่วโมง
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ำหนักตามผู้ใช้
ของเมตริก stuckBgWakelockRate ในช่วง 7 วันจนถึงวันที่ระบุ stuckBgWakelockRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยถ่วงน้ำหนักของผู้ใช้ ของเมตริก stuckBgWakelockRate ในช่วง 28 วันจนถึงวันที่ระบุ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงการรวบรวม |
vitals.slowstartrate |
มีข้อมูลการเริ่มต้นแอปช้าที่แบ่งตามประเภทการเริ่มต้นแอป (Cold, Warm, Hot) |
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 อัลฟ่า 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 |