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

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

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

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

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

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

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

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

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

ขอบเขต
https://www.googleapis.com/auth/yt-analytics.readonly	ดูรายงาน Analytics ของ YouTube สำหรับเนื้อหา YouTube ของคุณ ขอบเขตนี้จะให้สิทธิ์เข้าถึงเมตริกกิจกรรมของผู้ใช้ เช่น ยอดดูและการนับคะแนน
https://www.googleapis.com/auth/yt-analytics-monetary.readonly	ดูรายงานการเงินของ YouTube Analytics สำหรับเนื้อหา YouTube ของคุณ ขอบเขตนี้ให้สิทธิ์เข้าถึงเมตริกกิจกรรมของผู้ใช้ เมตริกรายได้โดยประมาณและประสิทธิภาพโฆษณา
https://www.googleapis.com/auth/youtube	จัดการบัญชี YouTube ของคุณ ใน API ของ YouTube Analytics เจ้าของช่องจะใช้ขอบเขตนี้เพื่อจัดการกลุ่มและรายการของกลุ่มใน YouTube Analytics
https://www.googleapis.com/auth/youtubepartner	ดูและจัดการเนื้อหา YouTube และเนื้อหาที่เกี่ยวข้องบน YouTube ใน API ของ YouTube Analytics เจ้าของเนื้อหาจะใช้ขอบเขตนี้เพื่อจัดการกลุ่มและรายการของกลุ่มใน 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 วัน, เดือน
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration averageViewPercentage
ตัวกรอง:	ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 วิดีโอ กลุ่ม ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct

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

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

อย่างไรก็ตาม ค่าพารามิเตอร์ day,month ไม่ถูกต้องเนื่องจากใช้มิติข้อมูลตามเวลา 2 รายการ แต่คำขอใช้ได้ 0 หรือ 1 ก็ได้ ในกรณีนี้ ค่าพารามิเตอร์ subscribedStatus,youtubeProduct จะแสดงรายงานตามจริง แต่ไม่ได้รวบรวมเมตริกตามวัน สัปดาห์ เดือน ฯลฯ (รายงานดังกล่าวจัดทำเอกสารแยกต่างหากในเอกสารประกอบ)

คำศัพท์ในตารางรายงาน

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

• คำศัพท์เหล่านี้หมายความว่าต้องมีค่าต่อไปนี้
  • ต้องระบุ: คุณต้องระบุค่า
  • ใช้ 1 ทุกประการ: คุณต้องใส่ค่าจากกลุ่ม 1 ค่า
  • ใช้อย่างน้อย 1 ค่า: คุณจะรวมค่าใดก็ได้หรือทุกค่าจากกลุ่มก็ได้ แต่จะต้องใส่อย่างน้อย 1 ค่า
• คำศัพท์เหล่านี้หมายความว่าค่าจะไม่บังคับ ดังนี้
  • ไม่บังคับ: คุณเลือกรวมค่าได้
  • ใช้ 0 หรือ 1: คุณสามารถเลือกรวมค่าหนึ่งจากกลุ่มได้
  • ใช้ 0 ขึ้นไป: คุณสามารถเลือกที่จะรวมค่าใดค่าหนึ่งหรือทุกค่าจากกลุ่ม

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

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

สถิติเบื้องต้น (รวมถึงจำนวนสมาชิก)

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

เนื้อหา
มิติข้อมูล:	[ไม่มี]
เมตริก:	ใช้อย่างน้อย 1 รายการ %View, redViewsvideosRemovedFromPlaylistsestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent

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

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

เนื้อหา
มิติข้อมูล:	[ไม่มี]
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, annotationClickThroughRate, annotationClickratesWatched, estimatedRedMinutesWatchedannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ จำเป็น province

ตามเวลา

กิจกรรมในช่วงระยะเวลาหนึ่ง

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

เนื้อหา
มิติข้อมูล:	ใช้ 1 เท่านั้น วัน, เดือน ไม่บังคับ creatorContentType
เมตริก:	ใช้อย่างน้อย 1 รายการ <5>จำนวนผู้ชม: {จำนวนผู้ชม ,},}{}{คุณสามารถดูสถานะการค้นหาจากการค้นหาสถานะการค้นหาสูงสุดได้ ขึ้น ฝ่ายสนับสนุน 1} redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent

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

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

เนื้อหา
มิติข้อมูล:	ใช้ 1 เท่านั้น วัน, เดือน ไม่บังคับ creatorContentType
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, annotationClickThroughRate, annotationClickratesWatched, estimatedRedMinutesWatchedannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ จำเป็น province

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

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

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

