YouTube Analytics API: Channel Reports

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

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

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

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

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

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

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

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

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

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

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

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

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

ตัวกรอง

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

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

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

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

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

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

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

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

อย่างไรก็ตาม ค่าพารามิเตอร์ day,month ไม่ถูกต้องเนื่องจากใช้มิติข้อมูลตามเวลา 2 รายการ และคำขอต้องใช้ 0 หรือ 1

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

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

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

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

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

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

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

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

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

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

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

ตามเวลา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ dma
ใช้ 0 หรือ 1 day
month
creatorContentType
subscribedStatus
เมตริก:
ใช้ 1 รายการขึ้นไป engagedViews
views
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
ตัวกรอง:
ใช้ 0 หรือ 1 country==US
province
ใช้ 0 หรือ 1 กลุ่ม
วิดีโอ
ตัวเลือกการจัดเรียง -views
-estimatedMinutesWatched

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องระบุ deviceType, operatingSystem
ใช้ 0 ขึ้นไป creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
เมตริก:
ใช้ 1 รายการขึ้นไป engagedViews, views, 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 จะแสดงข้อมูล viewerPercentage ที่รวมกันได้ 100% สำหรับยอดดูจากผู้ชมที่ติดตามและข้อมูล viewerPercentage ที่รวมกันได้ 100% สำหรับยอดดูจากผู้ชมที่ไม่ได้ติดตาม (ค่ารวมของช่อง viewerPercentage ทั้งหมดในรายงานคือ 200%)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

จำนวนผู้ชมที่ดูพร้อมกัน (สำหรับไลฟ์สด)

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

เนื้อหา
มิติข้อมูล:
ใช้ 0 หรือ 1 livestreamPosition
เมตริก:
ใช้ 1 รายการขึ้นไป averageConcurrentViewers
peakConcurrentViewers
ตัวกรอง:
ต้องระบุ วิดีโอ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ตามเวลา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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