YouTube Analytics API: Content Owner Reports

หมายเหตุ: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

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

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

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

  • รายงานประสิทธิภาพของโฆษณามีเมตริกที่เกี่ยวข้องกับรายได้และประสิทธิภาพของโฆษณา เมตริกเหล่านี้ใช้มิติข้อมูล adType เพื่อจัดกลุ่มเมตริกตามประเภทโฆษณาที่แสดงระหว่างการเล่นวิดีโอ ส่วนรายงานประสิทธิภาพโฆษณาจะอธิบายเมตริกประสิทธิภาพโฆษณา 2 ประเภทที่ API รองรับ

เรียกข้อมูลรายงาน

หากต้องการเรียกข้อมูลรายงานของเจ้าของเนื้อหา ให้เรียกใช้เมธอด reports.query ของ API และตั้งค่าพารามิเตอร์ ids ในคำขอ API เป็น contentOwner==OWNER_NAME โดยที่ OWNER_NAME จะระบุรหัสของเจ้าของเนื้อหา โปรดสอบถามผู้จัดการพาร์ทเนอร์หากไม่แน่ใจเกี่ยวกับมูลค่า

การให้สิทธิ์

คำขอ API ของข้อมูลวิเคราะห์ YouTube ทั้งหมดต้องได้รับอนุญาต คำแนะนำเกี่ยวกับการให้สิทธิ์อธิบายวิธีใช้โปรโตคอล OAuth 2.0 เพื่อดึงข้อมูลโทเค็นการให้สิทธิ์

คำขอ YouTube Analytics API ใช้ขอบเขตการให้สิทธิ์ต่อไปนี้

ขอบเขต
https://www.googleapis.com/auth/yt-analytics.readonly ดูรายงาน YouTube Analytics สำหรับเนื้อหา YouTube ของคุณ ขอบเขตนี้ให้สิทธิ์เข้าถึงเมตริกกิจกรรมของผู้ใช้ เช่น จํานวนยอดดูและจํานวนการให้คะแนน
https://www.googleapis.com/auth/yt-analytics-monetary.readonly ดูรายงานด้านการเงินของ YouTube Analytics สำหรับเนื้อหา YouTube ของคุณ ขอบเขตนี้ให้สิทธิ์เข้าถึงเมตริกกิจกรรมของผู้ใช้ รวมถึงเมตริกรายได้และประสิทธิภาพโฆษณาโดยประมาณ
https://www.googleapis.com/auth/youtube จัดการบัญชี YouTube ใน YouTube Analytics API เจ้าของช่องจะใช้ขอบเขตนี้เพื่อจัดการกลุ่มและรายการกลุ่มของ YouTube Analytics
https://www.googleapis.com/auth/youtubepartner ดูและจัดการเนื้อหา YouTube และเนื้อหาที่เกี่ยวข้องบน YouTube ใน YouTube Analytics API เจ้าของเนื้อหาจะใช้ขอบเขตนี้เพื่อจัดการกลุ่มและรายการกลุ่มของ YouTube Analytics

หมายเหตุ: เมตริกที่มีเครื่องหมายดอกจัน (*) ต้องใช้โทเค็นการให้สิทธิ์ที่ให้สิทธิ์เข้าถึงขอบเขต https://www.googleapis.com/auth/yt-analytics-monetary.readonly

ตัวกรอง

คำขอ API ทั้งหมดในการเรียกข้อมูลรายงานเจ้าของเนื้อหาต้องกรองข้อมูลโดยใช้มิติข้อมูล video, มิติข้อมูล channel, มิติข้อมูล isCurated หรือชุดค่าผสมที่รองรับของมิติข้อมูล claimedStatus และ uploaderType (ชุดค่าผสมที่รองรับจะแสดงอยู่ในคําจํากัดความของมิติข้อมูล uploaderType)

ตารางที่อธิบายรายงานที่รองรับจะระบุตัวกรองที่ใช้กับรายงานหนึ่งๆ ได้ ในคําอธิบาย คุณจะใช้ตัวกรองที่แสดงในวงเล็บหรือไม่ก็ได้ เช่น หากรายงานแสดง video(,country) เป็นตัวเลือกการกรอง รายงานอาจกรองให้รวมเฉพาะข้อมูลของวิดีโอหนึ่งๆ หรือรวมเฉพาะข้อมูลของวิดีโอหนึ่งๆ ในประเทศหนึ่งๆ

นอกจากนี้ API ยังรองรับการกำหนดค่าหลายค่าสำหรับตัวกรอง video, playlist และ channel ด้วย หากระบุค่าหลายค่าสำหรับตัวกรองใดตัวกรองหนึ่ง คุณยังเพิ่มตัวกรองนั้นลงในรายการมิติข้อมูลที่ระบุสำหรับคำขอได้ด้วย ซึ่งต้องดำเนินการเช่นนี้แม้ในกรณีที่ตัวกรองไม่ได้แสดงเป็นมิติข้อมูลที่รองรับสําหรับรายงานหนึ่งๆ ก็ตาม

