มิติข้อมูลและเมตริกที่รองรับในการค้นหาในเมธอด Realtime ของ Analytics Data API วิธีการรายงานหลัก (RunReport
เช่น "
) ยอมรับมิติข้อมูลและเมตริก
ชุดอื่นที่ต่างจากวิธีการเรียลไทม์
ขนาด
สามารถขอมิติข้อมูลต่อไปนี้ในรายงานสำหรับพร็อพเพอร์ตี้ใดก็ได้ ระบุ "ชื่อ API" ในช่อง name
ของทรัพยากร Dimension
สำหรับคอลัมน์ของมิติข้อมูลในการตอบกลับรายงาน
ชื่อ API | ชื่อ UI | คำอธิบาย |
---|---|---|
appVersion | เวอร์ชันของแอป | versionName (Android) หรือเวอร์ชัน Bundle (iOS) แบบย่อของแอป |
audienceId | รหัสกลุ่มเป้าหมาย | ตัวระบุที่เป็นตัวเลขของกลุ่มเป้าหมาย ระบบจะรายงานผู้ใช้ในกลุ่มเป้าหมายที่ตนเป็นสมาชิกในช่วงวันที่ของรายงาน พฤติกรรมของผู้ใช้ในปัจจุบันจะไม่มีผลกับการเป็นสมาชิกกลุ่มเป้าหมายที่ผ่านมาในรายงาน |
audienceName | ชื่อกลุ่มเป้าหมาย | ชื่อที่กําหนดของกลุ่มเป้าหมาย ระบบจะรายงานผู้ใช้ในกลุ่มเป้าหมายที่ตนเป็นสมาชิกในช่วงวันที่ของรายงาน พฤติกรรมของผู้ใช้ในปัจจุบันจะไม่มีผลกับการเป็นสมาชิกกลุ่มเป้าหมายที่ผ่านมาในรายงาน |
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 นี้จะล้มเหลวหากพร็อพเพอร์ตี้ไม่ได้ลงทะเบียนมิติข้อมูลที่กำหนดเองระดับผู้ใช้นี้
ไวยากรณ์ทั่วไปสำหรับมิติข้อมูลที่กำหนดเองมีดังนี้ คุณสามารถค้นหาในเมธอด API ข้อมูลเมตาเพื่อแสดงมิติข้อมูลที่กำหนดเองทั้งหมดสำหรับพร็อพเพอร์ตี้
ชื่อ API ทั่วไป | คำอธิบาย |
---|---|
customUser:ชื่อพารามิเตอร์ | มิติข้อมูลที่กําหนดเองระดับผู้ใช้สําหรับ parameter_name |
Realtime API ไม่รองรับมิติข้อมูลที่กำหนดเองที่กำหนดขอบเขตระดับเหตุการณ์
เมตริก
คุณขอเมตริกต่อไปนี้ในรายงานสำหรับพร็อพเพอร์ตี้ใดก็ได้ ระบุ "ชื่อ API" ในช่อง name
ของทรัพยากร Metric
สำหรับคอลัมน์ของเมตริกในคำตอบของรายงาน
ชื่อ API | ชื่อ UI | คำอธิบาย |
---|---|---|
activeUsers | ผู้ใช้ที่ใช้งานอยู่ | จํานวนของผู้ใช้ที่ไม่ซ้ำกันซึ่งเข้าชมเว็บไซต์หรือแอปของคุณ |
Conversion | Conversion | จํานวนเหตุการณ์ Conversion เหตุการณ์จะทําเครื่องหมายเป็น Conversion ณ เวลารวบรวมข้อมูล การเปลี่ยนแปลงการทําเครื่องหมาย Conversion ของเหตุการณ์จะมีผลตั้งแต่นี้ไป คุณสามารถทําเครื่องหมายเหตุการณ์ใดก็ได้เป็น Conversion ใน Google Analytics และเหตุการณ์บางรายการ (เช่น first_open, purchase) จะทําเครื่องหมายเป็น Conversion โดยค่าเริ่มต้น ดูข้อมูลเพิ่มเติมได้จากเกี่ยวกับ Conversion |
eventCount | จำนวนเหตุการณ์ | จำนวนเหตุการณ์ |
screenPageViews | ยอดดู | จํานวนหน้าจอแอปหรือหน้าเว็บที่ผู้ใช้ดู นับการดูหน้าเว็บหรือหน้าจอเดียวซ้ำหลายครั้งด้วย (เหตุการณ์ screen_view + page_view) |
Realtime API ไม่รองรับเมตริกที่กำหนดเองซึ่งกำหนดขอบเขตระดับเหตุการณ์