Metrics

เอกสารนี้จะกำหนดเมตริกที่คุณเรียกข้อมูลได้โดยใช้ YouTube Analytics API API นี้รองรับการค้นหาแบบเรียลไทม์เพื่อสร้างรายงานข้อมูลวิเคราะห์ YouTube ที่กำหนดเอง

เมตริกคือการวัดกิจกรรมของผู้ใช้ ประสิทธิภาพโฆษณา หรือรายได้โดยประมาณแต่ละรายการ เมตริกกิจกรรมของผู้ใช้รวมถึงสิ่งต่างๆ เช่น ยอดดูวิดีโอและคะแนน (การกดชอบและไม่ชอบ)

เมตริกหลัก

แม้ว่า YouTube Analytics API จะเป็นไปตามนโยบายการเลิกใช้งานที่กำหนดไว้ในข้อกำหนดในการให้บริการ แต่เมตริกที่ไม่ใช่หลัก (และมิติข้อมูลที่ไม่ใช่หลัก) จะไม่อยู่ภายใต้นโยบายนี้ ในคำจำกัดความในหน้านี้ เมตริกใดก็ตามที่เป็นเมตริกหลักจะได้รับการระบุอย่างชัดเจนว่าเป็นเมตริกหลัก

รายการด้านล่างระบุเมตริกหลักของ API

ดูข้อมูลเพิ่มเติมได้ในรายการ YouTube API ที่อยู่ภายใต้นโยบายการเลิกใช้งาน

ดูเมตริก

engagedViews (เมตริกหลัก)
จำนวนครั้งที่มีการดูวิดีโอของช่องหลังจากเฟรมแรก หรือผู้ใช้คลิก/แตะเพื่อเล่น
ยอดดู (เมตริกหลัก)
เมตริกนี้แสดงตัวเลขที่แตกต่างกันในรายงานประเภทต่างๆ This is a core metric and is subject to the Deprecation Policy.
playlistViews
เมตริกนี้กำหนดไว้ในส่วนเมตริกเพลย์ลิสต์
redViews
จำนวนครั้งที่สมาชิก YouTube Premium (เดิมชื่อ YouTube Red) ดูวิดีโอ
viewerPercentage (เมตริกหลัก)
เปอร์เซ็นต์ของผู้ชมที่เข้าสู่ระบบขณะดูวิดีโอหรือเพลย์ลิสต์ This is a core metric and is subject to the Deprecation Policy.

เมตริกเวลาในการรับชม

estimatedMinutesWatched (เมตริกหลัก)
จำนวนนาทีที่ผู้ใช้ดูวิดีโอในช่อง เจ้าของเนื้อหา วิดีโอ หรือเพลย์ลิสต์ที่ระบุ This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
จำนวนนาทีที่สมาชิก YouTube Premium (เดิมเรียกว่า YouTube Red) ดูวิดีโอ
averageViewDuration (เมตริกหลัก)
ความยาวเฉลี่ยเป็นวินาทีของการเล่นวิดีโอ ตั้งแต่วันที่ 13 ธันวาคม 2021 เป็นต้นไป เมตริกนี้จะไม่รวมการเข้าชมคลิปแบบวนซ้ำ ในรายงานเพลย์ลิสต์ เมตริกจะระบุความยาวเฉลี่ยเป็นวินาทีของการเล่นวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์ This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
เปอร์เซ็นต์โดยเฉลี่ยของวิดีโอที่ผู้ชมดูในระหว่างการเล่นวิดีโอ ตั้งแต่วันที่ 13 ธันวาคม 2021 เป็นต้นไป เมตริกนี้จะไม่รวมการเข้าชมคลิปแบบวนซ้ำ

เมตริกการมีส่วนร่วม

