Metrics

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

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

เมตริกหลัก

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

รายการด้านล่างจะระบุเมตริกหลักของ API เมตริกเหล่านี้ที่ใช้ใน YouTube Analytics API ด้วยจะเป็นเมตริกหลักใน 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.

เมตริกการเข้าถึง

video_thumbnail_impressions
จำนวนครั้งที่ภาพปกวิดีโอแสดงต่อผู้ชม ระบบจะนับการแสดงผลเมื่อภาพปกปรากฏเป็นเวลานานกว่า 1 วินาทีและผู้ชมมองเห็นภาพปกบนหน้าจอได้อย่างน้อย 50% ของสัดส่วนภาพ ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube
video_thumbnail_impressions_ctr
เปอร์เซ็นต์ของการแสดงผลที่ทำให้เกิดการคลิกเพื่อดูวิดีโอ ซึ่งคำนวณโดยการนำจำนวนคลิกไปหารด้วยจำนวนการแสดงผล

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

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 เป็นต้นไป เมตริกนี้จะไม่รวมการเข้าชมจากคลิปที่เล่นวนซ้ำ

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

comments (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้แสดงความคิดเห็นในวิดีโอ ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube This is a core metric and is subject to the Deprecation Policy.
likes (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้ระบุว่าชอบวิดีโอโดยให้คะแนนเชิงบวก This is a core metric and is subject to the Deprecation Policy.
dislikes (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้ระบุว่าไม่ชอบวิดีโอโดยให้คะแนนเชิงลบ 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 (รองรับเฉพาะใน YouTube Reporting API)
จำนวนครั้งที่ผู้ใช้บันทึกเพลย์ลิสต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับเพลย์ลิสต์ที่บันทึกไว้ได้ที่ศูนย์ช่วยเหลือของ YouTube เมตริกนี้จะแสดงผลเป็นตัวเลขสัมบูรณ์ ซึ่งหมายความว่าหากผู้ใช้บันทึกเพลย์ลิสต์ นำเพลย์ลิสต์ออกจากรายการเพลย์ลิสต์ที่บันทึกไว้ แล้วบันทึกอีกครั้ง ค่าเมตริกจะแสดงการบันทึกเพลย์ลิสต์ที่เพิ่ม 2 ครั้ง
playlist_saves_removed (รองรับเฉพาะใน YouTube Reporting API)
จำนวนครั้งที่ผู้ใช้นำเพลย์ลิสต์ออกจากรายการเพลย์ลิสต์ที่บันทึกไว้ เมตริกนี้จะแสดงผลเป็นจำนวนสัมบูรณ์ ซึ่งหมายความว่าหากผู้ใช้บันทึกเพลย์ลิสต์ นำเพลย์ลิสต์ออกจากรายการเพลย์ลิสต์ที่บันทึกไว้ บันทึกอีกครั้ง และนำออกอีกครั้ง ค่าเมตริกจะแสดงผลว่ามีการนำการบันทึกเพลย์ลิสต์ออก 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
จำนวนครั้งที่มีการแสดงทีเซอร์ของการ์ด การดูวิดีโอ 1 ครั้งสามารถสร้างการแสดงผลทีเซอร์ได้หลายครั้ง
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

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

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

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

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