เอกสารนี้อธิบายเกี่ยวกับ API การรายงานแบบเรียลไทม์ของ Google Analytics หากต้องการข้อมูลอ้างอิงโดยละเอียดของ API โปรดอ่านเอกสารอ้างอิง API
เกริ่นนำ
Real Time Reporting API จะให้คุณขอข้อมูลแบบเรียลไทม์ได้ เช่น กิจกรรมแบบเรียลไทม์ในพร็อพเพอร์ตี้ของคุณ สำหรับผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์
คุณสามารถใช้ API การรายงานแบบเรียลไทม์เพื่อ:
- แสดงผู้มีสิทธิ์อ่านในหน้าเว็บและทำให้ผู้ใช้รู้สึกเร่งผู้ใช้ที่มองหาสินค้าที่มีพื้นที่โฆษณาจำกัด
- แสดงเนื้อหายอดนิยม เช่น หน้าเว็บที่ใช้งานอยู่ 10 อันดับแรก
- สร้างและแสดงหน้าแดชบอร์ดแบบเรียลไทม์
ซูเปอร์พร็อกซีของ Google Analytics
ใช้ SuperProxy ของ Google Analytics เพื่อจัดการรายละเอียดการใช้งานจำนวนมากสำหรับการทำงานกับ API ของ Google Analytics เกี่ยวกับการตรวจสอบสิทธิ์ การแคช และการเปลี่ยนรูปแบบการตอบกลับ API เป็นรูปแบบที่ใช้กับไลบรารีการแสดงภาพและแผนภูมิโดยตรง
ภาพรวมในเชิงแนวคิด
แนวคิดพื้นฐานที่เป็นพื้นฐานของ Real Time Reporting API มีดังนี้
- ความเกี่ยวข้องของรายงานกับผู้ใช้และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
- โครงสร้างของรายงานและวิธีสร้างคำค้นหา
- การทํางานกับการตอบกลับของ API
รายงาน ผู้ใช้ และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
ก่อนที่ผู้ใช้จะใช้แอปพลิเคชันเพื่อขอข้อมูลรายงานจากข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ได้ คุณต้องทำดังนี้
- เปิดใช้ Google Analytics API
- สร้าง ข้อมูลเข้าสู่ระบบสำหรับแอปพลิเคชันเพื่อเข้าถึง API
- ใส่ข้อมูลรับรองในแอปพลิเคชันของคุณ
เมื่อใช้แอปพลิเคชันเพื่อขอข้อมูลรายงาน ผู้ใช้ต้องให้สิทธิ์แอปพลิเคชันในการเข้าถึงข้อมูลในนามของตนเอง
ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) จะระบุด้วยรหัสข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) นอกเหนือจากเอนทิตีอื่นๆ เป็นส่วนหนึ่งของ ลำดับชั้นของบัญชี ผู้ใช้ พร็อพเพอร์ตี้ และข้อมูลพร็อพเพอร์ตี้ของ Google Analytics แอปพลิเคชันจะใช้ API การจัดการเพื่อข้ามลำดับชั้นนี้และรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ได้
การค้นหามิติข้อมูลและเมตริก
คุณค้นหาผ่าน API สำหรับข้อมูลรายงานของ Google Analytics ซึ่งประกอบด้วยมิติข้อมูลและเมตริก เมตริกคือการวัดกิจกรรมของผู้ใช้ในปัจจุบัน เช่น จํานวนผู้ใช้ที่ใช้งานอยู่ในพร็อพเพอร์ตี้ในขณะนี้ มิติข้อมูลแจกแจงเมตริกตามเกณฑ์ทั่วไปบางอย่าง เช่น แหล่งที่มาของการเข้าชม ตำแหน่งทางภูมิศาสตร์ ข้อมูลหน้าเว็บ ฯลฯ
ใช้ คู่มืออ้างอิงมิติข้อมูลและเมตริกเพื่อสำรวจมิติข้อมูลและเมตริกทั้งหมด [ที่เปิดเผยผ่าน] ที่ใช้ได้กับ API นอกจากนี้ ให้อ่าน คู่มืออ้างอิงสำหรับ API การรายงานแบบเรียลไทม์เพื่อดูวิธีระบุมิติข้อมูลและเมตริกในการค้นหา API
การทำงานกับรายงาน
ข้อมูลที่แสดงผลจาก API อาจมองได้ว่าเป็นตารางที่มีส่วนหัวและรายการแถว การตอบกลับของ API แต่ละรายการประกอบด้วยส่วนหัวที่อธิบายชื่อและประเภทข้อมูลของแต่ละคอลัมน์ การตอบกลับยังมีรายการแถว ซึ่งแต่ละแถวคือรายการของเซลล์ที่มีข้อมูลในลำดับเดียวกันกับส่วนหัว อ่าน คู่มืออ้างอิงสำหรับ API การรายงานแบบเรียลไทม์สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการตอบกลับของ API
นโยบายโควต้า
Real Time Reporting API แบบเรียลไทม์จะจัดการการค้นหาข้อมูลหลายล้านรายการ เราใช้ระบบโควต้าเพื่อป้องกันไม่ให้ระบบรับการดำเนินการมากเกินกว่าจะจัดการได้ และเพื่อกระจายทรัพยากรของระบบอย่างเท่าเทียม อ่านรายละเอียดเพิ่มเติมได้ในคู่มือ ขีดจำกัดและโควต้า
ขั้นตอนถัดไป
เมื่อเข้าใจวิธีการทำงานของ API แล้ว ให้เริ่มต้นใช้งานโดยทำดังนี้
- อ่าน คู่มือนักพัฒนาซอฟต์แวร์เพื่อดูวิธีทำงานกับ API
- ดูรายการข้อมูลทั้งหมดที่ใช้ได้ผ่าน API ใน คู่มืออ้างอิงมิติข้อมูลและเมตริก
- ไปที่หน้า ไลบรารีและตัวอย่างเพื่อดูรายการไลบรารีของไคลเอ็นต์ทั้งหมดที่พร้อมใช้งานซึ่งคุณใช้กับ API ได้