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 ขึ้นไป: คุณสามารถเลือกที่จะรวมค่าใดค่าหนึ่งหรือทุกค่าจากกลุ่ม

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

• uploaderType==self
• claimedStatus==claimed
• claimedStatus==claimed;uploaderType==self
• claimedStatus==claimed;uploaderType==thirdParty

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

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

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

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

หมายเหตุ: ค่า viewerPercentage ในรายงานนี้ไม่ได้ทำให้ค่าต่างๆ ของมิติข้อมูลรายละเอียดการเล่น subscribedStatus เป็นค่ามาตรฐาน

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

คุณใช้ตัวกรองเพื่อให้มั่นใจว่ารายงานมีเฉพาะข้อมูล viewerPercentage สำหรับมิติข้อมูล 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 เวอร์ชันโดยละเอียด

สำคัญ: อัปเดตรายงานเพลย์ลิสต์สำหรับช่องก่อนวันที่ 30 มิถุนายน 2024 และอัปเดตรายงานเพลย์ลิสต์สำหรับเจ้าของเนื้อหาภายในวันที่ 31 ธันวาคม 2024 โปรดทราบการเปลี่ยนแปลงต่อไปนี้

• เราเลิกใช้งานมิติข้อมูล isCurated แล้ว
  • สำหรับรายงานแชแนล ระบบจะไม่รองรับมิติข้อมูลนี้อีกต่อไปตั้งแต่วันที่ 30 มิถุนายน 2024
  • สำหรับรายงานเจ้าของเนื้อหา ระบบจะไม่รองรับมิติข้อมูลนี้อีกต่อไปตั้งแต่วันที่ 31 ธันวาคม 2024 เป็นต้นไป
• ลักษณะการทำงานของเมตริก views จะเปลี่ยนแปลงเมื่อคุณนำมิติข้อมูล isCurated ออกจากคำขอเพื่อเรียกข้อมูลรายงานเพลย์ลิสต์ ดังนี้
  • เมื่อคำขอมีมิติข้อมูล isCurated เมตริก views จะระบุจำนวนครั้งที่มีการดูวิดีโอในบริบทของเพลย์ลิสต์
  • เมื่อคำขอไม่ได้รวมมิติข้อมูล isCurated เมตริก views จะระบุจำนวนครั้งทั้งหมดที่มีการดูวิดีโอ ส่วนเมตริก playlistViews จะแสดงจำนวนครั้งที่มีการดูวิดีโอในบริบทของเพลย์ลิสต์

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

ดูรายละเอียดเพิ่มเติมได้ที่ประวัติการแก้ไข

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

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

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

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

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

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

สำคัญ: ตามที่แสดงในตารางด้านล่าง เมตริก views ให้ข้อมูลประเภทต่างๆ ในรายงานเพลย์ลิสต์แต่ละเวอร์ชันที่มีอยู่ 2 เวอร์ชัน

• ในรูปแบบรายงานที่แนะนํา views คือเมตริกวิดีโอแบบรวม
• ในรายงานที่ดึงข้อมูลโดยใช้มิติข้อมูล isCurated views เป็นเมตริกในเพลย์ลิสต์

แนะนำ

เนื้อหา
เมตริกวิดีโอทั้งหมด	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

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

เนื้อหา
มิติข้อมูล:	[ไม่มี]
เมตริก:	ใช้อย่างน้อย 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

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

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

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

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

หมายเหตุ: รายงานเหล่านี้กำหนดให้คุณต้องตั้งค่าพารามิเตอร์ 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