ภาพรวม 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 เป็นเมธอดของการเรียกใช้รายงานเวอร์ชันแบบกลุ่ม ซึ่งช่วยให้สร้างรายงานได้หลายรายการโดยใช้การเรียก 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 (Early Preview) เมธอดนี้จะแสดงรายงาน Funnel ที่กำหนดเองของข้อมูลเหตุการณ์ Google Analytics การสำรวจ Funnel จะช่วยให้คุณได้เห็นภาพขั้นตอนต่างๆ ที่ผู้ใช้ใช้ในการดำเนินงาน และดูว่าจะประสบความสำเร็จหรือล้มเหลวในแต่ละขั้นตอนได้อย่างรวดเร็ว

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

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