YouTube Analytics API: Channel Reports

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

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

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

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

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

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

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

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

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

ฟิลเตอร์

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

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, annotationClickThroughRate, annotationClickratesWatched, estimatedRedMinutesWatchedannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:
จำเป็น province
ใช้ 0 หรือ 1 วิดีโอ กลุ่ม

ตามเวลา

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

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

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

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
จำเป็น province
ไม่บังคับ creatorContentType
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, annotationClickThroughRate, annotationClickratesWatched, estimatedRedMinutesWatchedannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:
จำเป็น country==US
ใช้ 0 หรือ 1 วิดีโอ กลุ่ม

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

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

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

เนื้อหา
มิติข้อมูล:
จำเป็น city
ใช้ 0 รายการขึ้นไป creatorContentType, ประเทศ, จังหวัด, subscribedStatus

หมายเหตุ: หากคุณรวมมิติข้อมูลจังหวัด คุณต้องใช้ตัวกรองcountry==USด้วย
ใช้ 0 หรือ 1 วัน, เดือน
เมตริก:
ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
ตัวกรอง:
ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent
ใช้ 0 หรือ 1 วิดีโอ กลุ่ม
ตัวเลือกการจัดเรียง: -จำนวนการดู
-estimatedMinutesWatched

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ใช้ 0 รายการขึ้นไป creatorContentType, subscribedStatus
ใช้ 0 หรือ 1 วัน, เดือน
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, annotationClickThroughRate, annotationClickratesWatched, estimatedRedMinutesWatchedannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
ตัวกรอง:
ใช้ 0 หรือ 1 วิดีโอ กลุ่ม
ใช้ 0 รายการขึ้นไป จังหวัด, subscribedStatus

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

รายงานนี้จะแสดงวิดีโอยอดนิยมของช่อง คุณกรองรายงานเพื่อแสดงวิดีโอยอดนิยมตามประเทศ ทวีป หรือsubContinentได้

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ตามเวลา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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