ดูคำจำกัดความของพารามิเตอร์ filters เพื่อดูคำอธิบายที่สมบูรณ์เกี่ยวกับวิธีกรองผลลัพธ์ API สำหรับค่าหรือชุดค่าที่เฉพาะเจาะจง

ทำความเข้าใจตารางรายงาน

ส่วนนี้อธิบายการจัดรูปแบบและคำศัพท์ที่ใช้ในตารางที่กําหนดรายงานที่ API รองรับ ตารางต่อไปนี้แสดงมิติข้อมูล เมตริก และตัวกรองที่รองรับสําหรับรายงานวิดีโอรายละเอียดการเล่นโดยใช้มิติข้อมูลเวลาและเมตริก averageViewPercentage

เนื้อหา
มิติข้อมูล:
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus, youtubeProduct
ใช้ 0 หรือ 1 day, month
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 video, group
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

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

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

อย่างไรก็ตาม ค่าพารามิเตอร์ day,month ไม่ถูกต้องเนื่องจากใช้มิติข้อมูลตามเวลา 2 รายการ และคำขอต้องใช้ 0 หรือ 1

คําศัพท์เกี่ยวกับตารางรายงาน

ตารางใช้คำศัพท์ต่อไปนี้เพื่อระบุว่าจำเป็นต้องใช้มิติข้อมูลหรือไม่

  • คำเหล่านี้หมายความว่าต้องมีค่า
    • ต้องระบุ: คุณต้องระบุค่า
    • ใช้ 1 รายการเท่านั้น: คุณต้องใส่ค่า 1 รายการจากกลุ่ม
    • ใช้อย่างน้อย 1 รายการ: คุณรวมค่าใดก็ได้จากกลุ่ม หรือจะรวมทุกค่าก็ได้ แต่ต้องรวมอย่างน้อย 1 ค่า
  • คำเหล่านี้หมายความว่าค่านั้นไม่บังคับ
    • ไม่บังคับ: คุณเลือกที่จะใส่ค่านี้ได้
    • ใช้ 0 หรือ 1: คุณสามารถเลือกรวมค่า 1 ค่าจากกลุ่ม
    • ใช้ 0 ขึ้นไป: คุณสามารถเลือกรวมค่าใดก็ได้หรือทั้งหมดจากกลุ่ม
สำคัญ: คำขอ API ทั้งหมดเพื่อดึงข้อมูลรายงานวิดีโอของเจ้าของเนื้อหาต้องกรองข้อมูลโดยใช้มิติข้อมูลวิดีโอ มิติข้อมูลช่อง มิติข้อมูลกลุ่ม หรือชุดค่าผสมที่รองรับของมิติข้อมูล claimedStatus และ uploaderType (บางรายงานไม่รองรับตัวเลือกเหล่านั้นทั้งหมด) ชุดค่าผสมที่รองรับ ซึ่งแสดงอยู่ในคําจํากัดความของมิติข้อมูล uploaderType ด้วย ได้แก่
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

รายงานวิดีโอ

สถิติพื้นฐาน

สถิติพื้นฐาน (รวมถึงจำนวนผู้ติดตาม)

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

เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, ความคิดเห็น, การกดชอบ, การกดไม่ชอบ, videosAddedToPlaylists, videosRemovedFromPlaylists, การแชร์, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, continent, subContinent

สถิติพื้นฐานสำหรับรัฐในสหรัฐอเมริกา

รายงานนี้แสดงสถิติสำหรับรัฐหนึ่งๆ ในสหรัฐอเมริกาหรือเขตโคลัมเบีย โปรดทราบว่ารายงานนี้รองรับเฉพาะเมตริกชุดย่อยที่มีอยู่ในรายงานเฉพาะประเทศที่อธิบายไว้ข้างต้น

เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ province

ตามเวลา

กิจกรรมตามระยะเวลา

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

เนื้อหา
มิติข้อมูล:
ใช้ 1 รายการเท่านั้น day, month
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, ความคิดเห็น, การกดชอบ, การกดไม่ชอบ, videosAddedToPlaylists, videosRemovedFromPlaylists, การแชร์, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, ผู้ชมที่ไม่ซ้ำ, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, continent, subContinent

กิจกรรมของผู้ใช้ในแต่ละรัฐของสหรัฐอเมริกาในระยะเวลาที่เจาะจง

รายงานนี้แสดงสถิติสำหรับรัฐหนึ่งๆ ในสหรัฐอเมริกาหรือเขตโคลัมเบีย โปรดทราบว่ารายงานนี้รองรับเฉพาะเมตริกชุดย่อยที่มีอยู่ในรายงานเฉพาะประเทศที่อธิบายไว้ข้างต้น

เนื้อหา
มิติข้อมูล:
ใช้ 1 รายการเท่านั้น day, month
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ province

ภูมิศาสตร์ของผู้ใช้

กิจกรรมของผู้ใช้ตามประเทศ

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ country
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, ความคิดเห็น, การกดชอบ, การกดไม่ชอบ, videosAddedToPlaylists, videosRemovedFromPlaylists, การแชร์, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 continent, subContinent

