YouTube Analytics API: Channel Reports

หน้านี้จะแสดงรายงานที่เจ้าของช่องสามารถเรียกข้อมูลด้วย YouTube Analytics API รายงานช่องจะแสดงเมตริกกิจกรรมของผู้ใช้สำหรับช่องที่ระบุ รวมถึงวัดสิ่งต่างๆ เช่น ยอดดูวิดีโอ การให้คะแนน และจำนวนการติดตาม

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

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

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

หากต้องการเรียกข้อมูลรายงานของช่อง คุณต้องตั้งค่าพารามิเตอร์ ids ในคําขอ API เป็นค่าใดค่าหนึ่งต่อไปนี้

  • channel==MINE – API จะแสดงข้อมูลของช่อง YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์

  • channel==CHANNEL_ID – กําหนด CHANNEL_ID เป็นรหัสช่องที่ไม่ซ้ำกันของช่องที่คุณต้องการดึงข้อมูล ผู้ใช้ที่อนุญาตให้ส่งคำขอต้องเป็นเจ้าของช่อง

    ปัจจุบันรหัสช่องคือสตริงที่ขึ้นต้นด้วยตัวอักษร UC แต่รูปแบบอาจเปลี่ยนแปลงได้ (คุณดูรหัสของช่องได้ในหน้าการตั้งค่าบัญชีขั้นสูงสำหรับช่อง YouTube หรือจะเรียกข้อมูลรหัสของช่องแบบเป็นโปรแกรมโดยใช้เมธอด YouTube Data API's channels.list ก็ได้)

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

คำขอ 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 จึงไม่ได้ให้สิทธิ์เข้าถึงข้อมูลทางการเงินในรายงานเหล่านั้น

ตัวกรอง

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

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

ดูคำจำกัดความของพารามิเตอร์ 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 ขึ้นไป: คุณสามารถเลือกรวมค่าใดก็ได้หรือทั้งหมดจากกลุ่ม

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

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

สถิติกิจกรรมของผู้ใช้พื้นฐาน

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

เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 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*
ตัวกรอง:
ใช้ 0 หรือ 1 country, continent, subContinent
ใช้ 0 หรือ 1 video, group

สถิติกิจกรรมพื้นฐานของผู้ใช้สำหรับรัฐในสหรัฐอเมริกา

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

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

ตามเวลา

กิจกรรมของผู้ใช้ตามประเทศในระยะเวลาที่เจาะจง

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

เนื้อหา
มิติข้อมูล:
ใช้ 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*
ตัวกรอง:
ใช้ 0 หรือ 1 country, continent, subContinent
ใช้ 0 หรือ 1 video, group

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ 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*
ตัวกรอง:
ใช้ 0 หรือ 1 continent, subContinent
ใช้ 0 หรือ 1 video, group

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

รายงานนี้จะแสดงสถิติกิจกรรมของผู้ใช้สำหรับรัฐในสหรัฐอเมริกาและเขตโคลัมเบีย สําหรับรายงานนี้ คุณต้องตั้งค่าพารามิเตอร์ 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
ตัวกรอง:
ต้องระบุ country==US
ใช้ 0 หรือ 1 video, group

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

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

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

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

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

กิจกรรมของผู้ใช้ตาม DMA

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ dma
ใช้ 0 หรือ 1 day
month
creatorContentType
subscribedStatus
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
ตัวกรอง:
ใช้ 0 หรือ 1 country==US
province
ใช้ 0 หรือ 1 video
group
ตัวเลือกการจัดเรียง -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
ตัวกรอง:
ใช้ 0 หรือ 1 country, continent, subContinent
ใช้ 0 หรือ 1 video, group
ไม่บังคับ 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
ตัวกรอง:
ใช้ 0 หรือ 1 video, group
ใช้ 0 ขึ้นไป province, subscribedStatus

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

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

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

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

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

รายงานนี้จะแสดงสถิติการเล่นแบบละเอียดสำหรับช่วงเวลาที่เจาะจง โดยรองรับเมตริก 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ insightTrafficSourceDetail
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
ตัวกรอง:
ต้องระบุ insightTrafficSourceType (ดูหมายเหตุด้านล่างตาราง)
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 video, group
ใช้ 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
ตัวกรอง:
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 หรือ 1 video, group
ใช้ 0 ขึ้นไป operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

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

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

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

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ sharingService
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus
เมตริก:
ใช้อย่างน้อย 1 รายการ shares
ตัวกรอง:
ใช้ 0 หรือ 1 country, continent, subContinent
ใช้ 0 หรือ 1 video, group
ไม่บังคับ subscribedStatus

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

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

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

    เมตริกเหล่านี้แสดงให้เห็นว่าวิดีโอคงผู้ชมไว้ได้ดีเพียงใด

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

  • สถิติการดูแบบละเอียด

    เมตริกเหล่านี้ให้ข้อมูลเกี่ยวกับความถี่ในการดูส่วนต่างๆ ของวิดีโอ

    • startedWatching บ่งบอกความถี่ที่ผู้ชมเริ่มดูวิดีโอในช่วงใดช่วงหนึ่งของวิดีโอ
    • stoppedWatching บ่งบอกความถี่ที่ผู้ชมหยุดดูวิดีโอในช่วงใดช่วงหนึ่งของวิดีโอ
    • totalSegmentImpressions แสดงความถี่ในการดูส่วนใดส่วนหนึ่งของวิดีโอ

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

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

จำนวนผู้ชมที่ดูพร้อมกัน (สำหรับสตรีมแบบสด)

รายงานนี้จะแสดงจำนวนผู้ชมที่ดูพร้อมกัน ณ ตำแหน่งหนึ่งๆ สำหรับวิดีโอสตรีมแบบสดรายการเดียว ฟิลเตอร์จะระบุวิดีโอ โดยปกติแล้ว มิติข้อมูลตําแหน่งจะแสดงนาทีเดียว

เนื้อหา
มิติข้อมูล:
ใช้ 0 หรือ 1 livestreamPosition
เมตริก:
ใช้อย่างน้อย 1 รายการ averageConcurrentViewers
peakConcurrentViewers
ตัวกรอง:
ต้องระบุ video

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

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

วิดีโอยอดนิยมที่มีตัวกรองระดับภูมิภาค (ไม่บังคับ) (<= 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, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
ตัวกรอง:
ใช้ 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
ตัวกรอง:
ต้องระบุ province
ไม่บังคับ subscribedStatus
ตัวเลือกการจัดเรียง -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
ตัวกรอง:
ไม่บังคับ subscribedStatus
ใช้ 0 หรือ 1 country, continent, subContinent
ตัวเลือกการจัดเรียง -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

การใช้ isCurated
เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 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
ตัวกรอง:
ใช้ 1 รายการเท่านั้น playlist, group
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ใช้ 1 รายการเท่านั้น day, month
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 playlist, group
ใช้ 0 หรือ 1 country, province, continent, subContinent
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

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

กิจกรรมในเพลย์ลิสต์ตามประเทศ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

แนะนำ
เนื้อหา
มิติข้อมูล:
ใช้อย่างน้อย 1 รายการ ageGroup, gender
เมตริก:
ต้องระบุ viewerPercentage
ตัวกรอง:
ใช้ 1 รายการเท่านั้น playlist, group
การใช้ isCurated
เนื้อหา
มิติข้อมูล:
ใช้อย่างน้อย 1 รายการ ageGroup, gender
ใช้ 0 ขึ้นไป subscribedStatus
เมตริก:
ต้องระบุ viewerPercentage
ตัวกรอง:
ต้องระบุ isCurated==1
ใช้ 0 หรือ 1 playlist, group
ใช้ 0 หรือ 1 country, province, continent, subContinent
ไม่บังคับ subscribedStatus
หมายเหตุ: ค่า viewerPercentage ในรายงานนี้ไม่ได้ปรับให้เป็นมาตรฐานสำหรับค่าต่างๆ ของมิติข้อมูลรายละเอียดการเล่น subscribedStatus

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

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

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

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

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

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

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

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

รายงานนี้จะแสดงสถิติที่แสดงให้เห็นสาเหตุที่ผู้ใช้ยกเลิกการเป็นสมาชิกของช่อง

เนื้อหา
มิติข้อมูล:
ใช้ 0 หรือ 1 membershipsCancellationSurveyReason
เมตริก:
ต้องระบุ membershipsCancellationSurveyResponses

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

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

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

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

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

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

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