Metrics

เอกสารนี้ระบุเมตริกที่ API การรายงานของ YouTube ดึงข้อมูล API นี้จะเรียกรายงานข้อมูลจํานวนมากที่มีข้อมูล YouTube Analytics สําหรับช่องหรือเจ้าของเนื้อหา

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

เมตริกหลัก

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

รายการด้านล่างเป็นเมตริกหลักของ API เมตริกเหล่านี้ซึ่งใช้ใน YouTube Analytics API เป็นเมตริกหลักใน API ดังกล่าวด้วย

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

ดูเมตริก

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

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

watch_time_minutes (เมตริกหลัก)
จํานวนนาทีที่ผู้ใช้ดูวิดีโอสําหรับช่อง เจ้าของเนื้อหา วิดีโอ หรือเพลย์ลิสต์ที่ระบุ This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
จํานวนนาทีที่สมาชิก YouTube Premium (ก่อนหน้านี้เรียกว่า YouTube Red) ดูวิดีโอ
Average_view_duration_seconds (เมตริกหลัก)
ความยาวโดยเฉลี่ยเป็นวินาทีของการเล่นวิดีโอ ตั้งแต่วันที่ 13 ธันวาคม 2021 เป็นต้นไป เมตริกนี้จะยกเว้นการเข้าชมคลิปวนซ้ํา ในรายงานเพลย์ลิสต์ เมตริกจะแสดงความยาวโดยเฉลี่ยในการเล่นวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์ This is a core metric and is subject to the Deprecation Policy.
ระยะเวลาการดูเฉลี่ย [age_view_duration_percentage]
เปอร์เซ็นต์โดยเฉลี่ยของวิดีโอที่ดูระหว่างการเล่นวิดีโอ ตั้งแต่วันที่ 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.
subscribe_ained (เมตริกหลัก)
จํานวนครั้งที่ผู้ใช้ติดตามช่อง This is a core metric and is subject to the Deprecation Policy.

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

ข้อมูลสําหรับเมตริกนี้จะได้รับการรายงานคล้ายกับเมตริก subscribers_gained รายงานกิจกรรมของผู้ใช้พื้นฐานจะมีแถวที่ไม่ได้ระบุค่ามิติข้อมูล video_id เพื่อระบุจํานวนผู้ใช้ที่เลิกติดตามแต่ไม่ได้เลิกติดตามในหน้าสําหรับดูวิดีโอ แถวนั้นระบุค่าของเมตริก subscribers_gained ด้วย แต่ไม่ได้ระบุค่าสําหรับเมตริกอื่นๆ
videos_added_to_playlists
จํานวนครั้งที่เพิ่มวิดีโอไปยังเพลย์ลิสต์ YouTube วิดีโออาจเพิ่มลงในเพลย์ลิสต์ของเจ้าของวิดีโอหรือเพลย์ลิสต์ของช่องอื่นๆ ได้

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

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

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

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

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

playlist_starts
จํานวนครั้งที่ผู้ชมเริ่มเล่นเพลย์ลิสต์ โปรดทราบว่าเมตริกนี้จะรวมเฉพาะการดูเพลย์ลิสต์ที่เกิดขึ้นในเว็บเท่านั้น
playlist_saves_added (รองรับใน YouTube Reporting API เท่านั้น)
จํานวนครั้งที่ผู้ใช้บันทึกเพลย์ลิสต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับเพลย์ลิสต์ที่บันทึกไว้ได้ที่ศูนย์ช่วยเหลือของ YouTube เมตริกนี้แสดงจํานวนสัมบูรณ์ ซึ่งหมายความว่าหากผู้ใช้บันทึกเพลย์ลิสต์ นําเพลย์ลิสต์ออกจากรายการเพลย์ลิสต์ที่บันทึกไว้ แล้วบันทึกอีกครั้ง ค่าเมตริกแสดงถึงการบันทึกเพลย์ลิสต์ 2 รายการที่เพิ่มเข้ามา
playlist_saves_remove (รองรับใน YouTube Reporting API เท่านั้น)
จํานวนครั้งที่ผู้ใช้นําเพลย์ลิสต์ออกจากรายการเพลย์ลิสต์ที่บันทึกไว้ เมตริกนี้แสดงจํานวนสัมบูรณ์ ซึ่งหมายความว่าหากผู้ใช้บันทึกเพลย์ลิสต์ นําเพลย์ลิสต์ออกจากรายการเพลย์ลิสต์ที่บันทึกไว้ บันทึกอีกครั้ง และนําเพลย์ลิสต์ออกอีกครั้ง ค่าเมตริกแสดงถึงการบันทึกเพลย์ลิสต์ 2 รายการถูกนําออก

