Metrics

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

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

เมตริกหลัก

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

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

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

ดูเมตริก

engaged_views (เมตริกหลัก)
จำนวนครั้งที่วิดีโอของช่องได้รับการดูเลยเฟรมแรกไปแล้ว หรือผู้ใช้คลิก/แตะเพื่อเล่น
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.
shares (เมตริกหลัก)
จำนวนครั้งที่ผู้ใช้แชร์วิดีโอผ่านปุ่ม 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
จำนวนครั้งที่มีการแสดงทีเซอร์ของการ์ด ยอดดูวิดีโอ 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

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