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

มิติข้อมูลและเมตริกที่รองรับในการค้นหาไปยังเมธอดเรียลไทม์ของ 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 หากต้องการระบุประเภทของสตรีมในรายงาน ให้ใช้ทั้งแพลตฟอร์มและ streamId
streamId รหัสสตรีม ตัวระบุสตรีมข้อมูลที่เป็นตัวเลขสําหรับแอปหรือเว็บไซต์
streamName ชื่อสตรีม ชื่อสตรีมข้อมูลสําหรับแอปหรือเว็บไซต์
unifiedScreenName ชื่อหน้าและชื่อหน้าจอ ชื่อหน้า (เว็บ) หรือชื่อหน้าจอ (แอป) ที่บันทึกเหตุการณ์

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

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

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

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

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

เมตริก

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

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

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