เมตริกคําอธิบายประกอบ

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

เมตริกการ์ด

ศูนย์ช่วยเหลือของ YouTube มีวิธีการโดยละเอียดสําหรับการเพิ่มการ์ดลงในวิดีโอและรายงานการ์ด YouTube Analytics

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

เมตริก End Screen

End Screen คือองค์ประกอบที่แสดงในช่วง 5-20 วินาทีสุดท้ายของวิดีโอเพื่อโปรโมตเนื้อหา ช่อง และเว็บไซต์ ศูนย์ช่วยเหลือของ YouTube มีวิธีการโดยละเอียดสําหรับการเพิ่ม End Screen ในวิดีโอ และรายงาน End Screen ของ YouTube Analytics

หมายเหตุ: ข้อมูลเมตริก End Screen พร้อมใช้งานแล้วตั้งแต่วันที่ 1 พฤษภาคม 2016

end_screen_Element_impressions
จํานวนองค์ประกอบ End Screen ที่แสดง ระบบจะบันทึกการแสดงผล 1 ครั้งสําหรับองค์ประกอบ End Screen แต่ละรายการที่แสดง
จุดสิ้นสุดองค์ประกอบหน้าจอ
จํานวนครั้งที่มีการคลิกองค์ประกอบ End Screen
สิ้นสุดอัตราการแสดงผลบนหน้าจอ
อัตราการคลิกผ่านสําหรับองค์ประกอบ End Screen ซึ่งคํานวณเป็นอัตราส่วนของการคลิกองค์ประกอบ End Screen ต่อการแสดงผลขององค์ประกอบ End Screen

เมตริกการคงผู้ชมไว้

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

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

ตัวอย่างต่อไปนี้จะแสดงวิธีคํานวณค่า
  • วิดีโอความยาว 1 นาทีมียอดดู 100 ครั้ง ผู้ชมครึ่งหนึ่งจะหยุดดูวิดีโอหลังจากผ่านไป 15 วินาที และผู้ชมที่เหลือดูวิดีโอจนจบ ไม่มีผู้ชมดูส่วนใดของวิดีโอมากกว่า 1 ครั้ง ในกรณีนี้ ค่าของเมตริกนี้คือ 1 สําหรับที่เก็บข้อมูลเวลาในไตรมาสแรกของวิดีโอ และค่าจะเป็น 0.50 สําหรับส่วนที่เหลือของวิดีโอ
  • วิดีโอความยาว 1 นาทีมียอดดู 100 ครั้ง ผู้ชมทุกคนดูวิดีโอจนจบ แต่ผู้ชม 20 คนดูไปจนจบวิดีโอ 45 วินาที จากนั้นข้ามไปดูวิดีโอ 30 วินาที จากนั้นจึงดูวิดีโอที่เหลือ ในกรณีนี้ ค่าของเมตริกจะเป็น 1 สําหรับที่เก็บข้อมูลเวลาในช่วงครึ่งแรกหรือไตรมาสที่แล้วของวิดีโอ อย่างไรก็ตาม ค่าที่ได้จะเป็น 1.2 สําหรับที่เก็บข้อมูลด้านเวลาในไตรมาสที่ 3 ของวิดีโอ เนื่องจากผู้ชม 100 เปอร์เซ็นต์ดูช่วงดังกล่าวของวิดีโอ แต่ผู้ชม 20% รับชมเนื้อหา 2 ครั้ง

เมตริกรายได้โดยประมาณ

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

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

