YouTube Analytics API: Channel Reports

เราจะเลิกใช้งานมิติข้อมูล 7DayTotals และ 30DayTotals โปรดดูข้อมูลเพิ่มเติมที่ประวัติการแก้ไข

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

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

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

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

ตัวกรอง

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

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

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

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

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

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

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

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

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

รายงานคําศัพท์ของตาราง

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

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

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

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

สถิติกิจกรรมของผู้ใช้เบื้องต้น

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

เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 1 รายการ
ตัวกรอง:
ใช้ 0 หรือ 1 ประเทศ, ทวีป, ทวีปย่อย
ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม

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

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

เนื้อหา
มิติข้อมูล:
[ไม่มี]
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, AverageViewDuration, AverageViewPercentage, annotationClickThroughRate, annotationcloseRate{}}{}}
ตัวกรอง:
ต้องใช้ province
ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม

ตามเวลา

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ใช้ 1 พอดี วัน เดือน
ไม่บังคับ ประเภทผู้สร้างเนื้อหา
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, AverageViewDuration, AverageViewPercentage, annotationClickThroughRate, annotationcloseRate{}}{}}
ตัวกรอง:
ต้องใช้ province
ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม

ภูมิศาสตร์ของผู้ใช้

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ country
ไม่บังคับ ประเภทผู้สร้างเนื้อหา
เมตริก:
ใช้อย่างน้อย 1 รายการ
ตัวกรอง:
ใช้ 0 หรือ 1 ทวีป ทวีปย่อย
ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม

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

รายงานนี้ให้สถิติกิจกรรมของผู้ใช้ในรัฐต่างๆ ของสหรัฐฯ และเขตปกครองพิเศษโคลัมเบีย (D.C.) สําหรับรายงานนี้ คุณต้องตั้งค่าพารามิเตอร์ filters เป็น country==US

เนื้อหา
มิติข้อมูล:
ต้องใช้ province
ไม่บังคับ ประเภทผู้สร้างเนื้อหา
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, AverageViewDuration, AverageViewPercentage, annotationClickThroughRate, annotationcloseRate{}}{}}
ตัวกรอง:
ต้องใช้ country==สหรัฐอเมริกา
ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม

กิจกรรมของผู้ใช้ตามเมือง (<= ผลการค้นหา 250 รายการ)

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

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

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

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

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

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

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ใช้ 0 ขึ้นไป creatorContentType, subscribedStatus
ใช้ 0 หรือ 1 วัน เดือน
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, AverageViewDuration, AverageViewPercentage, annotationClickThroughRate, annotationcloseRate{}}{}}
ตัวกรอง:
ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม
ใช้ 0 ขึ้นไป province, subscribedStatus

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

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

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

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

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

รายงานนี้แสดงสถิติรายละเอียดการเล่นสําหรับแต่ละช่วงเวลา รองรับเมตริก AverageViewPercentage

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

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

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

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

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

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

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

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

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

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

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

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

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

ตำแหน่งการเล่น

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

รายงานที่ใช้มิติข้อมูล subscribedStatus ได้แสดง เปอร์เซ็นต์ผู้ชม เพิ่มขึ้น 1000 ข้อมูล 100 ขึ้นไป (ค่ารวมของช่อง viewerPercent ทั้งหมดในรายงานคือ 200 เปอร์เซ็นต์)

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ อัตราส่วนเวลาของวิดีโอ
ไม่บังคับ ประเภทผู้สร้างเนื้อหา
เมตริก:
ใช้อย่างน้อย 1 รายการ audienceWatchRatio, relativeการรักษาประสิทธิภาพ
ตัวกรอง:
ต้องใช้ วิดีโอ
ใช้ 0 ขึ้นไป audienceType, subscribedStatus, youtubeProduct

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ วิดีโอ
ไม่บังคับ ประเภทผู้สร้างเนื้อหา
เมตริก:
ใช้อย่างน้อย 1 รายการ
ตัวกรอง:
ใช้ 0 หรือ 1 ประเทศ, ทวีป, ทวีปย่อย
ตัวเลือกการจัดเรียง -ยอดดู
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-ผู้ติดตามที่ได้รับ
-ผู้ติดตามสูญเสีย

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ วิดีโอ
ไม่บังคับ ประเภทผู้สร้างเนื้อหา
เมตริก:
ใช้อย่างน้อย 1 รายการ views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, AverageViewDuration, AverageViewPercentage, annotationClickThroughRate, annotationcloseRate{}}{}}
ตัวกรอง:
ต้องใช้ province
ไม่บังคับ subscribedStatus
ตัวเลือกการจัดเรียง -ยอดดู
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

