API การรายงานหลักคืออะไร - ภาพรวม

เอกสารฉบับนี้แสดงภาพรวมระดับสูงของ 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 ดังนี้

  1. รายงานมีความเกี่ยวข้องกับผู้ใช้และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) อย่างไร
  2. โครงสร้างของรายงานและวิธีสร้างคำค้นหา
  3. การใช้งานการตอบกลับจาก 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 แล้ว เราจึงมีแหล่งข้อมูลมากมายที่จะช่วยคุณเริ่มต้น ดังนี้

กลับไปด้านบน