เอกสารฉบับนี้แสดงภาพรวมระดับสูงของ Google Analytics Core Reporting API เวอร์ชัน 3.0 สำหรับข้อมูลอ้างอิงโดยละเอียดของ API โปรดดูคู่มืออ้างอิง
เกริ่นนำ
API การรายงานหลักของ Google Analytics ช่วยให้คุณเข้าถึงข้อมูลรายงานส่วนใหญ่ใน Google Analytics ได้ เมื่อใช้ API การรายงานหลัก คุณจะทำสิ่งต่อไปนี้ได้
- สร้างแดชบอร์ดที่กำหนดเองเพื่อแสดงข้อมูล Google Analytics
- ประหยัดเวลาด้วยการทำให้งานการรายงานที่ซับซ้อนกลายเป็นอัตโนมัติ
- ผสานรวมข้อมูล Google Analytics ของคุณกับแอปพลิเคชันทางธุรกิจอื่นๆ
การเลือกเวอร์ชัน
เมื่อเร็วๆ นี้ เราได้เปิดตัว API การรายงานหลักเวอร์ชันใหม่
- ต้องการสร้างแอปพลิเคชันใหม่ใช่ไหม – เราขอแนะนำให้ใช้เวอร์ชันล่าสุด 3.0
- หากต้องการใช้รุ่นเดิม 2.3 – อ่าน คำแนะนำในการย้ายข้อมูล เพื่อดูรายละเอียดเกี่ยวกับวิธีอัปเดตแอปเพื่อใช้เวอร์ชันใหม่
เริ่มกระบวนการ
ต้องการเริ่มตอนนี้เลยไหม อ่าน บทแนะนำเกี่ยวกับ Analytics API
แต่ละแอปพลิเคชันที่ใช้ API จะต้องผ่าน 2 ขั้นตอนเพื่อลงทะเบียน ให้สิทธิ์ผู้ใช้ และทำงานกับ API บทแนะนำนี้จะแนะนำไปทีละขั้นตอน และในตอนท้ายจะมีแอปพลิเคชันที่ใช้งานได้ซึ่งคุณปรับแต่งได้
ภาพรวมเชิงแนวคิด
Core Reporting API จะแสดงข้อมูลรายงานซึ่งประกอบด้วยสถิติที่ได้มาจากข้อมูลที่รวบรวมโดย โค้ดติดตามของ Google Analytics รายงานแต่ละฉบับจะได้รับการจัดระเบียบเป็นมิติข้อมูลและเมตริก คุณใช้ Core Reporting API เพื่อค้นหามิติข้อมูลและเมตริกเพื่อสร้างรายงานที่กําหนดเองได้
มีแนวคิดพื้นฐาน 3 อย่างเกี่ยวกับ Core Reporting API ดังนี้
- รายงานมีความเกี่ยวข้องกับผู้ใช้และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) อย่างไร
- โครงสร้างของรายงานและวิธีสร้างคำค้นหา
- การใช้งานการตอบกลับจาก API
รายงาน ผู้ใช้ และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
หากต้องการขอข้อมูลรายงานสำหรับผู้ใช้ แอปพลิเคชันของคุณต้องระบุผู้ใช้และระบุข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่จะเรียกข้อมูล ระบบจะระบุตัวผู้ใช้ด้วยการรับ ข้อมูลเข้าสู่ระบบสำหรับการให้สิทธิ์ และส่งต่อในคำขอ API แต่ละรายการ ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) เป็นส่วนหนึ่งของ ลำดับชั้นการกำหนดค่าของ Google Analytics และระบุโดยรหัสข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
การค้นหารหัสข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) มี 2 วิธี
- แอปพลิเคชันของคุณสามารถใช้ Management API เพื่อข้ามผ่าน ลำดับชั้นการกำหนดค่าการจัดการเพื่อรับรหัสข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
- ใน URL ของรายงานแต่ละฉบับใน Google Analytics
- ใน Google Analytics ให้คลิกผู้ดูแลระบบในแถบเมนู เลือกบัญชีและพร็อพเพอร์ตี้ที่เป็นเจ้าของข้อมูลพร็อพเพอร์ตี้ ในคอลัมน์ข้อมูลพร็อพเพอร์ตี้ ให้คลิกการตั้งค่าข้อมูลพร็อพเพอร์ตี้เพื่อดูรหัสข้อมูลพร็อพเพอร์ตี้
การค้นหามิติข้อมูลและเมตริก
คุณค้นหา API สำหรับข้อมูลรายงานของ Google Analytics ซึ่งประกอบด้วยมิติข้อมูลและเมตริก เมตริกคือการวัดกิจกรรมของผู้ใช้ในพร็อพเพอร์ตี้แต่ละแบบ เช่น เซสชันและการดูหน้าเว็บ เมตริกจะแสดงรายละเอียดมิติข้อมูลตามเกณฑ์ทั่วไปบางรายการ เช่น ประเทศหรือเบราว์เซอร์ เมื่อสร้างคำค้นหา คุณต้องระบุมิติข้อมูลและเมตริกที่ต้องการใช้ในข้อมูลรายงาน
ใช้ คู่มืออ้างอิงมิติข้อมูลและเมตริกแบบอินเทอร์แอกทีฟเพื่อดู มิติข้อมูลและเมตริกทั้งหมดที่เปิดเผยผ่าน API และอ่าน คู่มืออ้างอิงสำหรับ API การรายงานหลักเพื่อดูวิธีระบุมิติข้อมูลและเมตริกในการค้นหา API
การทำงานกับรายงาน
ข้อมูลที่แสดงผลจาก API อาจถือเป็นตารางที่มีส่วนหัวและรายการแถว การตอบกลับของ API แต่ละรายการประกอบด้วยส่วนหัวที่อธิบายชื่อและประเภทข้อมูลของแต่ละคอลัมน์ การตอบกลับจะมีรายการแถวด้วย โดยที่แต่ละแถวจะเป็นรายการของเซลล์ที่มีข้อมูลในลำดับเดียวกันกับส่วนหัว คุณใช้ข้อมูลในส่วนหัวเพื่อกำหนดประเภทข้อมูลในแต่ละเซลล์ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการตอบกลับของ API ได้ที่ คู่มืออ้างอิงสำหรับ API การรายงานหลัก
นโยบายโควต้าและการเลิกใช้งาน
Google Analytics API ช่วยจัดการกับการดำเนินการหลายล้านรายการ คุณจำเป็นต้องใช้ระบบโควต้า เพื่อป้องกันไม่ให้ระบบรับการดำเนินการมากเกินกว่าที่จัดการได้ และเพื่อให้การกระจายทรัพยากรของระบบได้อย่างเท่าเทียม อ่านคำแนะนำ ขีดจำกัดและโควต้าเพื่อดูขีดจำกัดที่เฉพาะเจาะจง
อ่านรายละเอียดเกี่ยวกับวิธีจัดการการเปลี่ยนแปลงคอลัมน์ Core Reporting API (เช่น มิติข้อมูลและเมตริก) ได้ที่ นโยบายการเลิกใช้งานข้อมูล ดูวิธีใช้ Metadata API เพื่อตรวจสอบคอลัมน์ที่เลิกใช้งานแล้วได้ที่ คู่มือการพัฒนา API ข้อมูลเมตา
ขั้นตอนถัดไป
เมื่อเข้าใจวิธีการทำงานของ API แล้ว เราจึงมีแหล่งข้อมูลมากมายที่จะช่วยคุณเริ่มต้น ดังนี้
- อ่าน คู่มือนักพัฒนาซอฟต์แวร์เพื่อดูวิธีทำงานกับ API
- ใช้เครื่องมือ Query Explorer แบบอินเทอร์แอกทีฟเพื่อสร้างข้อความค้นหาออกมาเป็นภาพและดูการตอบกลับผ่าน API
- อ่านบทความ คำค้นหาทั่วไป ซึ่งแสดงรายการคำค้นหาที่พบบ่อยที่สุดหลายรายการไปยัง Core Reporting API
- ตรวจสอบการอ้างอิง มิติข้อมูลและเมตริกสำหรับรายการข้อมูลทั้งหมดที่พร้อมใช้งานผ่าน API
- ไปที่หน้า ไลบรารีและตัวอย่างเพื่อดูรายการไลบรารีของไคลเอ็นต์ที่มีอยู่ทั้งหมดที่ใช้กับ API นี้ได้