กิจกรรมของผู้ใช้ตามจังหวัด

รายงานนี้จะแสดงสถิติกิจกรรมของผู้ใช้สำหรับรัฐในสหรัฐอเมริกาและเขตโคลัมเบีย สําหรับรายงานนี้ คุณต้องตั้งค่าพารามิเตอร์ filters เป็น country==US

เนื้อหา
มิติข้อมูล:
ต้องระบุ province
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ country==US

กิจกรรมของผู้ใช้ตามเมือง (<= 250 ผลการค้นหา)

หมายเหตุ: รายงานนี้กำหนดให้คุณตั้งค่าพารามิเตอร์ maxResults เป็นค่าจำนวนเต็มไม่เกิน 250 รายงานนี้แตกต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณต้องระบุค่าสําหรับพารามิเตอร์คําขอ sort ด้วย

รายงานนี้จะแสดงสถิติกิจกรรมของผู้ใช้ตามเมือง

เนื้อหา
มิติข้อมูล:
ต้องระบุ city
ใช้ 0 ขึ้นไป creatorContentType, country, province, subscribedStatus

หมายเหตุ: หากรวมมิติข้อมูลจังหวัด คุณต้องใส่ตัวกรอง country==US ด้วย
ใช้ 0 หรือ 1 day, month
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ตัวเลือกการจัดเรียง -views
-estimatedMinutesWatched

รายละเอียดการเล่น

รายงานรายละเอียดการเล่นจะแสดงสถิติที่เกี่ยวข้องกับแอตทริบิวต์การดูต่อไปนี้

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

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

หมายเหตุ: มิติข้อมูลและตัวกรอง liveOrOnDemand ใช้ร่วมกับเมตริก averageViewPercentage ไม่ได้ ดังนั้น ส่วนย่อยแต่ละส่วนต่อไปนี้จึงแสดงรายงาน 2 รายการ รายงานหนึ่งรองรับมิติข้อมูล (และตัวกรอง) liveOrOnDemand ส่วนอีกรายงานรองรับเมตริก averageViewPercentage

กิจกรรมของผู้ใช้ตามสถานะการติดตาม

รายงานนี้จะแสดงเมตริกกิจกรรมของผู้ใช้สำหรับผู้ชมที่ติดตามและผู้ชมที่ไม่ได้ติดตาม สถิติสามารถจัดกลุ่มตามระยะเวลา (วันหรือเดือน) และกรองรายงานตามประเทศ ทวีป หรือsubContinentได้ด้วย

เนื้อหา
มิติข้อมูล:
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus
ใช้ 0 หรือ 1 day, month
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, ยอดชอบ, ยอดไม่ชอบ, videosAddedToPlaylists, videosRemovedFromPlaylists, การแชร์, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, continent, subContinent
ไม่บังคับ subscribedStatus

กิจกรรมของผู้ใช้ตามสถานะการติดตามสำหรับจังหวัด

รายงานนี้จะแสดงเมตริกกิจกรรมของผู้ใช้สำหรับผู้ชมที่สมัครและไม่ได้สมัครใช้บริการในรัฐต่างๆ ของสหรัฐอเมริกาหรือเขตปกครองพิเศษโคลัมเบีย รายงานนี้รองรับเมตริกน้อยกว่ารายงานก่อนหน้า

เนื้อหา
มิติข้อมูล:
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus
ใช้ 0 หรือ 1 day, month
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ province
ไม่บังคับ subscribedStatus

รายละเอียดการเล่นพร้อมมิติข้อมูลเวลา (ไม่บังคับ)

คุณไม่จำเป็นต้องระบุมิติข้อมูลเวลา (วันหรือเดือน) ในรายงานเหล่านี้ เนื่องจากคุณต้องใช้พารามิเตอร์คําขอ startDate และ endDate เพื่อระบุช่วงวันที่ที่รายงานจะครอบคลุม มิติข้อมูล (หากมี) บ่งบอกว่าคุณต้องการให้รวบรวมข้อมูลในรายงานตามวัน เดือน ฯลฯ

รายละเอียดการเล่นพร้อมมิติข้อมูลเวลาและสถิติ liveOrOnDemand (ไม่บังคับ)

รายงานนี้จะแสดงสถิติการเล่นแบบละเอียดสำหรับช่วงเวลาที่เจาะจง โดยรองรับมิติข้อมูล (และตัวกรอง) liveOrOnDemand

เนื้อหา
มิติข้อมูล:
ใช้ 0 ขึ้นไป creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
ใช้ 0 หรือ 1 day, month
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus, youtubeProduct
รายละเอียดการเล่นพร้อมมิติข้อมูลเวลา (ไม่บังคับ) และเมตริก averageViewPercentage

รายงานนี้จะแสดงสถิติการเล่นแบบละเอียดสำหรับช่วงเวลาที่เจาะจง

เนื้อหา
มิติข้อมูล:
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus, youtubeProduct
ใช้ 0 หรือ 1 day, month
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

