ภาพรวม

เอกสารนี้อธิบายเกี่ยวกับ 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

รายงาน ผู้ใช้ และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)

ก่อนที่ผู้ใช้จะใช้แอปพลิเคชันเพื่อขอข้อมูลรายงานจากข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ได้ คุณต้องทำดังนี้

  1. เปิดใช้ Google Analytics API
  2. สร้าง ข้อมูลเข้าสู่ระบบสำหรับแอปพลิเคชันเพื่อเข้าถึง API
  3. ใส่ข้อมูลรับรองในแอปพลิเคชันของคุณ

เมื่อใช้แอปพลิเคชันเพื่อขอข้อมูลรายงาน ผู้ใช้ต้องให้สิทธิ์แอปพลิเคชันในการเข้าถึงข้อมูลในนามของตนเอง

ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) จะระบุด้วยรหัสข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) นอกเหนือจากเอนทิตีอื่นๆ เป็นส่วนหนึ่งของ ลำดับชั้นของบัญชี ผู้ใช้ พร็อพเพอร์ตี้ และข้อมูลพร็อพเพอร์ตี้ของ Google Analytics แอปพลิเคชันจะใช้ API การจัดการเพื่อข้ามลำดับชั้นนี้และรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ได้

การค้นหามิติข้อมูลและเมตริก

คุณค้นหาผ่าน API สำหรับข้อมูลรายงานของ Google Analytics ซึ่งประกอบด้วยมิติข้อมูลและเมตริก เมตริกคือการวัดกิจกรรมของผู้ใช้ในปัจจุบัน เช่น จํานวนผู้ใช้ที่ใช้งานอยู่ในพร็อพเพอร์ตี้ในขณะนี้ มิติข้อมูลแจกแจงเมตริกตามเกณฑ์ทั่วไปบางอย่าง เช่น แหล่งที่มาของการเข้าชม ตำแหน่งทางภูมิศาสตร์ ข้อมูลหน้าเว็บ ฯลฯ

ใช้ คู่มืออ้างอิงมิติข้อมูลและเมตริกเพื่อสำรวจมิติข้อมูลและเมตริกทั้งหมด [ที่เปิดเผยผ่าน] ที่ใช้ได้กับ API นอกจากนี้ ให้อ่าน คู่มืออ้างอิงสำหรับ API การรายงานแบบเรียลไทม์เพื่อดูวิธีระบุมิติข้อมูลและเมตริกในการค้นหา API

การทำงานกับรายงาน

ข้อมูลที่แสดงผลจาก API อาจมองได้ว่าเป็นตารางที่มีส่วนหัวและรายการแถว การตอบกลับของ API แต่ละรายการประกอบด้วยส่วนหัวที่อธิบายชื่อและประเภทข้อมูลของแต่ละคอลัมน์ การตอบกลับยังมีรายการแถว ซึ่งแต่ละแถวคือรายการของเซลล์ที่มีข้อมูลในลำดับเดียวกันกับส่วนหัว อ่าน คู่มืออ้างอิงสำหรับ API การรายงานแบบเรียลไทม์สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการตอบกลับของ API

นโยบายโควต้า

Real Time Reporting API แบบเรียลไทม์จะจัดการการค้นหาข้อมูลหลายล้านรายการ เราใช้ระบบโควต้าเพื่อป้องกันไม่ให้ระบบรับการดำเนินการมากเกินกว่าจะจัดการได้ และเพื่อกระจายทรัพยากรของระบบอย่างเท่าเทียม อ่านรายละเอียดเพิ่มเติมได้ในคู่มือ ขีดจำกัดและโควต้า

ขั้นตอนถัดไป

เมื่อเข้าใจวิธีการทำงานของ API แล้ว ให้เริ่มต้นใช้งานโดยทำดังนี้