ความคาดหวังเกี่ยวกับข้อมูลการรายงาน

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