คู่มือนี้อธิบายข้อมูลสำคัญเกี่ยวกับข้อมูลที่คุณเห็นในรายงานที่สร้างขึ้นโดยใช้ Google Analytics Data API ผู้ใช้มักพบความคลาดเคลื่อนระหว่างข้อมูลที่ API แสดงผล (โดยเฉพาะเมธอด runReport) กับข้อมูลที่แสดงใน UI ของ Google Analytics
การสุ่มตัวอย่างและการรวมข้อมูล
เมธอด runReport ของ Google Analytics Data API สามารถแสดงข้อมูลจากการสุ่มตัวอย่าง โดยเฉพาะสําหรับชุดข้อมูลขนาดใหญ่หรือการค้นหาที่ซับซ้อน แม้ว่า UI ของ Google Analytics จะใช้การสุ่มตัวอย่างด้วย แต่เกณฑ์และอัลกอริทึมที่เฉพาะเจาะจงอาจแตกต่างกัน ซึ่งทําให้ค่าที่รายงานแตกต่างกันเล็กน้อย
หากต้องการทราบว่าผลลัพธ์ของรายงานอิงตามชุดย่อยของข้อมูลที่มีอยู่หรือไม่ ให้ตรวจสอบช่อง samplingMetadatas ของออบเจ็กต์ ResponseMetaData หากผลลัพธ์ของรายงานได้รับการสุ่มตัวอย่าง ช่องนี้จะอธิบายเปอร์เซ็นต์ของเหตุการณ์ที่ใช้ในรายงานนี้
วิธีการรายงานบางอย่างของ Google Analytics Data API ช่วยให้คุณระบุระดับการสุ่มตัวอย่างที่ต้องการได้ คุณสามารถใช้ช่อง samplingLevel ของเมธอด properties.reportTasks.create เพื่อควบคุมระดับการสุ่มตัวอย่างของรายงานได้
ฟีเจอร์นี้ช่วยให้พร็อพเพอร์ตี้ Google Analytics 360 มีสิทธิ์เข้าถึงขีดจำกัดการเก็บตัวอย่างที่สูงขึ้นเป็น 1 พันล้านเหตุการณ์ นอกจากนี้ คุณยังตั้งค่าขีดจำกัดการสุ่มตัวอย่างเป็น UNSAMPLED เพื่อใช้ผลลัพธ์ที่ไม่ได้สุ่มตัวอย่างสำหรับจำนวนเหตุการณ์ขนาดใหญ่ได้ด้วย
ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับการสุ่มตัวอย่างข้อมูล
การประมาณจํานวนที่ไม่ซ้ำกัน
Google Analytics Data API ใช้อัลกอริทึม HyperLogLog++ (HLL++) เพื่อประมาณจํานวนที่ไม่ซ้ำกันสําหรับเมตริก เช่น ผู้ใช้ที่ใช้งานอยู่และเซสชัน แนวทางนี้ใช้ใน API และ UI ของ Google Analytics เพื่อปรับปรุงประสิทธิภาพและจัดการชุดข้อมูลขนาดใหญ่อย่างมีประสิทธิภาพ ซึ่งหมายความว่าผลลัพธ์จะเป็นค่าประมาณมากกว่าจำนวนที่แน่นอน
ดูบริบทเพิ่มเติมได้จากแหล่งข้อมูลต่อไปนี้ การประมาณจํานวนที่ไม่ซ้ำกันใน Google Analytics และ ความแตกต่างของจํานวนผู้ใช้
การกำหนดจำนวนข้อมูลขั้นต่ำที่ต้องการ
Google Analytics อาจใช้จำนวนข้อมูลขั้นต่ำที่ต้องการกับรายงานเพื่อป้องกันไม่ให้มีการระบุตัวตนของผู้ใช้แต่ละรายโดยอิงตามข้อมูลประชากร ความสนใจ หรือสัญญาณอื่นๆ ที่แสดงในข้อมูล
หากแถวรายงานมีผู้ใช้จำนวนน้อย ระบบอาจยกเว้นแถวนั้นออกจากผลลัพธ์ ซึ่งมักพบในรายงานที่มีมิติข้อมูล High Cardinality หรือมิติข้อมูลที่กำหนดเอง
หากต้องการทราบว่ารายงานนี้อยู่ภายใต้การกำหนดเกณฑ์หรือไม่ ให้ตรวจสอบช่อง subjectToThresholding ของออบเจ็กต์ ResponseMetaData
ดูข้อมูลเพิ่มเติมได้ที่จำนวนข้อมูลขั้นต่ำที่ต้องการ
แถว (other)
หากมิติข้อมูลมีคาร์ดินัลลิตี้สูง Google Analytics อาจจัดกลุ่มค่าที่พบน้อยกว่าไว้ในแถวที่มีป้ายกำกับเป็น (other) ซึ่งมักเกิดขึ้นในรายงานที่มีมิติข้อมูลซึ่งมีค่าที่ไม่ซ้ำกันมากกว่า 500 ค่าต่อวัน
เมื่อใช้ตัวกรองกับ Data API โปรดทราบว่าตัวกรองจะไม่ดูภายในแถว (other) และจะใช้หลังจากที่รวบรวมข้อมูลและสร้างแถว (other) แล้ว
หากต้องการทราบว่ารายงานมีข้อมูลที่รวมอยู่ในแถว (other) หรือไม่ ให้ตรวจสอบช่อง dataLossFromOtherRow ของออบเจ็กต์ ResponseMetaData
ดูข้อมูลเพิ่มเติมได้ที่แถว (อื่นๆ) ใน Google Analytics
ข้อมูลระบุตัวตนในการรายงาน
ข้อมูลระบุตัวตนในการรายงานจะกำหนดวิธีกรองผู้ใช้ที่ซ้ำกันออกในรายงาน การตั้งค่าข้อมูลระบุตัวตนที่แตกต่างกัน (เช่น "แบบผสม" หรือ "ตามอุปกรณ์") อาจส่งผลให้จํานวนผู้ใช้ในช่วงวันที่เดียวกันแตกต่างกัน
ทั้ง UI ของ Google Analytics และ Data API ใช้การตั้งค่าข้อมูลระบุตัวตนในการรายงานเดียวกันสําหรับพร็อพเพอร์ตี้ หากมีการเปลี่ยนแปลงการตั้งค่านี้ จะส่งผลต่อรายงานทั้งใน UI และ API หากมีการเปลี่ยนแปลงการตั้งค่าระหว่างการเรียกใช้รายงานใน UI และการรับข้อมูลการรายงานผ่าน API จำนวนผู้ใช้อาจแตกต่างกันระหว่างรายงานทั้ง 2 ฉบับสำหรับช่วงวันที่เดียวกัน
ความเฉพาะเจาะจงของคำค้นหา
เพื่อลดความคลาดเคลื่อน ให้ตรวจสอบว่าพารามิเตอร์ต่อไปนี้ในคําขอ API ตรงกับการตั้งค่าในรายงาน UI ของ Google Analytics ทุกประการ
- ช่วงวันที่: ตรวจสอบว่าวันที่เริ่มต้นและวันที่สิ้นสุดเหมือนกัน
- มิติข้อมูลและเมตริก: ตรวจสอบว่ามิติข้อมูลและเมตริกในคำขอ API เหมือนกับมิติข้อมูลและเมตริกในรายงาน UI ของ Google Analytics
- ตัวกรอง: ตรวจสอบว่าตัวกรองมิติข้อมูลหรือเมตริกที่ใช้ในคำขอ API ตรงกับตัวกรองที่ใช้ใน UI
การเพิ่มมิติข้อมูลลงในรายงานอาจส่งผลให้มีการใช้เหตุการณ์ในการคํานวณน้อยลง เฉพาะเหตุการณ์ที่มีข้อมูลสําหรับมิติข้อมูลที่ขอเท่านั้นที่จะรวมอยู่ในรายงาน ด้วยเหตุนี้ การเพิ่มมิติข้อมูลลงในการค้นหาจึงอาจเปลี่ยนแปลงค่ารวมของเมตริกในรายงานได้
ความใหม่ของข้อมูล
Google Analytics ต้องใช้เวลาในการประมวลผลและรวบรวมข้อมูลเหตุการณ์ เมื่อทำงานกับข้อมูลล่าสุด คุณอาจเห็นความแตกต่างเล็กน้อยระหว่างรายงานหากมีความล่าช้าระหว่างการดึงข้อมูล ตัวอย่างเช่น หากคุณดูรายงานใน UI แล้วค้นหา API สำหรับรายงานเดียวกันในอีกไม่กี่นาทีต่อมา ข้อมูลอาจมีการเปลี่ยนแปลงเนื่องจากการประมวลผลและการรวมข้อมูลที่ดำเนินอยู่
ดูข้อมูลเพิ่มเติมได้ที่ความใหม่ของข้อมูล
ทางเลือกสำหรับข้อมูลที่ไม่ได้สุ่มตัวอย่าง
หากกรณีการใช้งานของคุณต้องใช้ข้อมูลระดับเหตุการณ์แบบเต็มและไม่มีการสุ่มตัวอย่าง ให้พิจารณาใช้ทางเลือกต่อไปนี้
BigQuery Export: BigQuery Export สำหรับ Google Analytics
เป็นวิธีที่แนะนําสําหรับการวิเคราะห์ขั้นสูงของข้อมูลเหตุการณ์ดิบ
Analytics 360: พร็อพเพอร์ตี้ที่มีใบอนุญาต Analytics 360 จะมีขีดจำกัดการสุ่มตัวอย่างที่สูงขึ้นและเข้าถึงฟีเจอร์การรายงานแบบละเอียดได้มากขึ้น