YouTube Analytics API: Content Owner Reports

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

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

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

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

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

การดึงข้อมูลรายงาน

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

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

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

คำขอ API ของข้อมูลวิเคราะห์ YouTube ใช้ขอบเขตการให้สิทธิ์ต่อไปนี้

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

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

ตัวกรอง

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus, youtubeProduct
ใช้ 0 หรือ 1 day, month
เมตริก:
ใช้ 1 รายการขึ้นไป engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:
ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent
ใช้ 0 หรือ 1 วิดีโอ กลุ่ม
ใช้ 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

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

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

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

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

เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้ 1 รายการขึ้นไป engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost
ตัวกรอง:
ใช้ 1 รายการเท่านั้น วิดีโอ ช่อง กลุ่ม หรือการผสมผสานที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent

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

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

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

ตามเวลา

กิจกรรมสำหรับระยะเวลา

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

เนื้อหา
มิติข้อมูล:
ใช้ 1 รายการเท่านั้น day, month
ไม่บังคับ creatorContentType
เมตริก:
ใช้ 1 รายการขึ้นไป engagedViews*, monetizedPlaybacks
ตัวกรอง:
ใช้ 1 รายการเท่านั้น วิดีโอ ช่อง กลุ่ม หรือการผสมผสานที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent

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

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

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

พื้นที่ทางภูมิศาสตร์ของผู้ใช้

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

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

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

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

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

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

กิจกรรมของผู้ใช้ตามเมือง (<= 250 ผลลัพธ์)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

หมายเหตุ: รายงานนี้รองรับเฉพาะแหล่งที่มาของการเข้าชมบางรายการ VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES และ NO_LINK_EMBEDDED เป็นแหล่งที่มาของการเข้าชมบางส่วนที่ไม่รองรับ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

วิดีโอยอดนิยมโดยรวม ตามประเทศ ตามทวีป หรือตามอนุทวีป (ผลลัพธ์ไม่เกิน 200 รายการ)

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ วิดีโอ
ไม่บังคับ creatorContentType
เมตริก:
ใช้ 1 รายการขึ้นไป engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost
ตัวกรอง:
ใช้ 1 รายการเท่านั้น channel หรือการผสมผสานที่รองรับของ uploaderType และ claimedStatus
ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent
ตัวเลือกการจัดเรียง -engagedViews
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

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

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

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

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

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

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

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

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

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

วิดีโอยอดนิยมที่มีตัวกรองรายละเอียดการเล่น (ผลลัพธ์ไม่เกิน 200 รายการ)

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

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

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

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

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

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

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

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

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

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

เนื้อหา
เมตริกวิดีโอแบบรวม engagedViews, views, estimatedMinutesWatched, averageViewDuration
เมตริกในเพลย์ลิสต์ playlistViews, playlistEstimatedMinutesWatched, playlistAverageViewDuration, playlistSaves, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel

ตามเวลา

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel

พื้นที่ทางภูมิศาสตร์ของผู้ใช้

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ใช้ 0 หรือ 1 continent, subContinent
ไม่บังคับ channel

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

รายงานนี้จะแสดงสถิติกิจกรรมในเพลย์ลิสต์สำหรับรัฐต่างๆ ในสหรัฐอเมริกาและวอชิงตัน ดี. ซี. สําหรับรายงานนี้ คุณจะใส่ country==US ในค่าพารามิเตอร์ filters

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel

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

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel
ตัวเลือกการจัดเรียง -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel

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

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel
ตัวเลือกการจัดเรียง -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

หมายเหตุ: รายงานนี้รองรับเฉพาะแหล่งที่มาของการเข้าชมบางรายการ VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES และ NO_LINK_EMBEDDED เป็นแหล่งที่มาของการเข้าชมบางส่วนที่ไม่รองรับ

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

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel

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

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

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

หมายเหตุ: ต้องระบุตัวกรองเหล่านี้อย่างใดอย่างหนึ่ง หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน
ไม่บังคับ channel

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ เพลย์ลิสต์
เมตริก:
ใช้ 1 รายการขึ้นไป averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวเลือกการจัดเรียง -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

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

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

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

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

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

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

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