วิดีโอยอดนิยมสําหรับผู้ชมที่ติดตามหรือเลิกติดตาม(<= ผลการค้นหา 200 รายการ)

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ วิดีโอ
ไม่บังคับ ประเภทผู้สร้างเนื้อหา
เมตริก:
ใช้อย่างน้อย 1 รายการ <aทําให้ผู้ใช้]
ตัวกรอง:
ไม่บังคับ subscribedStatus
ใช้ 0 หรือ 1 ประเทศ, ทวีป, ทวีปย่อย
ตัวเลือกการจัดเรียง -ยอดดู
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ วิดีโอ
ไม่บังคับ ประเภทผู้สร้างเนื้อหา
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, AverageViewDuration, AverageViewPercentage
ตัวกรอง:
ใช้ 0 หรือ 1 ประเทศ, จังหวัด, ทวีป ทวีปย่อย
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct
ตัวเลือกการจัดเรียง -ยอดดู
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

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

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

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

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

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

ตามเวลา

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

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

ภูมิศาสตร์ของผู้ใช้

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ country
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ ยอดดู, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, AverageViewDuration, playlistStarts, viewsPerPlaylistStart, AverageTimeInPlaylist
ตัวกรอง:
ต้องใช้ isCuated==1
ใช้ 0 หรือ 1 ทวีป ทวีปย่อย
ใช้ 0 หรือ 1 เพลย์ลิสต์ กลุ่ม
ใช้ 0 ขึ้นไป subscribedStatus, youtubeProduct

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

รายงานนี้ให้สถิติกิจกรรมเพลย์ลิสต์สําหรับรัฐในสหรัฐอเมริกาและเขตปกครองพิเศษโคลัมเบีย (D.C.) สําหรับรายงานนี้ คุณรวม country==US ในค่าพารามิเตอร์ filters

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

ตำแหน่งการเล่น

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ รายละเอียดของตําแหน่งการเล่นข้อมูลเชิงลึก
เมตริก:
ใช้อย่างน้อย 1 รายการ VIEWS, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, AverageTimeInPlaylist
ตัวกรอง:
ต้องใช้ isCuated==1;insightplayLocationType==EMBEDDED
ใช้ 0 หรือ 1 ประเทศ, จังหวัด, ทวีป ทวีปย่อย
ใช้ 0 หรือ 1 เพลย์ลิสต์ กลุ่ม
ไม่บังคับ subscribedStatus
ตัวเลือกการจัดเรียง -ยอดดู
-estimatedMinutesWatched
-playlistStarts

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

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

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

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ ข้อมูลเชิงลึกเกี่ยวกับแหล่งที่มาของการเข้าชม
เมตริก:
ใช้อย่างน้อย 1 รายการ VIEWS, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, AverageTimeInPlaylist
ตัวกรอง:
ต้องใช้ isCuated==1;insighttrafficSourceType
ใช้ 0 หรือ 1 ประเทศ, จังหวัด, ทวีป ทวีปย่อย
ใช้ 0 หรือ 1 เพลย์ลิสต์ กลุ่ม
ไม่บังคับ subscribedStatus
ตัวเลือกการจัดเรียง -ยอดดู
-estimatedMinutesWatched
-playlistStarts

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

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

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

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

เนื้อหา
มิติข้อมูล:
ต้องใช้ ประเภทอุปกรณ์
ใช้ 0 ขึ้นไป วัน, subscribedStatus, youtubeProduct
เมตริก:
ใช้อย่างน้อย 1 รายการ VIEWS, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, AverageTimeInPlaylist
ตัวกรอง:
ต้องใช้ isCuated==1
ใช้ 0 หรือ 1 ประเทศ, จังหวัด, ทวีป ทวีปย่อย
ใช้ 0 หรือ 1 เพลย์ลิสต์ กลุ่ม
ใช้ 0 ขึ้นไป operatingSystem, subscribedStatus, youtubeProduct

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

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

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

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

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

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

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

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

เช่น รายงานที่ใช้มิติข้อมูล subscribedStatus แสดงผล เปอร์เซ็นต์ผู้ดู เพิ่มขึ้น 100 เปอร์เซ็นต์สําหรับการดูที่ติดตาม และ{/64% ข้อมูล 0500-310 (ค่ารวมของช่อง viewerPercent ทั้งหมดในรายงานคือ 200 เปอร์เซ็นต์)

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

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

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

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

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

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

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

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

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

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

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

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