ภาพรวม Analytics Data API

Google Analytics Data API v1 ให้คุณเข้าถึงข้อมูลรายงาน Google Analytics 4 (GA4) แบบเป็นโปรแกรม Google Analytics 4 ช่วยให้คุณเข้าใจวิธีที่ผู้คนใช้เว็บ, iOS หรือแอป Android ของคุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ Google Analytics 4

Google Analytics Data API v1 ช่วยให้คุณสามารถสร้างรายงานเพื่อตอบคำถามต่างๆ เช่น

  • ในสัปดาห์ที่ผ่านมาแอป Android ของฉันมีผู้ใช้ที่ใช้งานอยู่รายวันกี่คน
  • การดูหน้าเว็บแต่ละรายการจาก URL ยอดนิยม 10 อันดับแรกของเว็บไซต์ของฉันได้รับในช่วง 28 วันที่ผ่านมาเป็นจำนวนเท่าใด
  • แอป iOS ของฉันมีผู้ใช้ที่ใช้งานอยู่กี่รายต่อประเทศในช่วง 30 นาทีที่ผ่านมา

นอกจากนี้ Google Analytics Data API v1 ยังใช้เพื่อวัตถุประสงค์ต่อไปนี้ได้ด้วย

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

คู่มือเริ่มใช้งานฉบับย่อ

เรียกใช้ API เพื่อสร้างรายงานฉบับแรกได้โดยใช้โค้ดเพียงไม่กี่บรรทัด โปรดดูที่การเริ่มใช้งานอย่างรวดเร็วโดยใช้ไลบรารีของไคลเอ็นต์เพื่อเริ่มต้นใช้งาน มีไลบรารีของไคลเอ็นต์ใน Java, Python, Node.js และภาษาอื่นๆ ที่ช่วยให้ติดตั้งใช้งานได้ง่ายขึ้น

วิธีการที่ใช้ได้

  • runReport วิธีนี้แสดงผลรายงานที่กําหนดเองของข้อมูลเหตุการณ์ Google Analytics และเป็นวิธีที่แนะนําสําหรับการค้นหาในรายงานแบบง่าย
  • batchRunReports คือเมธอด runReport เวอร์ชันแบบกลุ่มที่ช่วยให้สร้างรายงานหลายฉบับได้โดยใช้การเรียก API รายการเดียว
  • runPivotReport เมธอดนี้จะแสดงรายงาน Pivot ที่กำหนดเองของข้อมูลเหตุการณ์ Google Analytics รายงาน Pivot มีรูปแบบขั้นสูงและชัดเจนกว่ารายงานปกติ ตาราง Pivot แต่ละรายการจะอธิบายคอลัมน์และแถวของมิติข้อมูลที่มองเห็นได้ในการตอบกลับของรายงาน
  • batchRunPivotReports นี่เป็นเวอร์ชันกลุ่มของเมธอด runPivotReport ที่ทำให้สร้างรายงานหลายฉบับได้โดยใช้การเรียก API รายการเดียว
  • getMetadata เมธอดนี้จะแสดงข้อมูลเมตา สำหรับมิติข้อมูลและเมตริกที่ใช้ได้ในวิธีการรายงาน ใช้ในการสำรวจ มิติข้อมูลและเมตริก การตอบกลับของวิธีการนี้จะรวมมิติข้อมูลและเมตริกที่กําหนดเองซึ่งใช้ได้กับพร็อพเพอร์ตี้ GA4 ที่ระบุด้วย
  • checkCompatibility วิธีการนี้จะแสดงมิติข้อมูลและเมตริกที่สามารถเพิ่มในคำขอรายงานได้ และคงความเข้ากันได้ไว้
  • runRealtimeReport เมธอดนี้จะแสดงรายงานข้อมูลเหตุการณ์แบบเรียลไทม์ที่ปรับแต่งสำหรับพร็อพเพอร์ตี้ของคุณ เหตุการณ์ จะปรากฏในรายงานแบบเรียลไทม์ในเวลาไม่กี่วินาทีหลังจากที่มีการส่งเหตุการณ์เหล่านั้นไปยัง Google Analytics รายงานแบบเรียลไทม์จะแสดงเหตุการณ์และข้อมูลการใช้งานในช่วงเวลาตั้งแต่ปัจจุบันจนถึง 30 นาทีที่ผ่านมา (สูงสุด 60 นาทีสําหรับพร็อพเพอร์ตี้ Google Analytics 360)
  • properties.audienceExports กลุ่มของเมธอดที่ช่วยให้สร้างการส่งออกกลุ่มเป้าหมายได้ ซึ่งรวมถึงภาพรวมของผู้ใช้ในกลุ่มเป้าหมาย
  • properties.recurringAudienceLists (เวอร์ชันตัวอย่างก่อนเปิดตัว) กลุ่มของเมธอดที่ช่วยให้จัดการการส่งออกกลุ่มเป้าหมายที่เกิดซ้ำได้ การส่งออกกลุ่มเป้าหมายที่เกิดซ้ำจะสร้างรายการกลุ่มเป้าหมายใหม่ทุกวัน
  • runFunnelReport (การแสดงตัวอย่างก่อนเปิดตัว) วิธีนี้จะแสดงผลรายงาน Funnel ที่กําหนดเองของข้อมูลเหตุการณ์ Google Analytics การสำรวจกระบวนการจะช่วยให้คุณได้เห็นภาพขั้นตอนต่างๆ ที่ผู้ใช้ใช้ในการดำเนินงาน และดูว่าจะประสบความสำเร็จหรือล้มเหลวในแต่ละขั้นตอนได้อย่างรวดเร็ว

มิติข้อมูลและเมตริกที่รองรับ

เอกสารประกอบเกี่ยวกับสคีมา API แสดงมิติข้อมูลและเมตริกที่ Analytics Data API รองรับในปัจจุบัน