คุณใช้ Data API เพื่อเข้าถึงข้อมูลรายงานของ Google Analytics (GA4) แบบเป็นโปรแกรมได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ของ Google Analytics
ข้อมูลที่ API แสดงจะสอดคล้องกับข้อมูลที่แสดงในอินเทอร์เฟซผู้ใช้ของ Google Analytics และเป็นไปตามการตั้งค่าข้อมูลระบุตัวตนในการรายงานอย่างครบถ้วน เช่น แบบผสม สังเกต หรืออิงตามอุปกรณ์ ซึ่งกําหนดค่าไว้สําหรับพร็อพเพอร์ตี้ Google Analytics
ตัวอย่างบางส่วนที่คุณอาจรายงานโดยใช้ Google Analytics Data API v1 มีดังนี้
- แอป Android ของคุณมีผู้ใช้ที่ใช้งานอยู่รายวันเท่าใดในสัปดาห์ที่แล้ว
- จำนวนการดูหน้าเว็บที่หน้าเว็บ 10 อันดับแรกในเว็บไซต์ของคุณได้รับในช่วง 28 วันที่ผ่านมา
- แอป iOS ของคุณมีผู้ใช้ที่ใช้งานอยู่ในแต่ละประเทศเท่าใดในช่วง 30 นาทีที่ผ่านมา
นอกจากนี้ คุณยังใช้ Google Analytics Data API v1 เพื่อทําสิ่งต่อไปนี้ได้ด้วย
- สร้างแดชบอร์ดที่กำหนดเองเพื่อแสดงข้อมูล Google Analytics
- ปรับให้งานการรายงานที่ซับซ้อนทำงานโดยอัตโนมัติเพื่อประหยัดเวลา
- ผสานรวมข้อมูล Google Analytics กับแอปพลิเคชันทางธุรกิจอื่นๆ
ความสอดคล้องของข้อมูลและข้อมูลระบุตัวตนในการรายงาน
Google Analytics Data API v1 เข้าถึงข้อมูลการรายงานเดียวกันกับอินเทอร์เฟซ Google Analytics ข้อมูลที่ API แสดงจะสอดคล้องกับการตั้งค่า ข้อมูลระบุตัวตนในการรายงานที่กําหนดค่าไว้สําหรับพร็อพเพอร์ตี้ Google Analytics อย่างเต็มที่ ดังนั้น จํานวนผู้ใช้ การกรองข้อมูลที่ซ้ำกันออก และการประมาณข้อมูลจึงสอดคล้องกับ พื้นที่การระบุตัวตนที่เลือก เช่น ผสม สังเกต หรืออิงตามอุปกรณ์ ใน การตั้งค่าพร็อพเพอร์ตี้
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่พื้นที่การระบุตัวตนต่างๆ ส่งผลต่อรายงานได้ที่ข้อมูลระบุตัวตนในการรายงาน
เริ่มต้นใช้งาน
หากต้องการเริ่มต้นใช้งาน โปรดดูคู่มือเริ่มใช้งานฉบับย่อของไลบรารีของไคลเอ็นต์ มีไลบรารีของไคลเอ็นต์ใน Java, Python, Node.js และภาษาอื่นๆ เพื่อให้การติดตั้งใช้งานง่ายขึ้น
วิธีการที่ใช้ได้
รายการเมธอด Data API มีดังนี้ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบอ้างอิง
runReportวิธีนี้จะแสดงรายงานที่กำหนดเองของข้อมูลเหตุการณ์ Google Analytics และเป็นวิธีที่แนะนําสําหรับการค้นหารายงานอย่างง่ายbatchRunReportsนี่คือ เมธอด runReport เวอร์ชันกลุ่ม ซึ่งช่วยให้คุณสร้างรายงานหลายฉบับได้ โดยใช้การเรียก API เพียงครั้งเดียวrunPivotReportวิธีนี้จะ แสดงรายงาน Pivot ที่กําหนดเองของข้อมูลเหตุการณ์ Google Analytics รายงาน Pivot เป็นรูปแบบที่ซับซ้อนและสื่อความหมายได้มากกว่ารายงานปกติ แต่ละ Pivot จะอธิบายคอลัมน์และแถวมิติข้อมูลที่มองเห็นได้ในการตอบกลับของรายงานbatchRunPivotReportsนี่คือเมธอด runPivotReport เวอร์ชันกลุ่มที่ช่วยให้คุณสร้าง รายงานหลายรายการได้โดยใช้การเรียก API เพียงครั้งเดียวgetMetadataวิธีนี้จะแสดงผลข้อมูลเมตาสำหรับมิติข้อมูลและเมตริกที่ใช้ได้ในวิธีการรายงาน ใช้เพื่อ สํารวจมิติข้อมูลและเมตริก การตอบกลับของเมธอดนี้ยังรวมถึงมิติข้อมูลและเมตริกที่กําหนดเองที่ใช้ได้สําหรับพร็อพเพอร์ตี้ Google Analytics ที่ระบุด้วยcheckCompatibilityวิธีนี้จะแสดงมิติข้อมูลและเมตริกที่เพิ่มลงในคำขอรายงานได้ และยังคงความเข้ากันได้runRealtimeReportวิธีนี้จะส่งคืนรายงานข้อมูลเหตุการณ์แบบเรียลไทม์ที่กําหนดเอง สําหรับพร็อพเพอร์ตี้ เหตุการณ์จะปรากฏในรายงานแบบเรียลไทม์ภายในไม่กี่วินาทีหลังจากที่ส่งไปยัง Google Analytics รายงานแบบเรียลไทม์แสดงเหตุการณ์และข้อมูลการใช้งาน สําหรับช่วงเวลาตั้งแต่ปัจจุบันจนถึง 30 นาที ที่ผ่านมา (สูงสุด 60 นาทีสําหรับพร็อพเพอร์ตี้ Google Analytics 360)properties.audienceExportsชุดเมธอดที่ช่วยให้คุณสร้างการส่งออกกลุ่มเป้าหมาย ซึ่งรวมถึงสแนปชอตของผู้ใช้ใน กลุ่มเป้าหมายproperties.recurringAudienceLists(เวอร์ชันตัวอย่างทดลองใช้) กลุ่มวิธีการที่ช่วยให้คุณจัดการการส่งออกกลุ่มเป้าหมายที่เกิดซ้ำได้ การส่งออกกลุ่มเป้าหมายที่เกิดซ้ำจะสร้างรายการกลุ่มเป้าหมายใหม่ ทุกวันrunFunnelReport(เวอร์ชันตัวอย่างทดลองใช้) วิธีนี้จะแสดงรายงาน Funnel ที่ปรับแต่งเองของข้อมูลเหตุการณ์ Google Analytics การสํารวจ Funnel ช่วยให้คุณได้เห็นภาพขั้นตอนต่างๆ ที่ผู้ใช้ใช้ในการดำเนินงาน และดูว่าจะประสบความสําเร็จหรือล้มเหลวในแต่ละขั้นตอนได้อย่างรวดเร็วproperties.chat(เวอร์ชันตัวอย่างทดลองใช้) วิธีนี้ให้สิทธิ์เข้าถึงแบบสนทนาแบบเป็นโปรแกรม ไปยัง Ask Advisor ใน Google Analytics คุณสามารถ ถามคำถามเกี่ยวกับข้อมูลเหตุการณ์ในภาษาง่ายๆ วินิจฉัยการเปลี่ยนแปลงของประสิทธิภาพ และรับข้อมูลเชิงลึกแบบตารางและแบบบรรยายที่มีโครงสร้าง
มิติข้อมูลและเมตริกที่รองรับ
ดูรายการมิติข้อมูลและเมตริกทั้งหมดที่ Data API รองรับได้ในเอกสารประกอบเรื่องสคีมา API