มิติข้อมูลและเมตริกแบบเรียลไทม์

มิติข้อมูลและเมตริกที่รองรับในการค้นหาไปยังวิธีการแบบเรียลไทม์ของ Analytics Data API วิธีรายงานหลัก (เช่น RunReport) ยอมรับมิติข้อมูลและเมตริกชุดอื่นนอกเหนือจากเมธอดแบบเรียลไทม์

ขนาด

คุณขอมิติข้อมูลต่อไปนี้ในรายงานสำหรับพร็อพเพอร์ตี้ใดก็ได้ ระบุ "ชื่อ API" ในช่อง nameของแหล่งข้อมูล Dimension สําหรับคอลัมน์ของมิติข้อมูลในการตอบกลับรายงาน

ชื่อ API ชื่อ UI คำอธิบาย
appVersion เวอร์ชันของแอป versionName (Android) หรือเวอร์ชัน Bundle (iOS) แบบย่อของแอป
audienceId รหัสกลุ่มเป้าหมาย ตัวระบุตัวเลขของกลุ่มเป้าหมาย ระบบจะรายงานผู้ใช้ในกลุ่มเป้าหมายที่ผู้ใช้อยู่ในระหว่างช่วงวันที่ของรายงาน พฤติกรรมของผู้ใช้ในปัจจุบันจะไม่มีผลกับการเป็นสมาชิกกลุ่มเป้าหมายที่ผ่านมาในรายงาน
audienceName ชื่อกลุ่มเป้าหมาย ชื่อที่กําหนดของกลุ่มเป้าหมาย ระบบจะรายงานผู้ใช้ในกลุ่มเป้าหมายที่ผู้ใช้อยู่ในระหว่างช่วงวันที่ของรายงาน พฤติกรรมของผู้ใช้ในปัจจุบันจะไม่มีผลกับการเป็นสมาชิกกลุ่มเป้าหมายที่ผ่านมาในรายงาน
audienceResourceName ชื่อทรัพยากรกลุ่มเป้าหมาย ชื่อแหล่งข้อมูลของกลุ่มเป้าหมายนี้ ชื่อทรัพยากรมีทั้งตัวระบุคอลเล็กชันและตัวระบุทรัพยากรเพื่อระบุทรัพยากรที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่ชื่อทรัพยากร
city เมือง เมืองที่เกิดกิจกรรมของผู้ใช้
cityId รหัสเมือง รหัสทางภูมิศาสตร์ของเมืองที่เกิดกิจกรรมของผู้ใช้ ซึ่งดูจากที่อยู่ IP
country ประเทศ ประเทศที่เกิดกิจกรรมของผู้ใช้
countryId รหัสประเทศ รหัสทางภูมิศาสตร์ของประเทศที่เกิดกิจกรรมของผู้ใช้ ซึ่งดึงมาจากที่อยู่ IP ของผู้ใช้ จัดรูปแบบตามมาตรฐาน ISO 3166-1 alpha-2
deviceCategory หมวดหมู่ของอุปกรณ์ ชนิดของอุปกรณ์: เดสก์ท็อป แท็บเล็ต หรืออุปกรณ์เคลื่อนที่
eventName ชื่อเหตุการณ์ ชื่อเหตุการณ์
minutesAgo นาทีที่ผ่านมาแบบเรียลไทม์ จํานวนนาทีที่ผ่านมาที่รวบรวมเหตุการณ์ 00 คือนาทีปัจจุบัน และ 01 หมายถึงนาทีก่อนหน้า
platform แพลตฟอร์ม แพลตฟอร์มที่แอปหรือเว็บไซต์ทำงาน เช่น เว็บ, iOS หรือ Android หากต้องการระบุประเภทของสตรีมในรายงาน ให้ใช้ทั้ง platform และ streamId
streamId รหัสสตรีม ตัวระบุสตรีมข้อมูลที่เป็นตัวเลขสำหรับแอปหรือเว็บไซต์
streamName ชื่อสตรีม ชื่อสตรีมข้อมูลสําหรับแอปหรือเว็บไซต์
unifiedScreenName ชื่อหน้าและชื่อหน้าจอ ชื่อหน้า (เว็บ) หรือชื่อหน้าจอ (แอป) ที่บันทึกเหตุการณ์

มิติข้อมูลที่กำหนดเอง

Realtime Data API สร้างรายงานเกี่ยวกับมิติข้อมูลที่กําหนดเองระดับผู้ใช้ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับมิติข้อมูลที่กำหนดเองได้ที่พร็อพเพอร์ตี้ผู้ใช้ที่กําหนดเอง มิติข้อมูลที่กําหนดเองจะระบุไว้ในคําขอรายงาน API ตามชื่อและขอบเขตของพารามิเตอร์ของมิติข้อมูล เช่น รวม "customUser:last_level" ไว้ในคําขอ Data API เพื่อสร้างรายงานสําหรับมิติข้อมูลที่กําหนดเองระดับผู้ใช้ที่มีชื่อพารามิเตอร์ "last_level" คําขอ API นี้จะดำเนินการไม่สําเร็จหากพร็อพเพอร์ตี้ไม่ได้ลงทะเบียนมิติข้อมูลที่กำหนดเองระดับผู้ใช้นี้

ต่อไปนี้เป็นไวยากรณ์ทั่วไปสำหรับมิติข้อมูลที่กำหนดเอง คุณค้นหาโดยใช้เมธอด API ข้อมูลเมตาเพื่อแสดงมิติข้อมูลที่กำหนดเองทั้งหมดสำหรับพร็อพเพอร์ตี้ได้

ชื่อ API ทั่วไป คำอธิบาย
customUser:parameter_name มิติข้อมูลที่กําหนดเองระดับผู้ใช้สําหรับ parameter_name

Realtime API ไม่รองรับมิติข้อมูลที่กําหนดเองระดับเหตุการณ์

เมตริก

คุณขอเมตริกต่อไปนี้ในรายงานสําหรับพร็อพเพอร์ตี้ใดก็ได้ ระบุ "ชื่อ API" ในช่อง name ของทรัพยากร Metric สำหรับคอลัมน์ของเมตริกในคำตอบของรายงาน

ชื่อ API ชื่อ UI คำอธิบาย
activeUsers ผู้ใช้ที่ใช้งานอยู่ จํานวนของผู้ใช้ที่ไม่ซ้ำกันซึ่งเข้าชมเว็บไซต์หรือแอปของคุณ
eventCount จำนวนเหตุการณ์ จํานวนเหตุการณ์
keyEvents เหตุการณ์สำคัญ จํานวนเหตุการณ์สําคัญ การทําเครื่องหมายเหตุการณ์เป็นเหตุการณ์สําคัญจะส่งผลต่อรายงานนับตั้งแต่เวลาที่สร้าง แต่ไม่ได้เปลี่ยนแปลงข้อมูลย้อนหลัง คุณทําเครื่องหมายเหตุการณ์ใดก็ได้เป็นคีย์ใน Google Analytics และบางเหตุการณ์ (เช่น first_open หรือ purchase) จะได้รับการทําเครื่องหมายเป็นเหตุการณ์สําคัญโดยค่าเริ่มต้น
screenPageViews ยอดดู จํานวนหน้าจอแอปหรือหน้าเว็บที่ผู้ใช้ดู นับการดูหน้าเว็บหรือหน้าจอเดียวซ้ำหลายครั้งด้วย (เหตุการณ์ screen_view + page_view)

Realtime API ไม่รองรับเมตริกที่กําหนดเองระดับเหตุการณ์