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