รายละเอียดการเล่นตามประเทศ

รายละเอียดการเล่นตามประเทศพร้อมสถิติ liveOrOnDemand

รายงานนี้จะแสดงสถิติการเล่นแบบละเอียดในแต่ละประเทศ โดยรองรับมิติข้อมูล (และตัวกรอง) liveOrOnDemand

เนื้อหา
มิติข้อมูล:
ไม่บังคับ country
ใช้ 0 ขึ้นไป creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus, youtubeProduct
รายละเอียดการเล่นตามประเทศที่มีเมตริก averageViewPercentage

รายงานต่อไปนี้คล้ายกับรายงานก่อนหน้า โดยจะเพิ่มการรองรับเมตริก averageViewPercentage แต่จะไม่รองรับ liveOrOnDemand เป็นมิติข้อมูลหรือตัวกรอง

เนื้อหา
มิติข้อมูล:
ไม่บังคับ country
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 continent, subContinent
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

รายละเอียดการเล่นตามจังหวัด

รายละเอียดการเล่นตามจังหวัดที่มีสถิติ liveOrOnDemand

รายงานนี้จะแสดงสถิติการเล่นแบบละเอียดสำหรับรัฐในสหรัฐอเมริกาและเขตปกครองพิเศษโคลัมเบีย โดยรองรับมิติข้อมูล (และตัวกรอง) liveOrOnDemand

เนื้อหา
มิติข้อมูล:
ไม่บังคับ province
ใช้ 0 ขึ้นไป creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ country==US
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus, youtubeProduct
รายละเอียดการเล่นตามจังหวัดที่มีเมตริก averageViewPercentage

รายงานต่อไปนี้คล้ายกับรายงานก่อนหน้า โดยจะเพิ่มการรองรับเมตริก averageViewPercentage แต่จะไม่รองรับ liveOrOnDemand เป็นมิติข้อมูลหรือตัวกรอง

เนื้อหา
มิติข้อมูล:
ไม่บังคับ province
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ country==US
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

ตำแหน่งที่เล่น

รายงานตำแหน่งการเล่นวิดีโอ

รายงานนี้จะแสดงสถิติที่เกี่ยวข้องกับประเภทหน้าเว็บหรือแอปพลิเคชันที่มีการเล่นวิดีโอ

เนื้อหา
มิติข้อมูล:
ต้องระบุ insightPlaybackLocationType
ใช้ 0 ขึ้นไป creatorContentType, day, liveOrOnDemand, subscribedStatus
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus

รายละเอียดตำแหน่งที่เล่น (<= 25 รายการ)

หมายเหตุ: รายงานนี้กำหนดให้คุณตั้งค่าพารามิเตอร์ maxResults เป็นค่าจำนวนเต็มไม่เกิน 25 รายงานนี้แตกต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณต้องระบุค่าสําหรับพารามิเตอร์คําขอ sort ด้วย

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ insightPlaybackLocationDetail
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ insightPlaybackLocationType==EMBEDDED
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus
ตัวเลือกการจัดเรียง -views
-estimatedMinutesWatched

แหล่งที่มาของการเข้าชม

แหล่งที่มาของการเข้าชม

รายงานนี้จะรวบรวมสถิติการดูตามวิธีที่ผู้ชมเข้าถึงเนื้อหาวิดีโอ เช่น ระบุจํานวนการดูที่มาจาก Google Search หรือจากลิงก์ไปยังวิดีโอที่เกี่ยวข้อง

หมายเหตุ: รายงานนี้จะแสดงข้อผิดพลาดหากผลคูณของจำนวนวิดีโอที่ค้นหา x จำนวนวันในช่วงวันที่เกิน 50,000 เช่น การค้นหาที่ดึงข้อมูลสำหรับรหัสวิดีโอ 500 รายการจะขอข้อมูลได้สูงสุด 100 วัน หากต้องการลดจำนวนแถวที่คำขอแสดงผล ให้แบ่งคำค้นหาออกเป็นหลายรายการที่ระบุวิดีโอน้อยลงหรือตั้งค่าช่วงวันที่ให้สั้นลง

เนื้อหา
มิติข้อมูล:
ต้องระบุ insightTrafficSourceType
ใช้ 0 ขึ้นไป creatorContentType, day, liveOrOnDemand, subscribedStatus
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus

รายละเอียดแหล่งที่มาของการเข้าชม (<= 25 รายการ)

หมายเหตุ: รายงานนี้กำหนดให้คุณตั้งค่าพารามิเตอร์ maxResults เป็นค่าจำนวนเต็มไม่เกิน 25 รายงานนี้แตกต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณต้องระบุค่าสําหรับพารามิเตอร์คําขอ sort ด้วย