เมตริกรายได้โดยประมาณจะขึ้นอยู่กับการปรับค่าใช้จ่ายในช่วงสิ้นเดือนและไม่รวมการโฆษณาที่พาร์ทเนอร์เป็นผู้ขายและแสดงโดยพาร์ทเนอร์
estimated_partner_ad_auction_revenue (รองรับใน YouTube Reporting API เท่านั้น)
รายได้โดยประมาณทั้งหมด (รายได้สุทธิ) จากการโฆษณาที่ขายผ่านการประมูลผ่าน AdSense สําหรับช่วงวันที่และภูมิภาคที่เลือก ก่อนหน้านี้เมตริกนี้มีชื่อว่า estimated_partner_ad_sense_revenue
estimated_partner_ad_sense_revenue (รองรับใน YouTube Reporting API เท่านั้น)
รายได้โดยประมาณทั้งหมด (รายได้สุทธิ) จากการโฆษณา AdSense ที่ขายผ่านการประมูลในช่วงวันที่และภูมิภาคที่เลือก
estimated_partner_ad_reserving_revenue (รองรับใน YouTube Reporting API เท่านั้น)
รายได้โดยประมาณทั้งหมด (รายได้สุทธิ) จากการขายโฆษณาที่จองไว้ผ่าน DoubleClick (DCLK) และแหล่งที่มาอื่นๆ ที่ขาย YouTube ก่อนหน้านี้เมตริกนี้มีชื่อว่า estimated_partner_double_click_revenue
estimated_partner_double_click_revenue (รองรับใน YouTube Reporting API เท่านั้น)
รายได้โดยประมาณทั้งหมด (รายได้สุทธิ) จากการโฆษณาที่จองไว้ผ่าน DoubleClick (DCLK) และแหล่งที่มาอื่นๆ ที่ขาย YouTube
estimated_partner_red_revenue (รองรับใน YouTube Reporting API เท่านั้น)
รายได้โดยประมาณทั้งหมด (รายได้สุทธิ) จากการสมัครใช้บริการ YouTube Premium (เดิมเรียกว่า YouTube Red)
estimated_partner_transaction_revenue (รองรับใน YouTube Reporting API เท่านั้น)
รายได้โดยประมาณทั้งหมดจากธุรกรรม เช่น เนื้อหาแบบชําระเงินและการให้เงินสนับสนุนของแฟนๆ ลบด้วยการคืนเงินที่พาร์ทเนอร์เรียกเก็บ

เมตริกประสิทธิภาพของโฆษณา

รายได้โดยประมาณจากวิดีโอ YouTube
รายได้รวมโดยประมาณในสกุลเงินดอลลาร์สหรัฐจากการโฆษณาที่ Google เป็นผู้ขายหรือขายโดยพาร์ทเนอร์ DoubleClick สําหรับช่วงวันที่และภูมิภาคที่เลือก รายได้รวมอาจเปลี่ยนแปลงได้ตามการปรับค่าใช้จ่ายเมื่อสิ้นเดือนและจะไม่รวมโฆษณาที่พาร์ทเนอร์เป็นผู้ขาย รายได้รวมไม่ควรสับสนกับรายได้โดยประมาณหรือรายได้สุทธิ ซึ่งนําส่วนแบ่งการเป็นเจ้าของและข้อตกลงส่วนแบ่งรายได้มาพิจารณาด้วย
cpm โดยประมาณ
รายได้รวมโดยประมาณต่อการแสดงโฆษณา 1,000 ครั้ง
ad_impressions
จํานวนการแสดงโฆษณาที่ได้รับการยืนยันที่แสดง
รายได้โดยประมาณ_สร้างรายได้
จํานวนเวลาที่ผู้ชมเล่นวิดีโอและมีการแสดงโฆษณาอย่างน้อย 1 รายการ ระบบจะนับการเล่นที่สร้างรายได้หากผู้ชมเห็นโฆษณาตอนต้นแต่เลิกดูโฆษณาก่อนที่วิดีโอจะเริ่มเล่น ข้อผิดพลาดโดยประมาณสําหรับตัวเลขนี้คือ ±2.0%
vCPM_playback_based_cpm
รายได้รวมโดยประมาณต่อการเล่น 1,000 ครั้ง