ความคิดเห็น (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้แสดงความคิดเห็นในวิดีโอ ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube This is a core metric and is subject to the Deprecation Policy.
การกดชอบ (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้ระบุว่าชอบวิดีโอโดยให้คะแนนเชิงบวก This is a core metric and is subject to the Deprecation Policy.
ไม่ชอบ (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้ระบุว่าไม่ชอบวิดีโอโดยให้คะแนนเชิงลบ This is a core metric and is subject to the Deprecation Policy.
การแชร์ (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้แชร์วิดีโอผ่านปุ่ม Share ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube This is a core metric and is subject to the Deprecation Policy.
subscribersGained (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้ติดตามช่อง This is a core metric and is subject to the Deprecation Policy.

ช่องอาจได้หรือเสียผู้ติดตามในหลายที่ เช่น หน้าสำหรับดูวิดีโอ หน้าช่อง และคู่มือที่ปรากฏในหน้าแรกของ YouTube ในรายงานช่อง เมตริกนี้จะรวมผู้ติดตามที่ได้รับจากที่ใดก็ตามต่อไปนี้ อย่างไรก็ตาม ในรายงานที่ใช้ทั้งvideoมิติข้อมูลหรือพารามิเตอร์ filter เพื่อจำกัดการตอบกลับให้รวมเฉพาะข้อมูลของวิดีโอหนึ่งๆ เมตริก subscribersGained จะรวมเฉพาะสถิติจากหน้าดูวิดีโอของวิดีโอที่ระบุ
subscribersLost (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้ยกเลิกการติดตามช่อง This is a core metric and is subject to the Deprecation Policy.

ระบบจะรายงานข้อมูลสำหรับเมตริกนี้ในลักษณะเดียวกับเมตริก subscribersGained ในรายงานช่อง เมตริกนี้จะรวมผู้ติดตามที่เลิกติดตามผ่านกลไกใดก็ตามที่ผู้ใช้สามารถเลิกติดตามช่องได้ อย่างไรก็ตาม ในรายงานที่ใช้ทั้งมิติข้อมูล video หรือพารามิเตอร์ filter เพื่อจำกัดการตอบกลับให้รวมเฉพาะข้อมูลของวิดีโอที่เฉพาะเจาะจง เมตริกนี้จะรวมเฉพาะผู้ใช้ที่ยกเลิกการติดตามจากหน้าดูวิดีโอของวิดีโอที่ระบุ
videosAddedToPlaylists
จำนวนครั้งที่มีการเพิ่มวิดีโอลงในเพลย์ลิสต์ YouTube วิดีโออาจได้รับการเพิ่มลงในเพลย์ลิสต์ของเจ้าของวิดีโอหรือเพลย์ลิสต์ของช่องอื่นๆ

ค่าเมตริกจะรวมจำนวนครั้งที่มีการเพิ่มวิดีโอลงในเพลย์ลิสต์เริ่มต้น เช่น เพลย์ลิสต์ "ดูภายหลัง" อย่างไรก็ตาม ระบบจะไม่นับเพลย์ลิสต์ที่ระบบเพิ่มวิดีโอลงในเพลย์ลิสต์โดยอัตโนมัติ เช่น เพลย์ลิสต์การอัปโหลดของช่องหรือประวัติการดูของผู้ใช้

เมตริกนี้จะแสดงตัวเลขที่แน่นอน ซึ่งหมายความว่าหากผู้ใช้เพิ่มวิดีโอลงในเพลย์ลิสต์ นำวิดีโอออก แล้วเพิ่มอีกครั้ง ค่าเมตริกจะแสดงว่ามีการเพิ่มวิดีโอลงในเพลย์ลิสต์ 2 ครั้ง ข้อมูลสำหรับเมตริกนี้ไม่พร้อมใช้งานสำหรับวันที่ก่อนวันที่ 1 ตุลาคม 2014
videosRemovedFromPlaylists
จำนวนครั้งที่ระบบนำวิดีโอออกจากเพลย์ลิสต์ YouTube วิดีโออาจถูกนำออกจากเพลย์ลิสต์ของเจ้าของวิดีโอหรือเพลย์ลิสต์ของช่องอื่นๆ

ค่าเมตริกจะรวมจำนวนครั้งที่มีการนำวิดีโอออกจากเพลย์ลิสต์เริ่มต้น เช่น เพลย์ลิสต์ "ดูภายหลัง"

เมตริกนี้จะแสดงตัวเลขที่แน่นอน ซึ่งหมายความว่าหากผู้ใช้เพิ่มวิดีโอลงในเพลย์ลิสต์ นำวิดีโอออก เพิ่มอีกครั้ง แล้วนำออกอีกครั้ง ค่าเมตริกจะแสดงว่ามีการนำวิดีโอออกจากเพลย์ลิสต์ 2 ครั้ง ข้อมูลสำหรับเมตริกนี้ไม่พร้อมใช้งานสำหรับวันที่ก่อนวันที่ 1 ตุลาคม 2014

เมตริกของเพลย์ลิสต์

รายงานเพลย์ลิสต์มีเมตริก 2 ประเภทที่อธิบายวิธีที่ผู้ชมโต้ตอบกับวิดีโอ ในเพลย์ลิสต์

  • เมตริกวิดีโอแบบรวมจะแสดงเมตริกกิจกรรมของผู้ใช้และการแสดงผลที่ รวบรวมไว้สำหรับวิดีโอทั้งหมดในเพลย์ลิสต์ซึ่งเป็นของช่องที่เป็นเจ้าของ เพลย์ลิสต์ด้วย ระบบจะไม่คำนวณเมตริกสำหรับวิดีโอของช่องอื่นในการรวบรวม ด้วยเหตุนี้ หากช่องสร้างเพลย์ลิสต์ที่มีเฉพาะวิดีโอของช่องอื่น รายงานสำหรับเพลย์ลิสต์เหล่านั้นจะไม่แสดงค่าสำหรับเมตริกเหล่านี้

    โปรดดูคำจำกัดความของเมตริกวิดีโอรวมที่รองรับในส่วนเมตริกการดูและ เมตริกเวลาในการรับชมของเอกสารนี้

  • เมตริกในเพลย์ลิสต์แสดงกิจกรรมและการมีส่วนร่วมของผู้ใช้ในบริบทของหน้าเพลย์ลิสต์ เมตริกเหล่านี้รวมยอดดูของวิดีโอทั้งหมดในเพลย์ลิสต์ ไม่ว่าช่องใดจะเป็นเจ้าของ แต่จะนับเฉพาะยอดดูที่เกิดขึ้นในบริบทของเพลย์ลิสต์

เมตริกส่วนใหญ่ต่อไปนี้เป็นเมตริกในเพลย์ลิสต์ ส่วนเมตริกที่เหลือในรายการ เช่น เมตริก playlistSaves จะเกี่ยวกับการโต้ตอบของผู้ใช้กับเพลย์ลิสต์เอง ไม่ใช่กับวิดีโอในเพลย์ลิสต์ ดังนั้น เมตริกเหล่านั้นจึงไม่ถือเป็น เมตริกวิดีโอแบบรวมหรือเมตริกในเพลย์ลิสต์

averageTimeInPlaylist
ระยะเวลาโดยเฉลี่ยโดยประมาณเป็นนาทีที่ผู้ชมดูวิดีโอในเพลย์ลิสต์ หลังจากเริ่มเพลย์ลิสต์ โปรดทราบว่าเมตริกนี้รวมเฉพาะการดูเพลย์ลิสต์ที่ เกิดขึ้นบนเว็บ
playlistAverageViewDuration
ระยะเวลาโดยเฉลี่ยโดยประมาณเป็นวินาทีที่ดูต่อการดูเพลย์ลิสต์ 1 ครั้ง โปรดทราบว่าเมตริกนี้ แสดงความยาวเฉลี่ยของการดูวิดีโอแต่ละรายการภายในเพลย์ลิสต์ ส่วนaverageTimeInPlaylistเมตริก จะแสดงเวลาเฉลี่ยที่ผู้ชมแต่ละคนใช้ในการดูเพลย์ลิสต์ทั้งเพลย์ลิสต์ เมตริกนี้รวมข้อมูลสำหรับวิดีโอในเพลย์ลิสต์ ซึ่งช่องอื่นเป็นเจ้าของ
playlistEstimatedMinutesWatched
จํานวนนาทีที่ผู้ใช้ดูเนื้อหาในเพลย์ลิสต์เป็นส่วนหนึ่งของเพลย์ลิสต์ เวลาในการรับชม ที่เกิดขึ้นในบริบทอื่นๆ เช่น เวลาในการรับชมจากยอดดูที่เกิดขึ้นเมื่อ ผู้ชมดูวิดีโอเดียวกันในเพลย์ลิสต์อื่นๆ จะไม่ถูกนับ เมตริกนี้ รวมข้อมูลสำหรับวิดีโอในเพลย์ลิสต์ที่ช่องอื่นเป็นเจ้าของ
playlistSaves
จำนวนครั้งสุทธิที่ผู้ใช้บันทึกเพลย์ลิสต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับเพลย์ลิสต์ที่บันทึกไว้ได้ที่ ศูนย์ช่วยเหลือของ YouTube เมตริกนี้จะแสดงจำนวนการเปลี่ยนแปลงสุทธิ ซึ่งหมายความว่าหากผู้ใช้บันทึกเพลย์ลิสต์ นำเพลย์ลิสต์ออกจากรายการเพลย์ลิสต์ที่บันทึกไว้ แล้วบันทึกเพลย์ลิสต์อีกครั้ง ค่าเมตริกจะแสดงการเพิ่มเพลย์ลิสต์ที่บันทึกไว้ 1 รายการ
playlistStarts
จำนวนครั้งที่ผู้ชมเริ่มเล่นเพลย์ลิสต์ โปรดทราบว่าเมตริกนี้ รวมเฉพาะการดูเพลย์ลิสต์ที่เกิดขึ้นบนเว็บเท่านั้น
playlistViews
จำนวนครั้งที่มีการดูวิดีโอในเพลย์ลิสต์ในบริบทของเพลย์ลิสต์นั้น เมตริกนี้รวมข้อมูลสำหรับวิดีโอในเพลย์ลิสต์ที่ช่องอื่นเป็นเจ้าของ
viewsPerPlaylistStart
จำนวนยอดดูวิดีโอโดยเฉลี่ยที่เกิดขึ้นทุกครั้งที่มีการเริ่มเพลย์ลิสต์ โปรดทราบว่า เมตริกนี้รวมเฉพาะการดูเพลย์ลิสต์ที่เกิดขึ้นบนเว็บเท่านั้น

เมตริกของคำอธิบายประกอบ

หมายเหตุ: รายงาน YouTube Analytics API จะแสดงข้อมูลสำหรับเมตริก annotationClickThroughRate และ annotationCloseRate เท่านั้น ณ วันที่ 10 มิถุนายน 2012 นอกจากนี้ รายงาน YouTube Analytics API จะแสดงข้อมูลสำหรับเมตริกคำอธิบายประกอบที่เหลือเท่านั้น ณ วันที่ 16 กรกฎาคม 2013

annotationImpressions
จำนวนการแสดงผลคำอธิบายประกอบทั้งหมด
annotationClickableImpressions
จำนวนคำอธิบายประกอบที่ปรากฏและคลิกได้
annotationClicks
จำนวนคำอธิบายประกอบที่คลิก
annotationClickThroughRate (เมตริกหลัก)
อัตราส่วนของคำอธิบายประกอบที่ผู้ชมคลิกต่อจำนวนการแสดงผลคำอธิบายประกอบที่คลิกได้ทั้งหมด This is a core metric and is subject to the Deprecation Policy. ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับการสร้างคำอธิบายประกอบและการใช้คำอธิบายประกอบลิงก์