Metrics

เอกสารนี้จะกำหนดเมตริกที่ YouTube Reporting API ดึงข้อมูล API นี้จะดึงรายงานข้อมูลจำนวนมากที่มีข้อมูลจากข้อมูลวิเคราะห์ YouTube ของช่องหรือเจ้าของเนื้อหา

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

เมตริกหลัก

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

รายการด้านล่างระบุเมตริกหลักของ API เมตริกเหล่านี้ที่ใช้ใน API ของข้อมูลวิเคราะห์ YouTube จะเป็นเมตริกหลักใน API นั้นด้วย

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

ดูเมตริก

engaged_views (เมตริกหลัก)
จำนวนครั้งที่มีการดูวิดีโอของช่องหลังจากผ่านช่วงวินาทีแรกไป
ยอดดู (เมตริกหลัก)
จำนวนครั้งที่มีการดูวิดีโอ ในรายงานเพลย์ลิสต์ เมตริกจะระบุ จำนวนครั้งที่มีการดูวิดีโอในบริบทของเพลย์ลิสต์ ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับวิธีรายงานยอดดู This is a core metric and is subject to the Deprecation Policy.
red_views
จำนวนครั้งที่สมาชิก 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.
average_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.
subscribers_gained (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้ติดตามช่อง This is a core metric and is subject to the Deprecation Policy.

ช่องอาจได้หรือเสียผู้ติดตามในหลายที่ เช่น หน้าสำหรับดูวิดีโอ หน้าช่อง และคู่มือที่ปรากฏในหน้าแรกของ YouTube หากต้องการระบุจำนวนผู้ติดตามใหม่ของช่องที่ไม่ได้ติดตามผ่านหน้าสำหรับดูวิดีโอ รายงานกิจกรรมของผู้ใช้ขั้นพื้นฐานจะมีแถวที่ไม่ได้ระบุค่ามิติข้อมูล video_id แถวนั้นยังระบุค่าสำหรับเมตริก subscribersLost ด้วย แต่ไม่ได้ระบุค่าสำหรับเมตริกอื่นๆ
subscribers_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_removed_from_playlists
จำนวนครั้งที่ระบบนำวิดีโอออกจากเพลย์ลิสต์ YouTube วิดีโออาจถูกนำออกจากเพลย์ลิสต์ของเจ้าของวิดีโอหรือเพลย์ลิสต์ของช่องอื่นๆ

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

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

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

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

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

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

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

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

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

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

annotation_impressions
จำนวนการแสดงผลของคำอธิบายประกอบทั้งหมด
annotation_clickable_impressions
จำนวนคำอธิบายประกอบที่ปรากฏและคลิกได้
annotation_clicks
จำนวนคำอธิบายประกอบที่คลิก
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

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

เมตริก End Screen

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

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

เมตริกการยกเลิกการเป็นสมาชิก

membershipsCancellationSurveyResponses
จำนวนแบบสำรวจที่ผู้ใช้ YouTube ซึ่งยกเลิกการเป็นสมาชิกของช่อง ที่ระบุในช่วงระยะเวลาการรายงานทำเสร็จ

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

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

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

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

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

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