เอกสารนี้ระบุเมตริกที่ API การรายงานของ YouTube ดึงข้อมูล API นี้จะเรียกรายงานข้อมูลจํานวนมากที่มีข้อมูล YouTube Analytics สําหรับช่องหรือเจ้าของเนื้อหา
เมตริกคือการวัดผลกิจกรรมของผู้ใช้ ประสิทธิภาพโฆษณา หรือรายได้โดยประมาณแยกกัน เมตริกกิจกรรมของผู้ใช้ ได้แก่ จํานวนการดูและการให้คะแนนวิดีโอ (การกดชอบและไม่ชอบ)
เมตริกหลัก
แม้ว่า YouTube Reporting API จะขึ้นอยู่กับนโยบายการเลิกใช้งานที่ระบุไว้ในข้อกําหนดในการให้บริการ แต่เมตริกที่ไม่ใช่บริการหลัก (และมิติข้อมูลที่ไม่ใช่บริการหลัก) จะไม่อยู่ภายใต้นโยบาย ในคําจํากัดความในหน้านี้ เมตริกใดๆ ที่เป็นเมตริกหลักจะได้รับการระบุอย่างชัดเจน
รายการด้านล่างเป็นเมตริกหลักของ API เมตริกเหล่านี้ซึ่งใช้ใน YouTube Analytics API เป็นเมตริกหลักใน API ดังกล่าวด้วย
annotation_click_through_rate
annotation_close_rate
average_view_duration_seconds
comments
dislikes
estimated_partner_revenue
likes
shares
subscribers_gained
subscribers_lost
views_percentage
views
watch_time_minutes
โปรดดูข้อมูลเพิ่มเติมในรายการ 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 ครั้ง
- วิดีโอความยาว 1 นาทีมียอดดู 100 ครั้ง ผู้ชมครึ่งหนึ่งจะหยุดดูวิดีโอหลังจากผ่านไป 15 วินาที และผู้ชมที่เหลือดูวิดีโอจนจบ ไม่มีผู้ชมดูส่วนใดของวิดีโอมากกว่า 1 ครั้ง ในกรณีนี้ ค่าของเมตริกนี้คือ
เมตริกรายได้โดยประมาณ
หมายเหตุ: เมตริกรายได้โดยประมาณจะขึ้นอยู่กับการปรับค่าใช้จ่ายตอนสิ้นเดือนและไม่รวมการโฆษณาที่พาร์ทเนอร์เป็นผู้ขายและแสดงโดยพาร์ทเนอร์ โปรดดูข้อมูลเพิ่มเติมที่ศูนย์ช่วยเหลือของ YouTube และหมายเหตุเกี่ยวกับตัวเลขรายได้โดยประมาณ
- 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 ครั้ง