รายงานนี้จะรวบรวมสถิติการดูตาม URL ที่มาซึ่งสร้างยอดดูมากที่สุดสำหรับเนื้อหาของเจ้าของเนื้อหา ระบบจะจัดหมวดหมู่ผู้อ้างอิงตามประเภทแหล่งที่มาของการเข้าชม และคําจํากัดความของมิติข้อมูล insightTrafficSourceDetail จะระบุแหล่งที่มาของการเข้าชมที่มีรายงาน เช่น หากคุณตั้งค่าตัวกรอง insightTrafficSourceType เป็น ADVERTISING รายงานจะแสดงประเภทโฆษณาที่สร้างยอดดูหรือเวลาในการรับชมมากที่สุดสำหรับเนื้อหาของเจ้าของเนื้อหา

เนื้อหา
มิติข้อมูล:
ต้องระบุ insightTrafficSourceDetail
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ insightTrafficSourceType (ดูหมายเหตุด้านล่างตาราง)
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus
ตัวเลือกการจัดเรียง -views
-estimatedMinutesWatched

หมายเหตุ: รายงานนี้รองรับแหล่งที่มาของการเข้าชมบางแหล่งเท่านั้น VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES และ NO_LINK_EMBEDDED คือแหล่งที่มาของการเข้าชมที่ไม่รองรับ

ประเภทอุปกรณ์และระบบปฏิบัติการ

ประเภทอุปกรณ์

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ deviceType
ใช้ 0 ขึ้นไป creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

ระบบปฏิบัติการ

รายงานนี้จะรวบรวมสถิติการดูตามระบบปฏิบัติการของผู้ชม เช่น ระบุจํานวนยอดดูที่เกิดขึ้นในอุปกรณ์ Android หรือใน PlayStation

เนื้อหา
มิติข้อมูล:
ต้องระบุ operatingSystem
ใช้ 0 ขึ้นไป creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

ระบบปฏิบัติการและประเภทอุปกรณ์

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ operatingSystem,deviceType
ใช้ 0 ขึ้นไป creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus, youtubeProduct

ข้อมูลประชากรผู้ชม

รายงานนี้จะรวบรวมสถิติการดูตามกลุ่มอายุและเพศของผู้ชม

เนื้อหา
มิติข้อมูล:
ใช้อย่างน้อย 1 รายการ ageGroup, gender
ใช้ 0 ขึ้นไป creatorContentType, liveOrOnDemand, subscribedStatus
เมตริก:
ใช้อย่างน้อย 1 รายการ viewerPercentage
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus
หมายเหตุ: ค่า viewerPercentage ในรายงานนี้จะไม่ได้รับการแปลงค่าสำหรับค่าต่างๆ ของมิติข้อมูลรายละเอียดการเล่น subscribedStatus

ตัวอย่างเช่น หากรายงานใช้มิติข้อมูล subscribedStatus ระบบจะแสดงข้อมูล viewerPercentage ที่รวมกันเท่ากับ 100 เปอร์เซ็นต์สำหรับยอดดูที่ติดตาม และข้อมูล viewerPercentage ที่รวมกันเท่ากับ 100 เปอร์เซ็นต์สำหรับยอดดูที่ไม่ได้ติดตาม (ค่าทั้งหมดของช่อง viewerPercentage ทั้งหมดในรายงานคือ 200 เปอร์เซ็นต์)

คุณใช้ตัวกรองเพื่อให้รายงานมีเฉพาะข้อมูล viewerPercentage สำหรับค่าเดียวของมิติข้อมูล subscribedStatus ได้

การมีส่วนร่วมและการแชร์เนื้อหา

รายงานนี้จะแสดงสถิติที่แสดงให้เห็นความถี่ที่มีการแชร์วิดีโอของช่องในแพลตฟอร์มโซเชียลต่างๆ

เนื้อหา
มิติข้อมูล:
ต้องระบุ sharingService
ไม่บังคับ creatorContentType, subscribedStatus
เมตริก:
ใช้อย่างน้อย 1 รายการ shares
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, channel, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, continent, subContinent
ไม่บังคับ subscribedStatus

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

รายงานนี้จะวัดความสามารถของวิดีโอในการคงผู้ชมไว้ มิติข้อมูล elapsedVideoTimeRatio จะวัดระยะเวลาของวิดีโอที่ผ่านไปสำหรับค่าเมตริกที่เกี่ยวข้อง เมตริก audienceWatchRatio และ relativeRetentionPerformance เป็นการวัดผล 2 อย่างที่แสดงให้เห็นว่าวิดีโอคงผู้ชมไว้ได้ดีเพียงใด ค่าแรกคือค่าสัมบูรณ์ ส่วนค่าที่ 2 แสดงประสิทธิภาพของวิดีโอเมื่อเทียบกับวิดีโอ YouTube อื่นๆ ที่มีความยาวใกล้เคียงกัน

หมายเหตุ: รายงานการคงผู้ชมไว้ไม่รองรับการกำหนดรายการค่าที่คั่นด้วยคอมมาสำหรับตัวกรอง video โดยค่าต้องระบุรหัสวิดีโอรายการเดียว

เนื้อหา
มิติข้อมูล:
ต้องระบุ elapsedVideoTimeRatio
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ audienceWatchRatio, relativeRetentionPerformance
ตัวกรอง:
ต้องระบุ video
ใช้ 0 ขึ้นไป audienceType, subscribedStatus, youtubeProduct

