หน้านี้จะแสดงรายงานที่เจ้าของช่องสามารถเรียกดูได้ด้วย API ของ YouTube Analytics รายงานช่องจะแสดงเมตริกกิจกรรมของผู้ใช้สำหรับช่องที่ระบุและวัดผลข้อมูลต่างๆ เช่น ยอดดูวิดีโอ การให้คะแนน และจำนวนผู้ติดตาม
การดึงข้อมูลรายงาน
หากต้องการเรียกดูรายงานแชแนล คุณต้องตั้งค่าค่าพารามิเตอร์ 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
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ตารางประกอบด้วย 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 ขึ้นไป: คุณสามารถเลือกที่จะรวมค่าใดค่าหนึ่งหรือทุกค่าจากกลุ่ม
รายงานวิดีโอ
สถิติพื้นฐาน
สถิติกิจกรรมของผู้ใช้ขั้นพื้นฐาน
รายงานนี้ให้สถิติเกี่ยวกับการดำเนินการของผู้ใช้ในแชแนล คุณสามารถกรองรายงานให้แสดงเฉพาะข้อมูลสำหรับวิดีโอหรือประเทศที่เฉพาะเจาะจงเท่านั้น
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
สถิติกิจกรรมของผู้ใช้ขั้นพื้นฐานสำหรับรัฐในสหรัฐอเมริกา
รายงานนี้แสดงสถิติสำหรับรัฐในสหรัฐอเมริกาหรือดิสตริกต์ออฟโคลัมเบีย โปรดทราบว่ารายงานนี้สนับสนุนเฉพาะชุดย่อยของเมตริกที่มีอยู่ในรายงานเฉพาะประเทศซึ่งอธิบายไว้ข้างต้น
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ตามเวลา
กิจกรรมของผู้ใช้ตามประเทศในช่วงระยะเวลาหนึ่ง
รายงานนี้ให้สถิติเกี่ยวกับการดำเนินการของผู้ใช้ในช่องสำหรับช่วงเวลาที่ระบุ คุณสามารถกรองรายงานให้แสดงเฉพาะข้อมูลสำหรับวิดีโอหรือประเทศที่เฉพาะเจาะจงเท่านั้น
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
กิจกรรมของผู้ใช้ในรัฐต่างๆ ในสหรัฐอเมริกาในระยะเวลาที่เจาะจง
รายงานนี้จะแสดงสถิติเกี่ยวกับกิจกรรมของผู้ใช้สำหรับรัฐใดรัฐหนึ่งในสหรัฐอเมริกาหรือดิสตริกต์ออฟโคลัมเบีย โปรดทราบว่ารายงานนี้สนับสนุนเฉพาะชุดย่อยของเมตริกที่มีอยู่ในรายงานเฉพาะประเทศซึ่งอธิบายไว้ข้างต้น
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
พื้นที่ทางภูมิศาสตร์ของผู้ใช้
กิจกรรมของผู้ใช้ตามประเทศ
รายงานนี้จะแสดงสถิติเกี่ยวกับกิจกรรมของผู้ใช้แบบแยกตามประเทศสำหรับแชแนลหนึ่งๆ คุณสามารถกรองรายงานให้แสดงเฉพาะข้อมูลสำหรับวิดีโอที่เฉพาะเจาะจงได้
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
กิจกรรมของผู้ใช้ตามจังหวัด
รายงานนี้แสดงสถิติกิจกรรมของผู้ใช้สำหรับรัฐต่างๆ ในสหรัฐอเมริกาและดิสตริกต์ออฟโคลัมเบีย คุณต้องตั้งค่าพารามิเตอร์ filters
เป็น country==US
ในรายงานนี้
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
กิจกรรมของผู้ใช้ตามเมือง (ผลลัพธ์ <= 250 รายการ)
หมายเหตุ: รายงานนี้กำหนดให้คุณต้องตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 250
รายงานนี้ต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณจะต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
ด้วย
รายงานนี้แสดงสถิติกิจกรรมของผู้ใช้ตามเมือง
รายละเอียดการเล่น
รายงานรายละเอียดการเล่นจะแสดงสถิติที่เกี่ยวข้องกับแอตทริบิวต์การดูต่อไปนี้
ยอดดูของการออกอากาศวิดีโอสดหรือวิดีโอออนดีมานด์
ผู้ชมติดตามช่องที่เป็นเจ้าของวิดีโอไหม
ยอดดูนี้เกิดขึ้นบนผลิตภัณฑ์ใดของ YouTube
หมายเหตุ: มิติข้อมูลและตัวกรอง liveOrOnDemand ใช้ร่วมกับเมตริก averageViewPercentage ไม่ได้ ด้วยเหตุนี้ ส่วนย่อยแต่ละส่วนย่อยต่อไปนี้จึงแสดงรายงาน 2 ฉบับ รายงานหนึ่งรองรับมิติข้อมูล liveOrOnDemand (และตัวกรอง) ขณะที่อีกรายงานหนึ่งรองรับเมตริก averageViewPercentage
กิจกรรมของผู้ใช้ตามสถานะที่สมัครรับข้อมูล
รายงานนี้แสดงเมตริกกิจกรรมของผู้ใช้สำหรับผู้ดูที่ติดตามและไม่ได้เป็นสมาชิก โดยสามารถจัดกลุ่มสถิติตามระยะเวลา (วัน หรือเดือน ) และยังสามารถกรองรายงานตามประเทศ ทวีป หรือsubContinent ได้ด้วย
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
กิจกรรมของผู้ใช้ตามสถานะที่สมัครรับข้อมูลสำหรับจังหวัด
รายงานนี้แสดงเมตริกกิจกรรมของผู้ใช้สำหรับผู้ดูที่ติดตามและที่ไม่ได้ติดตามในรัฐต่างๆ ของสหรัฐฯ หรือดิสตริกต์ออฟโคลัมเบีย รายงานนี้รองรับเมตริกน้อยกว่ารายงานก่อนหน้า
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายละเอียดการเล่นพร้อมมิติข้อมูลเวลาที่ไม่บังคับ
มิติข้อมูลเวลา – วัน หรือเดือน เป็นตัวเลือกที่ไม่บังคับสําหรับรายงานเหล่านี้ เนื่องจาก ไม่ว่าคุณจะต้องใช้พารามิเตอร์คําขอ startDate
และ endDate
เพื่อระบุช่วงวันที่ที่รายงานจะครอบคลุมหรือไม่ มิติข้อมูล (หากมี) บ่งชี้ว่าคุณต้องการให้มีการรวบรวมข้อมูลในรายงานตามวัน เดือน ฯลฯ
รายละเอียดการเล่นพร้อมมิติข้อมูลเวลาที่ไม่บังคับและสถิติ liveOrOnDemand
รายงานนี้จะแสดงสถิติรายละเอียดการเล่นสำหรับช่วงเวลาที่ระบุ ซึ่งรองรับมิติข้อมูล liveOrOnDemand (และตัวกรอง)
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายละเอียดการเล่นพร้อมมิติข้อมูลเวลาที่ไม่บังคับและเมตริก averageViewPercentage
รายงานนี้จะแสดงสถิติรายละเอียดการเล่นสำหรับช่วงเวลาที่ระบุ รองรับเมตริก averageViewPercentage
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายละเอียดการเล่นตามประเทศ
รายละเอียดการเล่นตามประเทศพร้อมสถิติ liveOrOnDemand
รายงานนี้จะแสดงสถิติรายละเอียดการเล่นตามประเทศ ซึ่งรองรับมิติข้อมูล liveOrOnDemand (และตัวกรอง)
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายงานต่อไปนี้คล้ายกับรายงานก่อนหน้านี้ เพิ่มการรองรับเมตริก averageViewPercentage แต่ไม่รองรับ liveOrOnDemand เป็นมิติข้อมูลหรือตัวกรอง
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายละเอียดการเล่นตามจังหวัด
รายละเอียดการเล่นตามจังหวัดพร้อมด้วยสถิติ liveOrOnDemand
รายงานนี้แสดงรายละเอียดสถิติการเล่นสำหรับรัฐต่างๆ ของสหรัฐฯ และดิสตริกต์ออฟโคลัมเบีย ซึ่งรองรับมิติข้อมูล liveOrOnDemand (และตัวกรอง)
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายงานต่อไปนี้คล้ายกับรายงานก่อนหน้านี้ เพิ่มการรองรับเมตริก averageViewPercentage แต่ไม่รองรับ liveOrOnDemand เป็นมิติข้อมูลหรือตัวกรอง
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ตำแหน่งที่เล่น
รายงานตำแหน่งในการเล่นวิดีโอ
รายงานนี้แสดงสถิติเกี่ยวกับประเภทของหน้าเว็บหรือแอปพลิเคชันที่มีการเล่นวิดีโอ
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายละเอียดตำแหน่งที่เล่น (ผลลัพธ์ <= 25 รายการ)
หมายเหตุ: รายงานนี้กำหนดให้คุณต้องตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 25
รายงานนี้ต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณจะต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
ด้วย
รายงานนี้จะระบุโปรแกรมเล่นวิดีโอแบบฝังที่สร้างยอดดูหรือเวลาในการรับชมมากที่สุดสำหรับวิดีโอของช่อง
แหล่งที่มาของการเข้าชม
แหล่งที่มาของการเข้าชม
รายงานนี้จะแสดงสถิติการดูตามลักษณะที่ผู้ชมเข้าถึงเนื้อหาวิดีโอของคุณ เช่น การระบุจำนวนยอดดูที่เกิดจากการค้นหาของ Google หรือจากลิงก์ไปยังวิดีโอที่เกี่ยวข้อง
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายละเอียดแหล่งที่มาของการเข้าชม (<= ผลลัพธ์ 25 รายการ)
หมายเหตุ: รายงานนี้กำหนดให้คุณต้องตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 25
รายงานนี้ต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณจะต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
ด้วย
รายงานนี้จะแสดงสถิติการดูตาม URL ที่มาซึ่งสร้างยอดดูสูงสุดให้กับเนื้อหาของช่อง ผู้อ้างอิงจะได้รับการจัดหมวดหมู่ตามประเภทแหล่งที่มาของการเข้าชม และคำจำกัดความของมิติข้อมูล insightTrafficSourceDetail จะระบุแหล่งที่มาของการเข้าชมที่มีรายงาน ตัวอย่างเช่น หากคุณตั้งค่าตัวกรอง insightTrafficSourceType เป็น ADVERTISING
รายงานจะแสดงรายการประเภทโฆษณาที่ทำให้เกิดการดูหรือเวลาในการดูเนื้อหาของช่องมากที่สุด
หมายเหตุ: รายงานนี้รองรับเฉพาะแหล่งที่มาของการเข้าชมที่เฉพาะเจาะจงเท่านั้น ตัวอย่างเช่น แหล่งที่มาของการเข้าชม NO_LINK_EMBEDDED
ไม่มีรายละเอียดเพิ่มเติม จึงไม่รองรับรายงานนี้ ดูคําจํากัดความของ insightTrafficSourceType สําหรับรายละเอียดเกี่ยวกับแหล่งที่มาของการเข้าชมที่รองรับรายงานนี้
ประเภทอุปกรณ์และระบบปฏิบัติการ
ประเภทอุปกรณ์
รายงานนี้จะแสดงสถิติการดูตามลักษณะที่ผู้ชมเข้าถึงเนื้อหาวิดีโอของคุณ เช่น การระบุจำนวนการดูที่เกิดขึ้นบนอุปกรณ์เคลื่อนที่หรือคอนโซลเกม
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ระบบปฏิบัติการ
รายงานนี้รวบรวมสถิติการดูตามระบบปฏิบัติการของผู้ดู เช่น แอตทริบิวต์นี้ระบุยอดดูที่เกิดขึ้นในอุปกรณ์ Android หรือ PlayStation
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ระบบปฏิบัติการและประเภทอุปกรณ์
รายงานฉบับนี้จะรวบรวมสถิติการดูตามระบบปฏิบัติการและประเภทอุปกรณ์ของผู้ชม เช่น แอตทริบิวต์นี้จะระบุจำนวนการดูที่เกิดขึ้นในแท็บเล็ต Android หรือในอุปกรณ์เดสก์ท็อป Windows
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ข้อมูลประชากรผู้ชม
รายงานนี้รวบรวมสถิติการดูตามกลุ่มอายุและเพศของผู้ดู
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
การมีส่วนร่วมและการแชร์เนื้อหา
รายงานนี้จะแสดงสถิติที่แสดงความถี่ที่วิดีโอของช่องมีการแชร์บนแพลตฟอร์มโซเชียลต่างๆ
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
การคงผู้ชมไว้
รายงานนี้วัดความสามารถของวิดีโอในการรักษาผู้ชมเอาไว้ มิติข้อมูล elapsedVideoTimeRatio
จะวัดจำนวนวิดีโอที่ผ่านไปแล้วสำหรับค่าเมตริกที่เกี่ยวข้อง เมตริก audienceWatchRatio
และ relativeRetentionPerformance
เป็นการวัดผล 2 แบบที่แสดงให้เห็นว่าวิดีโอคงผู้ชมไว้ได้ดีเพียงใด ค่าแรกเป็นค่าสัมบูรณ์ ขณะที่ค่าที่สองจะแสดงประสิทธิภาพของวิดีโอเมื่อเทียบกับวิดีโอ YouTube อื่นๆ ที่มีความยาวใกล้เคียงกัน
หมายเหตุ: รายงานการคงผู้ชมไว้ไม่รองรับความสามารถในการระบุรายการค่าที่คั่นด้วยเครื่องหมายจุลภาคสำหรับตัวกรอง video
โดยค่าดังกล่าวจะต้องระบุรหัสวิดีโอเดียว
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
วิดีโอยอดนิยม
หมายเหตุ: รายงานเหล่านี้กำหนดให้คุณต้องตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 200
ข้อมูลก่อนวันที่ 1 มกราคม 2013 จะมีให้สำหรับวิดีโอยอดนิยม 10 อันดับแรกเท่านั้น รายงานเหล่านี้ต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณจะต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
ด้วย
วิดีโอยอดนิยมที่มีตัวกรองระดับภูมิภาคที่ไม่บังคับ (ผลลัพธ์ <= 200 รายการ)
รายงานนี้จะแสดงวิดีโอยอดนิยมของช่อง คุณกรองรายงานเพื่อแสดงวิดีโอยอดนิยมตามประเทศ ทวีป หรือsubContinent ได้
วิดีโอยอดนิยมตามรัฐ (ผลการค้นหา <= 200 รายการ)
รายงานนี้แสดงวิดีโอยอดนิยมของช่องในรัฐใดรัฐหนึ่งของสหรัฐอเมริกาหรือดิสตริกต์ออฟโคลัมเบีย โปรดทราบว่ารายงานนี้สนับสนุนเฉพาะชุดย่อยของเมตริกที่มีอยู่ในรายงานเฉพาะประเทศซึ่งอธิบายไว้ข้างต้น
วิดีโอยอดนิยมสำหรับผู้ชมที่ติดตามหรือไม่ติดตาม(ผลลัพธ์ <= 200 รายการ)
รายงานนี้แสดงวิดีโอยอดนิยมของช่องสำหรับผู้ดูที่ติดตามหรือเลิกติดตาม คุณกรองรายงานเพื่อแสดงวิดีโอยอดนิยมตามประเทศ ทวีป หรือsubContinent ได้ รายงานก่อนหน้าให้คุณเรียกดูวิดีโอยอดนิยมในรัฐหนึ่งๆ ของสหรัฐฯ สำหรับผู้ดูที่ติดตามหรือไม่ได้ติดตาม แต่รายงานดังกล่าวรองรับเมตริกน้อยกว่ารายงานนี้
วิดีโอยอดนิยมตามผลิตภัณฑ์ YouTube (ผลลัพธ์ <= 200 รายการ)
รายงานนี้แสดงรายการวิดีโอยอดนิยมของช่อง และรองรับรายละเอียดการเล่น รวมถึงตัวกรองตามภูมิศาสตร์ รายงานนี้คล้ายกับรายงานก่อนหน้านี้ แต่รองรับเมตริกน้อยกว่าและเพิ่มการรองรับตัวกรอง youtubeProduct
วิดีโอยอดนิยมที่มีตัวกรองรายละเอียดการเล่น (ผลลัพธ์ <= 200 รายการ)
รายงานนี้จะแสดงวิดีโอยอดนิยมของช่อง โดยกรองตามมิติข้อมูลรายละเอียดการเล่นทั้งหมดหรือ liveOrOnDemand , subscribedStatus และ youtubeProduct รายงานนี้รองรับตัวกรอง liveOrOnDemand และไม่รองรับเมตริก averageViewPercentage ซึ่งต่างจากรายงานก่อนหน้านี้
รายงานเพลย์ลิสต์
รายงานเพลย์ลิสต์มีเมตริกที่เกี่ยวข้องกับกิจกรรมของผู้ใช้ที่เกี่ยวข้องกับวิดีโอในเพลย์ลิสต์ของเจ้าของช่อง รายงานเหล่านี้มี 2 เวอร์ชัน และส่วนต่อไปนี้จะมีคำอธิบายของแต่ละเวอร์ชันสำหรับแต่ละเวอร์ชัน
แท็บแนะนำ ในแต่ละส่วนจะอธิบายรูปแบบคำขอ API ที่ต้องการสำหรับการเรียกดูรายงานที่เกี่ยวข้อง รายงานที่แนะนำจะรองรับชุดเมตริกเพิ่มเติม ซึ่งประกอบด้วยเมตริกวิดีโอทั้งหมด และเมตริกในเพลย์ลิสต์ รูปแบบคําขอนี้ไม่ได้ใช้มิติข้อมูล isCurated
แท็บการใช้ isCurated
ในแต่ละส่วนอธิบายรูปแบบคำขอ API เก่า ซึ่งต้องใช้มิติข้อมูล isCurated
รายงานเหล่านี้รองรับเมตริกในเพลย์ลิสต์ เท่านั้น โปรดทราบว่าเราเลิกใช้งานมิติข้อมูล isCurated
สำหรับรายงานทั้งหมดแล้ว หมายเหตุเกี่ยวกับคําเตือนด้านล่างจะอธิบายกําหนดการเลิกใช้งาน
หมายเหตุเกี่ยวกับคำเตือนต่อไปนี้จะอธิบายการเปลี่ยนแปลงระหว่างรายงานทั้ง 2 เวอร์ชันโดยละเอียด
สำคัญ: อัปเดตรายงานเพลย์ลิสต์สำหรับช่องก่อนวันที่ 30 มิถุนายน 2024 และอัปเดตรายงานเพลย์ลิสต์สำหรับเจ้าของเนื้อหาภายในวันที่ 31 ธันวาคม 2024 โปรดทราบการเปลี่ยนแปลงต่อไปนี้
เราเลิกใช้งานมิติข้อมูล isCurated
แล้ว
สำหรับรายงานแชแนล ระบบจะไม่รองรับมิติข้อมูลนี้อีกต่อไปตั้งแต่วันที่ 30 มิถุนายน 2024
สำหรับรายงานเจ้าของเนื้อหา ระบบจะไม่รองรับมิติข้อมูลนี้อีกต่อไปตั้งแต่วันที่ 31 ธันวาคม 2024 เป็นต้นไป
ลักษณะการทำงานของเมตริก views
จะเปลี่ยนแปลงเมื่อคุณนำมิติข้อมูล isCurated
ออกจากคำขอเพื่อเรียกข้อมูลรายงานเพลย์ลิสต์ ดังนี้
เมื่อคำขอมีมิติข้อมูล isCurated
เมตริก views
จะระบุจำนวนครั้งที่มีการดูวิดีโอในบริบทของเพลย์ลิสต์
เมื่อคำขอไม่ได้รวมมิติข้อมูล isCurated
เมตริก views
จะระบุจำนวนครั้งทั้งหมดที่มีการดูวิดีโอ ส่วนเมตริก playlistViews
จะแสดงจำนวนครั้งที่มีการดูวิดีโอในบริบทของเพลย์ลิสต์
ด้วยเหตุนี้ หากต้องการรักษาความเข้ากันได้แบบย้อนหลังเมื่อนำมิติข้อมูล isCurated
ออก คุณต้องอัปเดตโค้ดเพื่อเรียกข้อมูลเมตริก playlistViews
แทนเมตริก views
สำหรับรายงานเพลย์ลิสต์เท่านั้นด้วย เนื่องจากรายงานเพลย์ลิสต์ยังรองรับเมตริก views
แม้จะมีความหมายต่างกันก็ตาม API จะยังคงแสดงข้อมูลหากคุณไม่อัปเดตชื่อเมตริก แน่นอน คุณสามารถแก้ไขแอปพลิเคชันเพื่อเรียกและแสดงทั้ง views
และ playlistViews
ได้
ดูรายละเอียดเพิ่มเติมได้ที่ประวัติการแก้ไข
เมตริกวิดีโอทั้งหมด
เมตริกเหล่านี้แสดงกิจกรรมของผู้ใช้และเมตริกการแสดงผลที่รวบรวมไว้สำหรับวิดีโอทั้งหมดในเพลย์ลิสต์ที่ช่องที่เป็นเจ้าของเพลย์ลิสต์เป็นเจ้าของด้วย ระบบจะไม่คำนวณเมตริกสำหรับวิดีโอของช่องอื่นในการรวม ด้วยเหตุนี้ หากช่องสร้างเพลย์ลิสต์ที่มีเฉพาะวิดีโอของช่องอื่น รายงานสำหรับเพลย์ลิสต์เหล่านั้นจะไม่แสดงค่าสำหรับเมตริกเหล่านี้
ดูรายการเมตริกวิดีโอรวมที่ YouTube รองรับได้ในส่วนเมตริกของเพลย์ลิสต์ที่รองรับ
เมตริกในเพลย์ลิสต์
เมตริกเหล่านี้แสดงกิจกรรมของผู้ใช้และการมีส่วนร่วมในบริบทของหน้าเพลย์ลิสต์ เมตริกเหล่านี้รวมยอดดูของวิดีโอทั้งหมดในเพลย์ลิสต์ ไม่ว่าช่องจะเป็นเจ้าของวิดีโอใดก็ตาม แต่จะนับเฉพาะยอดดูที่เกิดขึ้นในบริบทของเพลย์ลิสต์เท่านั้น
เมตริกของเพลย์ลิสต์ที่รองรับ
สำคัญ: ตามที่แสดงในตารางด้านล่าง เมตริก views
ให้ข้อมูลประเภทต่างๆ ในรายงานเพลย์ลิสต์แต่ละเวอร์ชันที่มีอยู่ 2 เวอร์ชัน
ในรูปแบบรายงานที่แนะนํา views
คือเมตริกวิดีโอแบบรวม
ในรายงานที่ดึงข้อมูลโดยใช้มิติข้อมูล isCurated
views
เป็นเมตริกในเพลย์ลิสต์
สถิติพื้นฐาน
รายงานนี้แสดงสถิติเกี่ยวกับการโต้ตอบของผู้ใช้กับวิดีโอในเพลย์ลิสต์ของช่อง คุณกรองรายงานให้แสดงเฉพาะข้อมูลของเพลย์ลิสต์ที่เฉพาะเจาะจงได้
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ตามเวลา
รายงานนี้แสดงสถิติเกี่ยวกับการโต้ตอบของผู้ใช้กับวิดีโอในเพลย์ลิสต์ของช่อง คุณกรองรายงานให้แสดงเฉพาะข้อมูลของเพลย์ลิสต์ที่เฉพาะเจาะจงได้
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
พื้นที่ทางภูมิศาสตร์ของผู้ใช้
กิจกรรมเพลย์ลิสต์ตามประเทศ
รายงานนี้แสดงสถิติเกี่ยวกับการโต้ตอบที่ผู้ใช้ในประเทศหนึ่งๆ มีต่อวิดีโอในเพลย์ลิสต์ของช่อง
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
กิจกรรมเพลย์ลิสต์ตามจังหวัด
รายงานนี้แสดงสถิติกิจกรรมเกี่ยวกับเพลย์ลิสต์สำหรับรัฐในสหรัฐอเมริกาและดิสตริกต์ออฟโคลัมเบีย
คุณต้องกรองผลลัพธ์ให้แสดงเฉพาะข้อมูลสำหรับสหรัฐอเมริกาเท่านั้นสำหรับรายงานนี้
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ตำแหน่งที่เล่น
รายงานนี้แสดงสถิติเกี่ยวกับประเภทของหน้าเว็บหรือแอปพลิเคชันที่มีการเล่นวิดีโอเพลย์ลิสต์ของคุณ
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายละเอียดตำแหน่งที่เล่น (ผลลัพธ์ <= 25 รายการ)
หมายเหตุ: รายงานนี้กำหนดให้คุณต้องตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 25
รายงานนี้ต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณจะต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
ด้วย
รายงานนี้จะระบุโปรแกรมเล่นวิดีโอแบบฝังที่สร้างยอดดูหรือเวลาในการรับชมมากที่สุดสำหรับวิดีโอในเพลย์ลิสต์ของช่อง
แหล่งที่มาของการเข้าชม
รายงานนี้รวบรวมสถิติการดูตามวิธีที่ผู้ชมเข้าถึงเนื้อหาเพลย์ลิสต์ของคุณ
ตัวอย่างเช่น จะระบุจำนวนการดูที่เกิดจากการค้นหาของ Google
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
รายละเอียดแหล่งที่มาของการเข้าชม (<= ผลลัพธ์ 25 รายการ)
หมายเหตุ: รายงานนี้กำหนดให้คุณต้องตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 25
รายงานนี้ต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่ คุณต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
ด้วย
รายงานนี้จะแสดงสถิติการดู โดยอิงตาม URL ที่มาซึ่งสร้างยอดดูสูงสุดสำหรับวิดีโอในเพลย์ลิสต์ของช่อง ผู้อ้างอิงจะได้รับการจัดหมวดหมู่ตามประเภทแหล่งที่มาของการเข้าชม และคำจำกัดความของมิติข้อมูล insightTrafficSourceDetail จะระบุแหล่งที่มาของการเข้าชมที่มีรายงาน ตัวอย่างเช่น หากคุณตั้งค่าตัวกรอง insightTrafficSourceType เป็น ADVERTISING
รายงานจะแสดงรายการประเภทของโฆษณาที่สร้างยอดดูหรือเวลาในการรับชมมากที่สุดสำหรับเพลย์ลิสต์ของช่อง
หมายเหตุ: รายงานนี้รองรับเฉพาะแหล่งที่มาของการเข้าชมที่เฉพาะเจาะจงเท่านั้น ตัวอย่างเช่น แหล่งที่มาของการเข้าชม NO_LINK_EMBEDDED
ไม่มีรายละเอียดเพิ่มเติม จึงไม่รองรับรายงานนี้ ดูคําจํากัดความของ insightTrafficSourceType สําหรับรายละเอียดเกี่ยวกับแหล่งที่มาของการเข้าชมที่รองรับรายงานนี้
ประเภทอุปกรณ์และระบบปฏิบัติการ
ประเภทอุปกรณ์
รายงานนี้รวบรวมสถิติการดูตามวิธีที่ผู้ชมเข้าถึงวิดีโอในเพลย์ลิสต์ของคุณ เช่น การระบุจำนวนการดูที่เกิดขึ้นบนอุปกรณ์เคลื่อนที่หรือคอนโซลเกม
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ระบบปฏิบัติการ
รายงานนี้รวบรวมสถิติการดูตามระบบปฏิบัติการของผู้ดู เช่น แอตทริบิวต์นี้ระบุยอดดูที่เกิดขึ้นในอุปกรณ์ Android หรือ PlayStation
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ระบบปฏิบัติการและประเภทอุปกรณ์
รายงานฉบับนี้จะรวบรวมสถิติการดูตามระบบปฏิบัติการและประเภทอุปกรณ์ของผู้ชม
เช่น จะระบุจำนวนการดูที่เกิดขึ้นบนแท็บเล็ต Android หรืออุปกรณ์เดสก์ท็อป Windows
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
ข้อมูลประชากรผู้ชม
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง:
เพลย์ลิสต์ยอดนิยม
หมายเหตุ: รายงานเหล่านี้กำหนดให้คุณต้องตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 200
ก่อนวันที่ 1 มกราคม 2013 ข้อมูลของเพลย์ลิสต์ยอดนิยม 10 อันดับแรกเท่านั้น รายงานเหล่านี้ต่างจากรายงานอื่นๆ ส่วนใหญ่ตรงที่คุณจะต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
ด้วย
รายงานนี้แสดงเพลย์ลิสต์ยอดนิยมของช่องตามเกณฑ์การกรองและการจัดเรียงที่ระบุ
หมายเหตุ: รายงานประสิทธิภาพโฆษณาต้องมีโทเค็นการให้สิทธิ์ที่ให้สิทธิ์เข้าถึงขอบเขต https://www.googleapis.com/auth/yt-analytics-monetary.readonly
รายงานประสิทธิภาพของโฆษณาจะระบุเมตริกตามการแสดงผลสำหรับโฆษณาที่แสดงระหว่างการเล่นวิดีโอ เมตริกเหล่านี้จะพิจารณาสำหรับการแสดงโฆษณาแต่ละครั้ง และการเล่นวิดีโอแต่ละครั้งสามารถทำให้เกิดการแสดงผลหลายครั้ง
เมตริกประสิทธิภาพของโฆษณาตามการแสดงผลมีดังนี้
นอกจากนี้ รายงานวิดีโอ บางส่วนยังรองรับเมตริกประสิทธิภาพของโฆษณาตามการเล่นต่อไปนี้ด้วย อย่างไรก็ตาม เมตริกเหล่านี้จะไม่รวมอยู่ในรายงานประสิทธิภาพโฆษณา
เนื้อหา
มิติข้อมูล:
เมตริก:
ตัวกรอง: