บันทึกการเปลี่ยนแปลง API การรายงานแบบเรียลไทม์ของ Google Analytics

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

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

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

บันทึกการเปลี่ยนแปลง API ของ Google Analytics ทั้งหมด
–
สมัครใช้บริการ rss

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

บันทึกการเปลี่ยนแปลงของ Reporting API ทั้งหมด
–
สมัครใช้บริการ rss

ประกอบด้วย API การรายงานหลัก, API การรายงาน Funnel หลากหลายแชแนล และ API การรายงานแบบเรียลไทม์

บันทึกการเปลี่ยนแปลงของ API การรายงานแบบเรียลไทม์
–
สมัครใช้บริการ rss

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

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

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

รุ่นนี้เป็นรุ่นที่มีการแก้ไขข้อบกพร่อง

  • รุ่นนี้แก้ไขปัญหาในการบังคับใช้ข้อจำกัดการกรองในการค้นหาแบบเรียลไทม์ของ 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 การรายงานแบบเรียลไทม์เพื่อดูรายละเอียดเพิ่มเติม