วิดีโอยอดนิยม

หมายเหตุ: รายงานเหล่านี้กำหนดให้คุณตั้งค่าพารามิเตอร์ maxResults เป็นค่าจำนวนเต็มไม่เกิน 200 ข้อมูลก่อนวันที่ 1 มกราคม 2013 มีเฉพาะสำหรับวิดีโอยอดนิยม 10 อันดับแรกเท่านั้น รายงานเหล่านี้ยังกำหนดให้คุณระบุค่าสำหรับพารามิเตอร์คำขอ sort ด้วย ซึ่งแตกต่างจากรายงานอื่นๆ ส่วนใหญ่

วิดีโอยอดนิยมโดยรวม ตามประเทศ ตามทวีป หรือตามอนุทวีป (<= 200 รายการ)

รายงานนี้จะแสดงวิดีโอยอดนิยมของเจ้าของเนื้อหาตามเกณฑ์การกรองและการจัดเรียงที่ระบุ

เนื้อหา
มิติข้อมูล:
ต้องระบุ video
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, ความคิดเห็น, การกดชอบ, การกดไม่ชอบ, videosAddedToPlaylists, videosRemovedFromPlaylists, การแชร์, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
ตัวกรอง:
ใช้ 1 รายการเท่านั้น channel หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, continent, subContinent
ตัวเลือกการจัดเรียง -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

วิดีโอยอดนิยมโดยรวมตามรัฐในสหรัฐอเมริกา (<= 200 รายการ)

รายงานนี้จะแสดงวิดีโอยอดนิยมของเจ้าของเนื้อหาในรัฐหรือเขตปกครองของสหรัฐอเมริกา โปรดทราบว่ารายงานนี้รองรับเฉพาะเมตริกชุดย่อยที่มีอยู่ในรายงานเฉพาะประเทศที่อธิบายไว้ข้างต้น

เนื้อหา
มิติข้อมูล:
ต้องระบุ video
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
ตัวกรอง:
ใช้ 1 รายการเท่านั้น channel หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ต้องระบุ province
ตัวเลือกการจัดเรียง -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

วิดีโอยอดนิยมสำหรับผู้ชมที่ติดตามหรือไม่ติดตาม(<= 200 รายการ)

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ video
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, ยอดชอบ, ยอดไม่ชอบ, videosAddedToPlaylists, videosRemovedFromPlaylists, การแชร์, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
ตัวกรอง:
ใช้ 1 รายการเท่านั้น channel หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ไม่บังคับ subscribedStatus
ใช้ 0 หรือ 1 country, continent, subContinent
ตัวเลือกการจัดเรียง -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

วิดีโอยอดนิยมตามผลิตภัณฑ์ของ YouTube (<= 200 รายการ)

รายงานนี้จะแสดงวิดีโอยอดนิยม รวมถึงรองรับรายละเอียดการเล่นและตัวกรองตามภูมิศาสตร์ รายงานนี้คล้ายกับรายงานก่อนหน้า แต่รองรับเมตริกน้อยกว่าและรองรับตัวกรอง youtubeProduct

เนื้อหา
มิติข้อมูล:
ต้องระบุ video
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:
ใช้ 1 รายการเท่านั้น channel หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct
ตัวเลือกการจัดเรียง -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

วิดีโอยอดนิยมที่มีตัวกรองรายละเอียดการเล่น (<= 200 รายการ)

รายงานนี้จะแสดงวิดีโอยอดนิยมของเจ้าของเนื้อหา โดยกรองตามมิติข้อมูลรายละเอียดการเล่นอย่างน้อย 1 รายการ ได้แก่ liveOrOnDemand, subscribedStatus และ youtubeProduct รายงานยังรองรับการกรองตามภูมิภาคด้วย

เนื้อหา
มิติข้อมูล:
ต้องระบุ video
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
ตัวกรอง:
ใช้ 1 รายการเท่านั้น channel หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป liveOrOnDemand, subscribedStatus, youtubeProduct
ตัวเลือกการจัดเรียง -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

รายงานเพลย์ลิสต์

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

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

หมายเหตุคําเตือนต่อไปนี้จะอธิบายการเปลี่ยนแปลงระหว่างรายงาน 2 เวอร์ชันโดยละเอียด

เมตริกวิดีโอแบบรวม

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

ดูรายการเมตริกวิดีโอแบบรวมที่ YouTube รองรับได้ที่ส่วนเมตริกเพลย์ลิสต์ที่รองรับ

เมตริกในเพลย์ลิสต์

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

เมตริกเพลย์ลิสต์ที่รองรับ

สถิติพื้นฐาน

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

แนะนำ
เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 channel, playlist, group
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

ตามเวลา

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

แนะนำ
เนื้อหา
มิติข้อมูล:
ใช้ 1 รายการเท่านั้น day, month
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ใช้ 1 รายการเท่านั้น day, month
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 channel, playlist, group
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