เนื้อหา
มิติข้อมูล:	จำเป็น country ไม่บังคับ creatorContentType
เมตริก:	ใช้อย่างน้อย 1 รายการ %View, redViews, Subscribercomments, likes, dislikes, videosAddedTo11}, {ลักษณ์ความลบจากการทำงาน, estimatedMinutesWatched, {}ค่าประมาณการแสดงผล{/14 }{}videosRemovedFromPlaylistsestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ ใช้ 0 หรือ 1 ทวีป subContinent

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

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

เนื้อหา
มิติข้อมูล:	จำเป็น province ไม่บังคับ creatorContentType
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, annotationClickThroughRate, annotationClickratesWatched, estimatedRedMinutesWatchedannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ จำเป็น country==US

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

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

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

เนื้อหา
มิติข้อมูล:	จำเป็น city ใช้ 0 รายการขึ้นไป creatorContentType, ประเทศ, จังหวัด, subscribedStatus หมายเหตุ: หากคุณรวมมิติข้อมูลจังหวัด คุณต้องใช้ตัวกรองcountry==USด้วย ใช้ 0 หรือ 1 วัน, เดือน
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent
ตัวเลือกการจัดเรียง:	-จำนวนการดู -estimatedMinutesWatched

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

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

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

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

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

กิจกรรมของผู้ใช้ตามสถานะที่สมัครรับข้อมูล

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

เนื้อหา
มิติข้อมูล:	ใช้ 0 รายการขึ้นไป creatorContentType, subscribedStatus ใช้ 0 หรือ 1 วัน, เดือน
เมตริก:	ใช้อย่างน้อย 1 รายการ {views,redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, ทั้ง {ทั้งนี้ ระยะเวลา {การโฆษณา}, { } ทั้ง Dataการโฆษณาและ estimatedMinutesWatched, estimatedRedMinutesWatched averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent ไม่บังคับ subscribedStatus

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

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

เนื้อหา
มิติข้อมูล:	ใช้ 0 รายการขึ้นไป creatorContentType, subscribedStatus ใช้ 0 หรือ 1 วัน, เดือน
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, annotationClickThroughRate, annotationClickratesWatched, estimatedRedMinutesWatchedannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ จำเป็น province ไม่บังคับ subscribedStatus

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

รายละเอียดการเล่นตามจังหวัดโดยใช้เมตริก averageViewPercentage

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

หมายเหตุ: รายงานนี้รองรับเฉพาะแหล่งที่มาของการเข้าชมที่เฉพาะเจาะจงเท่านั้น ตัวอย่างเช่น แหล่งที่มาของการเข้าชม NO_LINK_EMBEDDED ไม่มีรายละเอียดเพิ่มเติม จึงไม่รองรับรายงานนี้ ดูคําจํากัดความของ insightTrafficSourceType สําหรับรายละเอียดเกี่ยวกับแหล่งที่มาของการเข้าชมที่รองรับรายงานนี้

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:	จำเป็น sharingService ไม่บังคับ creatorContentType, subscribedStatus
เมตริก:	ใช้อย่างน้อย 1 รายการ การแชร์
ตัวกรอง:	ใช้ 1 เท่านั้น video, channel, group หรือการรวม uploaderType และ claimedStatus ที่รองรับ ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent ไม่บังคับ subscribedStatus

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:	จำเป็น วิดีโอ ไม่บังคับ creatorContentType
เมตริก:	ใช้อย่างน้อย 1 รายการ %View, redViews, Subscribercomments, likes, dislikes, videosAddedTo11}, {ลักษณ์ความลบจากการทำงาน, estimatedMinutesWatched, {}ค่าประมาณการแสดงผล{/14 }{}videosRemovedFromPlaylistsestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
ตัวกรอง:	ใช้ 1 เท่านั้น channel หรือ uploaderType ที่สนับสนุนร่วมกันและ claimedStatus ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent
ตัวเลือกการจัดเรียง:	-views -redViews -estimatedRevenue -estimatedRedPartnerRevenue -estimatedMinutesWatched -estimatedRedMinutesWatched -subscribersGained -subscribersLost

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

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

เนื้อหา
มิติข้อมูล:	จำเป็น วิดีโอ ไม่บังคับ creatorContentType
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, annotationClickThroughRate, annotationClickratesWatched, estimatedRedMinutesWatchedannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:	ใช้ 1 เท่านั้น channel หรือ uploaderType ที่สนับสนุนร่วมกันและ claimedStatus จำเป็น province
ตัวเลือกการจัดเรียง:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

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

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

เนื้อหา
มิติข้อมูล:	จำเป็น วิดีโอ ไม่บังคับ creatorContentType
เมตริก:	ใช้อย่างน้อย 1 รายการ {views,redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, ทั้งนี้ {SIVE {และ] {estimatedMinutesWatched, estimatedRedMinutesWatched averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:	ใช้ 1 เท่านั้น channel หรือ uploaderType ที่สนับสนุนร่วมกันและ claimedStatus ไม่บังคับ subscribedStatus ใช้ 0 หรือ 1 ประเทศ ทวีป subContinent
ตัวเลือกการจัดเรียง:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

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

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

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

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

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

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

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

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

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

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

เมตริกวิดีโอทั้งหมด

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

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

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

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

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

แนะนำ

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

การใช้ isCurated

เนื้อหา
เมตริกวิดีโอทั้งหมด	สิ่งที่ทำไม่ได้
เมตริกในเพลย์ลิสต์	views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage, redViews, estimatedRedMinutesWatched

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	[ไม่มี]
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStartviewsวิว
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	[ไม่มี]
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ช่อง เพลย์ลิสต์ กลุ่ม ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct

ตามเวลา

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

แนะนำ

เนื้อหา
มิติข้อมูล:	ใช้ 1 เท่านั้น วัน, เดือน
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStartviewsวิว
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	ใช้ 1 เท่านั้น วัน, เดือน ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ช่อง เพลย์ลิสต์ กลุ่ม ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct

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

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	จำเป็น country
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ใช้ 0 หรือ 1 ทวีป subContinent ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น country ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	จำเป็น province
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration
ตัวกรอง:	จำเป็น ประเทศ==US ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น province ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated==1;ประเทศ==US ใช้ 0 หรือ 1 ช่อง เพลย์ลิสต์ กลุ่ม ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	จำเป็น insightPlaybackLocationType
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น insightPlaybackLocationType ใช้ 0 รายการขึ้นไป วัน, subscribedStatus
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ไม่บังคับ subscribedStatus

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

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

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

แนะนำ

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

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น insightPlaybackLocationDetail
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated==1;insightPlaybackLocationType==EMBEDDED ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ไม่บังคับ subscribedStatus
ตัวเลือกการจัดเรียง:	-views -estimatedMinutesWatched -playlistStarts

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	จำเป็น insightTrafficSourceType
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStartviewsวิว
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น insightTrafficSourceType ใช้ 0 รายการขึ้นไป วัน, subscribedStatus
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ไม่บังคับ subscribedStatus

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

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	จำเป็น insightTrafficSourceDetail
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStartviewsวิว
ตัวกรอง:	จำเป็น insightTrafficSourceType ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง
ตัวเลือกการจัดเรียง:	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น insightTrafficSourceDetail
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated==1;insightTrafficSourceType ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ไม่บังคับ subscribedStatus
ตัวเลือกการจัดเรียง:	-views -estimatedMinutesWatched -playlistStarts

หมายเหตุ: รายงานนี้รองรับเฉพาะแหล่งที่มาของการเข้าชมที่เฉพาะเจาะจงเท่านั้น ตัวอย่างเช่น แหล่งที่มาของการเข้าชม NO_LINK_EMBEDDED ไม่มีรายละเอียดเพิ่มเติม จึงไม่รองรับรายงานนี้ ดูคําจํากัดความของ insightTrafficSourceType สําหรับรายละเอียดเกี่ยวกับแหล่งที่มาของการเข้าชมที่รองรับรายงานนี้

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

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	จำเป็น deviceType
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น deviceType ใช้ 0 รายการขึ้นไป วัน, subscribedStatus, youtubeProduct
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ใช้ 0 รายการขึ้นไป operatingSystem, subscribedStatus, youtubeProduct

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	จำเป็น operatingSystem
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น operatingSystem ใช้ 0 รายการขึ้นไป วัน, subscribedStatus, youtubeProduct
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ใช้ 0 รายการขึ้นไป deviceType, subscribedStatus, youtubeProduct

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	จำเป็น deviceType, operatingSystem
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น deviceType, operatingSystem ใช้ 0 รายการขึ้นไป วัน, subscribedStatus, youtubeProduct
เมตริก:	ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct

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

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

แนะนำ

เนื้อหา
มิติข้อมูล:	ใช้อย่างน้อย 1 รายการ ageGroup, gender
เมตริก:	จำเป็น viewerPercentage
ตัวกรอง:	ใช้ 0 หรือ 1* playlist, group หมายเหตุ: คุณต้องระบุตัวกรองใดตัวกรองหนึ่งเหล่านี้ หากมีการขอเมตริกยอดดู estimatedMinutesWatched หรือ averageViewDuration ในรายงาน ไม่บังคับ ช่อง

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	ใช้อย่างน้อย 1 รายการ ageGroup, gender ใช้ 0 รายการขึ้นไป subscribedStatus
เมตริก:	จำเป็น viewerPercentage
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 เพลย์ลิสต์ ช่อง กลุ่ม ไม่บังคับ subscribedStatus

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

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

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

แนะนำ

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

การใช้ isCurated

เนื้อหา
มิติข้อมูล:	จำเป็น เพลย์ลิสต์
เมตริก:	ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
ตัวกรอง:	จำเป็น isCurated = 1 ใช้ 0 หรือ 1 เพลย์ลิสต์, ช่อง ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 รายการขึ้นไป subscribedStatus, youtubeProduct
ตัวเลือกการจัดเรียง:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched -playlistStarts

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

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

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

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

• grossRevenue
• adImpressions
• CPM

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

• playbackBasedCpm
• monetizedPlaybacks

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

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