บันทึกการเปลี่ยนแปลงของ Google Analytics Real Time Reporting API

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

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

สมัครรับข้อมูลบันทึกการเปลี่ยนแปลงที่เกี่ยวข้อง

รวม API คอลเล็กชัน การกำหนดค่า และการรายงานทั้งหมด

ประกอบด้วย API การรายงานหลัก, API การรายงาน Funnel หลากหลายแชแนล และ Real Time Reporting API

รุ่นนี้มีการเปลี่ยนแปลงโควต้าและขีดจำกัด API แบบเรียลไทม์ของ Analytics

การเรียกใช้ API การรายงานแบบเรียลไทม์ของ Analytics ที่ใช้ในการมีส่วนร่วมกับการเรียก 10,000 ครั้งต่อข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ต่อวันที่เทียบเท่ากับการเรียก Analytics API อื่นๆ ตอนนี้ระบบจะนับการเรียก API การรายงานแบบเรียลไทม์ของ Analytics แยกกัน ซึ่งหมายความว่าคุณสามารถทำการเรียกวันละ 10,000 ครั้งต่อข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) โดยใช้ Analytics Real Time Reporting API และ การเรียกเพิ่มอีก 10,000 ครั้งต่อวันต่อข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) โดยใช้ Analytics API อื่นๆ ได้ โปรดดูข้อมูลเพิ่มเติมในหน้าขีดจำกัดและโควต้า

การเปลี่ยนแปลงนี้ช่วยให้การจัดการโควต้ามีความละเอียดมากขึ้นและไม่ปลอดภัย ดังนั้น การเรียกบ่อยๆ โดยใช้ Analytics Real Time Reporting API จะไม่บล็อกการเรียก Analytics API อื่นๆ ทั้งหมดโดยไม่ตั้งใจในช่วงที่เหลือของวันสำหรับแต่ละโปรไฟล์

นี่คือรุ่นที่มีการแก้ไขข้อบกพร่อง

  • รุ่นนี้แก้ไขปัญหาในการบังคับใช้ข้อจำกัดการกรองในการค้นหา Real Time Reporting API คำขอที่มี rt:activeUsers และตัวกรองในมิติข้อมูลระดับเหตุการณ์จะทำให้เกิดข้อผิดพลาดสำหรับเหตุผล badRequest และมีข้อความระบุว่า OR operator not supported for a hit level filter ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อจํากัดการค้นหาได้ที่คู่มือนักพัฒนาซอฟต์แวร์ API การรายงานแบบเรียลไทม์

รุ่นนี้มีการเปลี่ยนชื่อมิติข้อมูลและเมตริก ดูการอ้างอิงมิติข้อมูลและเมตริกสำหรับรายการคำจำกัดความทั้งหมด

มิติข้อมูลและเมตริกที่เปลี่ยนชื่อ

มีการเปลี่ยนชื่อมิติข้อมูลและเมตริกต่อไปนี้ ดูรายละเอียดเกี่ยวกับการเปลี่ยนชื่อข้อมูลได้ในนโยบายการเลิกใช้งานข้อมูล

ผู้ใช้

  • มิติข้อมูล - rt:visitorType - ใช้ rt:userType แทน
  • เมตริก - rt:activeVisitors - ใช้ rt:activeUsers แทน

เลิกใช้คำนำหน้า ga: แล้ว

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

มิติข้อมูลและเมตริกใหม่

การอัปเดตนี้จะเพิ่มมิติข้อมูลและเมตริกใหม่ๆ ลงใน Real Time Reporting API ดูรายการทั้งหมดได้ที่การอ้างอิงมิติข้อมูลและเมตริก

การติดตามเหตุการณ์

  • มิติข้อมูล - rt:eventAction - การดำเนินการของเหตุการณ์
  • มิติข้อมูล - rt:eventCategory - หมวดหมู่ของเหตุการณ์
  • มิติข้อมูล - rt:eventLabel - ป้ายกำกับของเหตุการณ์
  • มิติข้อมูล - rt:totalEvents - จำนวนเหตุการณ์ทั้งหมดของโปรไฟล์ในทุกหมวดหมู่

การติดตามเป้าหมาย

  • มิติข้อมูล - rt:goalId - สตริงที่เกี่ยวข้องกับรหัสเป้าหมาย
  • เมตริก - rt:goalXXValue - ค่าตัวเลขทั้งหมดสำหรับหมายเลขเป้าหมายที่ขอ โดยที่ XX เป็นตัวเลขระหว่าง 1 ถึง 20
  • เมตริก - rt:goalValueAll - ค่าตัวเลขทั้งหมดสำหรับเป้าหมายทั้งหมดที่กำหนดไว้สำหรับโปรไฟล์ของคุณ
  • เมตริก - rt:goalXXCompletions - จำนวนความสำเร็จทั้งหมดสำหรับหมายเลขเป้าหมายที่ขอ โดยที่ XX เป็นตัวเลขระหว่าง 1 ถึง 20
  • เมตริก - rt:goalCompletionsAll - จำนวนความสำเร็จทั้งหมดสำหรับเป้าหมายทั้งหมดที่กำหนดไว้สำหรับโปรไฟล์ของคุณ

การติดตามผลของหน้าเว็บ

  • เมตริก - rt:pageViews - ยอดรวมของการดูหน้าเว็บ

การติดตามผลแอป

  • เมตริก - rt:screenViews - จำนวนการดูหน้าจอทั้งหมด

Real Time Reporting API รุ่นแรกในรุ่นเบต้าแบบจำกัด

  • Real Time Reporting API ในแบบเรียลไทม์จะช่วยให้คุณรายงานกิจกรรมที่เกิดขึ้นในพร็อพเพอร์ตี้ได้ในขณะนี้ คุณสามารถใช้ API การรายงานแบบเรียลไทม์ในการค้นหามิติข้อมูลและเมตริก เพื่อสร้างวิดเจ็ตและแดชบอร์ดบนเว็บที่แสดงต่อลูกค้า ไปที่ภาพรวมของ API การรายงานแบบเรียลไทม์เพื่อดูรายละเอียดเพิ่มเติม