ภูมิศาสตร์ของผู้ใช้

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

รายงานนี้จะแสดงสถิติของเพลย์ลิสต์ตามประเทศ

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ country
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ใช้ 0 หรือ 1 continent, subContinent
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ country
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 continent, subContinent
ใช้ 0 หรือ 1 playlist, channel, group
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

กิจกรรมในเพลย์ลิสต์ตามจังหวัด

รายงานนี้จะแสดงสถิติกิจกรรมของเพลย์ลิสต์สำหรับรัฐในสหรัฐอเมริกาและเขตปกครองพิเศษโคลัมเบีย สําหรับรายงานนี้ คุณต้องใส่ country==US ในค่าพารามิเตอร์ filters

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ province
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration
ตัวกรอง:
ต้องระบุ country==US
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ province
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1;country==US
ใช้ 0 หรือ 1 channel, playlist, group
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

ตำแหน่งที่เล่น

รายงานนี้แสดงสถิติที่เกี่ยวข้องกับประเภทหน้าเว็บหรือแอปพลิเคชันที่มีการเปิดเพลย์ลิสต์

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ insightPlaybackLocationType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ insightPlaybackLocationType
ใช้ 0 ขึ้นไป day, subscribedStatus
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 playlist, channel, group
ไม่บังคับ subscribedStatus

รายละเอียดตำแหน่งที่เล่น (<= 25 รายการ)

หมายเหตุ: รายงานนี้กำหนดให้คุณตั้งค่าพารามิเตอร์ maxResults เป็นค่าจำนวนเต็มไม่เกิน 25 รายงานนี้แตกต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณต้องระบุค่าสําหรับพารามิเตอร์คําขอ sort ด้วย

รายงานนี้จะระบุวิดีโอเพลเยอร์แบบฝังที่สร้างยอดดูหรือเวลาในการรับชมมากที่สุดสำหรับเพลย์ลิสต์ของเจ้าของเนื้อหา

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ insightPlaybackLocationDetail
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ต้องระบุ insightPlaybackLocationType==EMBEDDED
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
ตัวเลือกการจัดเรียง -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ insightPlaybackLocationDetail
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1;insightPlaybackLocationType==EMBEDDED
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 playlist, channel, group
ไม่บังคับ subscribedStatus
ตัวเลือกการจัดเรียง -views
-estimatedMinutesWatched
-playlistStarts

แหล่งที่มาของการเข้าชม

รายงานนี้จะรวบรวมสถิติการดูตามวิธีที่ผู้ชมเข้าถึงเนื้อหาเพลย์ลิสต์ เช่น ระบุจำนวนยอดดูที่มาจาก Google Search หรือหน้าช่อง

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ insightTrafficSourceType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ insightTrafficSourceType
ใช้ 0 ขึ้นไป day, subscribedStatus
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 playlist, channel, group
ไม่บังคับ subscribedStatus

รายละเอียดแหล่งที่มาของการเข้าชม (<= 25 รายการ)

หมายเหตุ: รายงานนี้กำหนดให้คุณตั้งค่าพารามิเตอร์ maxResults เป็นค่าจำนวนเต็มไม่เกิน 25 รายงานนี้แตกต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณต้องระบุค่าสําหรับพารามิเตอร์คําขอ sort ด้วย

รายงานนี้จะรวบรวมสถิติการดูตาม URL ที่มาซึ่งสร้างยอดดูมากที่สุดสำหรับเพลย์ลิสต์ของเจ้าของเนื้อหา ระบบจะจัดหมวดหมู่ผู้อ้างอิงตามประเภทแหล่งที่มาของการเข้าชม และคําจํากัดความของมิติข้อมูล insightTrafficSourceDetail จะระบุแหล่งที่มาของการเข้าชมที่มีรายงาน เช่น หากคุณตั้งค่าตัวกรอง insightTrafficSourceType เป็น ADVERTISING รายงานจะแสดงประเภทโฆษณาที่สร้างยอดดูหรือเวลาในการรับชมมากที่สุดสำหรับเพลย์ลิสต์ของเจ้าของเนื้อหา

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ insightTrafficSourceDetail
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ต้องระบุ insightTrafficSourceType
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
ตัวเลือกการจัดเรียง -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ insightTrafficSourceDetail
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1;insightTrafficSourceType
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 playlist, channel, group
ไม่บังคับ subscribedStatus
ตัวเลือกการจัดเรียง -views
-estimatedMinutesWatched
-playlistStarts

หมายเหตุ: รายงานนี้รองรับแหล่งที่มาของการเข้าชมบางแหล่งเท่านั้น VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES และ NO_LINK_EMBEDDED คือแหล่งที่มาของการเข้าชมที่ไม่รองรับ

ประเภทอุปกรณ์และระบบปฏิบัติการ

ประเภทอุปกรณ์สำหรับเพลย์ลิสต์

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

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ deviceType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ deviceType
ใช้ 0 ขึ้นไป day, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 playlist, channel, group
ใช้ 0 ขึ้นไป operatingSystem, subscribedStatus, youtubeProduct

