REST Resource: vitals.crashrate

ทรัพยากร: CrashRateMetricSet

ทรัพยากร Singleton ที่นําเสนอชุดของเมตริกข้อขัดข้อง

ชุดเมตริกนี้มีข้อมูลข้อขัดข้องรวมกับข้อมูลการใช้งานเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นกับจํานวนผู้ใช้

ระยะเวลาการรวมที่รองรับ:

  • DAILY: ระบบจะรวบรวมเมตริกในช่วงวันที่ตามปฏิทิน เนื่องจากข้อจํากัดที่ผ่านมา เขตเวลาที่รองรับมีเพียง America/Los_Angeles เท่านั้น
  • HOURLY: ระบบจะรวบรวมเมตริกเป็นรายชั่วโมง เขตเวลาเริ่มต้นและที่สนับสนุนเท่านั้นคือ UTC

เมตริกที่รองรับมีดังนี้

  • crashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ํากันในระยะเวลาการรวมซึ่งพบการขัดข้องอย่างน้อย 1 รายการ
  • crashRate7dUserWeighted (google.type.Decimal): มูลค่าเฉลี่ย crashRate ใน 7 วันที่ผ่านมา ค่ารายวันจะมีการถ่วงน้ําหนักด้วยจํานวนผู้ใช้ที่ไม่ซ้ํากันของวัน ไม่สนับสนุนในรายละเอียด HOURLY
  • crashRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยต่อเนื่อง crashRate ในช่วง 28 วันที่ผ่านมา ค่ารายวันจะมีการถ่วงน้ําหนักด้วยจํานวนผู้ใช้ที่ไม่ซ้ํากันของวัน ไม่สนับสนุนในรายละเอียด HOURLY
  • userPerceivedCrashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ําในระยะเวลาการรวมซึ่งพบการขัดข้องอย่างน้อย 1 รายการขณะที่ใช้แอปอยู่ (การขัดข้องที่ผู้ใช้รับรู้) แอปจะถือว่ามีการใช้งานอยู่หากแอปแสดงกิจกรรมหรือทําการทํางานอยู่เบื้องหน้าใดๆ
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): มูลค่าเฉลี่ย userPerceivedCrashRate ใน 7 วันที่ผ่านมา ค่ารายวันจะมีการถ่วงน้ําหนักด้วยจํานวนผู้ใช้ที่ไม่ซ้ํากันของวัน ไม่สนับสนุนในรายละเอียด HOURLY
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยต่อเนื่อง userPerceivedCrashRate ในช่วง 28 วันที่ผ่านมา ค่ารายวันจะมีการถ่วงน้ําหนักด้วยจํานวนผู้ใช้ที่ไม่ซ้ํากันของวัน ไม่สนับสนุนในรายละเอียด HOURLY
  • distinctUsers (google.type.Decimal): จํานวนของผู้ใช้ที่ไม่ซ้ํากันในระยะเวลาการรวมที่ใช้เป็นค่าการทําให้เป็นมาตรฐานสําหรับเมตริก crashRate และ userPerceivedCrashRate ระบบจะนับผู้ใช้ในเมตริกนี้หากผู้ใช้ใช้แอปอย่างสม่ําเสมอในช่วงการรวม แอปจะถือว่ามีการใช้งานอยู่หากแอปแสดงกิจกรรมหรือทําการทํางานอยู่เบื้องหน้าใดๆ โปรดระวังอย่ารวมการนับนี้เพิ่มเติม เนื่องจากอาจส่งผลให้ระบบนับผู้ใช้หลายครั้ง จะมีการปัดเศษค่าให้เป็นจํานวนทวีคูณที่ใกล้เคียงที่สุดของ 10, 100, 1,000 หรือ 1,000,000 โดยขึ้นอยู่กับขนาดของค่า

มิติข้อมูลที่รองรับมีดังนี้

  • apiLevel (string): ระดับ API ของ Android ที่ทํางานอยู่ในอุปกรณ์ของผู้ใช้ เช่น 26.
  • versionCode (int64): เวอร์ชันของแอปที่ใช้งานในอุปกรณ์ของผู้ใช้
  • deviceModel (string): ตัวระบุที่ไม่ซ้ําของรุ่นอุปกรณ์ของผู้ใช้ รูปแบบของตัวระบุคือ "deviceBrand/device" โดยที่ deviceBrand สอดคล้องกับ Build.BRAND และอุปกรณ์สอดคล้องกับ Build.DEVICE เช่น google/coral
  • deviceBrand (string): ตัวระบุที่ไม่ซ้ําสําหรับแบรนด์อุปกรณ์ของผู้ใช้ เช่น Google
  • deviceType (string): ประเภท (หรือที่เรียกว่ารูปแบบของอุปกรณ์) สําหรับอุปกรณ์ของผู้ใช้ เช่น โทรศัพท์
  • countryCode (string): ประเทศหรือภูมิภาคของอุปกรณ์ของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น สหรัฐอเมริกาสําหรับสหรัฐอเมริกา)
  • deviceRamBucket (int64): RAM ของอุปกรณ์ในหน่วย MB ในที่เก็บข้อมูล (3GB, 4GB ฯลฯ)
  • deviceSocMake (string): ทําอุปกรณ์หลักบนชิป เช่น Samsung ข้อมูลอ้างอิง
  • deviceSocModel (string): รุ่นของชิประบบหลักในอุปกรณ์ เช่น "Exynos 2100" ข้อมูลอ้างอิง
  • deviceCpuMake (string): ผู้ผลิต CPU ของอุปกรณ์ เช่น คุณภาพ
  • deviceCpuModel (string): รุ่นของ CPU ของอุปกรณ์ เช่น "Kryo 240"
  • deviceGpuMake (string): ผู้ผลิต GPU ของอุปกรณ์ เช่น ARM
  • deviceGpuModel (string): รุ่นของ GPU ของอุปกรณ์ เช่น มาลี
  • deviceGpuVersion (string): เวอร์ชันของ GPU ของอุปกรณ์ เช่น T750
  • deviceVulkanVersion (string): เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400"
  • deviceGlEsVersion (string): เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610"
  • deviceScreenSize (string): ขนาดหน้าจอของอุปกรณ์ เช่น ปกติ ขนาดใหญ่
  • deviceScreenDpi (string): ความหนาแน่นของหน้าจออุปกรณ์ เช่น mdpi, hdpi

สิทธิ์ที่จําเป็น: ในการเข้าถึงทรัพยากรนี้ ผู้ใช้ที่โทรต้องมีสิทธิ์ดูข้อมูลแอป (อ่านอย่างเดียว) สําหรับแอป

ชุดเมตริกที่เกี่ยวข้อง

  • vitals.errors มีข้อขัดข้องในเวอร์ชันที่ไม่ปกติ (จํานวนสัมบูรณ์)
  • vitals.errors มีเมตริกมาตรฐานเกี่ยวกับ ANR ซึ่งเป็นเมตริกความเสถียรอีกรายการ
การแสดง JSON
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
ช่อง
name

string

ชื่อทรัพยากร

รูปแบบ: apps/{app}/crashRateMetricSet

freshnessInfo

object (FreshnessInfo)

สรุปเกี่ยวกับความใหม่ของข้อมูลในทรัพยากรนี้

วิธีการ

get

อธิบายคุณสมบัติของชุดเมตริก

query

ค้นหาเมตริกในชุดเมตริก