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