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

มิติข้อมูลและเมตริกที่รองรับในการค้นหาเมธอดเรียลไทม์ของ 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

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

เมตริก

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

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

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