ระบบปฏิบัติการสำหรับเพลย์ลิสต์

รายงานนี้จะรวบรวมสถิติการดูตามระบบปฏิบัติการของผู้ชม เช่น ระบุจำนวนยอดดูเพลย์ลิสต์ที่เกิดขึ้นในอุปกรณ์ Android หรือใน PlayStation

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ operatingSystem
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ operatingSystem
ใช้ 0 ขึ้นไป day, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 playlist, channel, group
ใช้ 0 ขึ้นไป deviceType, subscribedStatus, youtubeProduct

ระบบปฏิบัติการและประเภทอุปกรณ์สำหรับเพลย์ลิสต์

รายงานนี้จะรวบรวมสถิติการดูตามระบบปฏิบัติการและประเภทอุปกรณ์ของผู้ชม เช่น ระบุจำนวนยอดดูเพลย์ลิสต์ที่เกิดขึ้นในแท็บเล็ต Android หรือในอุปกรณ์เดสก์ท็อป Windows

แนะนำ
เนื้อหา
มิติข้อมูล:
ต้องระบุ deviceType, operatingSystem
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ deviceType, operatingSystem
ใช้ 0 ขึ้นไป day, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 playlist, channel, group
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

ข้อมูลประชากรผู้ชม

รายงานนี้จะรวบรวมสถิติการดูตามกลุ่มอายุและเพศของผู้ชม

แนะนำ
เนื้อหา
มิติข้อมูล:
ใช้อย่างน้อย 1 รายการ ageGroup, gender
เมตริก:
ต้องระบุ viewerPercentage
ตัวกรอง:
ใช้ 0 หรือ 1* เพลย์ลิสต์ กลุ่ม

หมายเหตุ: คุณต้องระบุตัวกรองอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้นหากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือaverageViewDurationในรายงาน
ไม่บังคับ channel
หมายเหตุ: ค่า viewerPercentage ในรายงานนี้ไม่ได้ปรับให้เป็นมาตรฐานสำหรับค่าต่างๆ หรือชุดค่าผสมของค่าสำหรับมิติข้อมูลรายละเอียดการเล่น (subscribedStatus และ youtubeProduct)

ตัวอย่างเช่น รายงานที่ใช้มิติข้อมูล subscribedStatus จะแสดงข้อมูล viewerPercentage ที่รวมกันเท่ากับ 100 เปอร์เซ็นต์สำหรับการดูแบบติดตาม และข้อมูล viewerPercentage ที่รวมกันเท่ากับ 100 เปอร์เซ็นต์สำหรับการดูแบบไม่ได้ติดตาม (ค่าทั้งหมดของช่อง viewerPercentage ทั้งหมดในรายงานคือ 200 เปอร์เซ็นต์)

คุณใช้ตัวกรองเพื่อให้แน่ใจว่ารายงานมีเฉพาะข้อมูล viewerPercentage สำหรับค่าเดียว (หรือชุดค่าผสม) สำหรับมิติข้อมูลรายละเอียดการเล่น

เพลย์ลิสต์ยอดนิยม

หมายเหตุ: รายงานเหล่านี้กำหนดให้คุณตั้งค่าพารามิเตอร์ maxResults เป็นค่าจำนวนเต็มไม่เกิน 200 ข้อมูลก่อนวันที่ 1 มกราคม 2013 มีเฉพาะสำหรับเพลย์ลิสต์ยอดนิยม 10 อันดับแรกเท่านั้น รายงานเหล่านี้ยังกำหนดให้คุณระบุค่าสำหรับพารามิเตอร์คำขอ sort ด้วย ซึ่งแตกต่างจากรายงานอื่นๆ ส่วนใหญ่

รายงานนี้จะแสดงเพลย์ลิสต์ยอดนิยมของเจ้าของเนื้อหาตามเกณฑ์การกรองและการจัดเรียงที่ระบุ

การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ต้องระบุ playlist
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 playlist, channel
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct
ตัวเลือกการจัดเรียง -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

รายงานประสิทธิภาพของโฆษณา

หมายเหตุ: รายงานประสิทธิภาพของโฆษณาต้องใช้โทเค็นการให้สิทธิ์ที่ให้สิทธิ์เข้าถึงขอบเขต https://www.googleapis.com/auth/yt-analytics-monetary.readonly

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

เมตริกประสิทธิภาพของโฆษณาที่อิงตามการแสดงผล ได้แก่

นอกจากนี้ รายงานวิดีโอบางรายการยังรองรับเมตริกประสิทธิภาพโฆษณาตามการเล่นต่อไปนี้ อย่างไรก็ตาม เมตริกเหล่านี้จะไม่รวมอยู่ในรายงานประสิทธิภาพโฆษณา

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ adType
ไม่บังคับ day
เมตริก:
ใช้อย่างน้อย 1 รายการ grossRevenue, adImpressions, cpm
ตัวกรอง:
ใช้ 1 รายการเท่านั้น video, group หรือชุดค่าผสมที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 country, continent, subContinent