เอกสารนี้จะระบุมิติข้อมูลที่ API ของ YouTube Analytics รองรับ API นี้สนับสนุนการค้นหาที่ตรงเป้าหมายแบบเรียลไทม์เพื่อสร้างรายงาน YouTube Analytics ที่กำหนดเอง
มิติข้อมูลคือเกณฑ์ทั่วไปที่ใช้ในการรวบรวมข้อมูล เช่น วันที่ที่มีกิจกรรมของผู้ใช้หรือประเทศที่ผู้ใช้อยู่
รายงานคำค้นหาแต่ละฉบับจะระบุมิติข้อมูลที่รองรับ ตัวอย่างเช่น เมื่อเรียกข้อมูลกิจกรรมของผู้ใช้ตามเวลา คุณจะเลือกระยะเวลาที่จะรายงานข้อมูล ได้แก่ วันหรือเดือน ในรายงานใดๆ ข้อมูลแต่ละแถวจะมีชุดค่าผสมของมิติข้อมูลที่ไม่ซ้ำกัน
หากต้องการดึงรายงานการค้นหา ให้เรียกใช้เมธอด reports.query
ของ YouTube Analytics API ในคำขอ ให้ใช้พารามิเตอร์ dimensions
เพื่อระบุมิติข้อมูลที่ YouTube จะใช้ในการคำนวณค่าเมตริกในรายงาน
มิติข้อมูลหลัก
แม้ว่า API ของ YouTube Analytics จะอยู่ภายใต้นโยบายการเลิกใช้งานที่ระบุไว้ในข้อกำหนดในการให้บริการ แต่มิติข้อมูลที่ไม่ใช่กลุ่มหลัก (และเมตริกที่ไม่ใช่กลุ่มหลัก) จะไม่อยู่ภายใต้นโยบาย ในคําจํากัดความในหน้านี้ จะมีการระบุมิติข้อมูลที่เป็นมิติข้อมูลหลักไว้อย่างชัดเจน
รายการต่อไปนี้ระบุมิติข้อมูลหลักของ API
ดูข้อมูลเพิ่มเติมได้ที่รายการ YouTube API ภายใต้นโยบายการเลิกใช้งาน
ฟิลเตอร์
รายงานคำค้นหาทั้งหมดรองรับตัวกรอง ตัวกรองระบุค่ามิติข้อมูลที่ต้องอยู่ในชุดข้อมูลที่ดึงมา ด้วยเหตุนี้จึงจำกัดการตอบกลับจาก API ให้รวมเฉพาะข้อมูลที่ตรงกับค่าหรือชุดค่าที่เฉพาะเจาะจงเท่านั้น เช่น คุณใช้ตัวกรองเพื่อเรียกดูเฉพาะข้อมูลของแต่ละประเทศได้ แทนที่จะดึงเมตริกกิจกรรมของผู้ใช้สําหรับทุกประเทศ
ในคำขอเพื่อเรียกข้อมูลรายงานการค้นหา พารามิเตอร์คำขอ filters
ที่ไม่บังคับจะระบุค่ามิติข้อมูลที่คุณต้องการกรองข้อมูล เช่น หากต้องการดึงข้อมูลเมตริกกิจกรรมของผู้ใช้สำหรับยุโรป คุณต้องตั้งค่าพารามิเตอร์ filters
เป็น continent==150
สำคัญ: คำขอ API เพื่อเรียกดูรายงานเจ้าของเนื้อหาต้องกรองข้อมูลโดยใช้มิติข้อมูลเอนทิตีการรายงานอย่างใดอย่างหนึ่งหรือใช้มิติข้อมูล claimedStatus
และ uploaderType
ร่วมกัน
ขนาด
ส่วนต่อไปนี้จะระบุมิติข้อมูลที่ใช้ในรายงานการค้นหาของ API ของ YouTube Analytics มิติข้อมูลเหล่านี้จะใช้ทั้งในรายงานช่องและเจ้าของเนื้อหา เว้นแต่จะระบุไว้เป็นอย่างอื่น มิติข้อมูลที่สามารถใช้เป็นตัวกรองเท่านั้นก็จะมีการระบุไว้ด้วย
แหล่งข้อมูล
มิติข้อมูลเหล่านี้สอดคล้องกับทรัพยากรที่ช่องและเจ้าของเนื้อหาจัดการบน YouTube
หมายเหตุ: API ให้คุณระบุค่าหลายค่าสำหรับมิติข้อมูล video
, playlist
และ channel
เมื่อใช้เป็นตัวกรอง ในการดำเนินการนี้ ให้ตั้งค่าพารามิเตอร์ filters
เป็นรายการที่คั่นด้วยคอมมาของวิดีโอ เพลย์ลิสต์ หรือรหัสช่องที่ควรกรองการตอบกลับจาก API ค่าพารามิเตอร์ระบุรหัสได้สูงสุด 500 รหัส
- วิดีโอ (มิติข้อมูลหลัก)
- รหัสของวิดีโอ YouTube ใน YouTube Data API ค่านี้คือค่าพร็อพเพอร์ตี้
id
ของทรัพยากรvideo
This is a core dimension and is subject to the Deprecation Policy. - เพลย์ลิสต์
- รหัสเพลย์ลิสต์ YouTube ใน YouTube Data API ค่านี้คือค่าพร็อพเพอร์ตี้
id
ของทรัพยากรplaylist
- channel (มิติข้อมูลหลัก) (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
- รหัสสำหรับช่อง YouTube ใน YouTube Data API ค่านี้คือค่าพร็อพเพอร์ตี้
id
ของทรัพยากรchannel
This is a core dimension and is subject to the Deprecation Policy.
มิติข้อมูลchannel
มักใช้ในรายงานของเจ้าของเนื้อหาเนื่องจากรายงานเหล่านั้นมักรวบรวมข้อมูลจากหลายช่อง - กลุ่ม (ตัวกรองเท่านั้น)
- รหัสของกลุ่ม YouTube Analytics คุณจะดึงค่านี้ได้โดยใช้เมธอด
groups.list
ของ YouTube Analytics API เมื่อคุณใช้ตัวกรองgroup
การตอบกลับจาก API จะมีข้อมูลสำหรับวิดีโอ เพลย์ลิสต์ หรือช่องทั้งหมดในกลุ่มนั้น
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลหรือตัวกรองเอนทิตีในการรายงาน
ตัวอย่างช่อง
-
สถิติพื้นฐาน
- 10 อันดับยอดนิยม – วิดีโอที่มีผู้ชมมากที่สุดของช่อง
- 10 อันดับยอดนิยม – อัตราการคลิกผ่านคำอธิบายประกอบสำหรับวิดีโอที่มีจำนวนการดูมากที่สุดของช่อง
- สถิติสำหรับเพลย์ลิสต์ที่เฉพาะเจาะจง
- 10 อันดับแรก – เพลย์ลิสต์ที่มีผู้ชมมากที่สุดของช่อง
-
ภูมิศาสตร์
- 10 อันดับยอดนิยม – วิดีโอที่มีคนดูมากที่สุดในประเทศใดประเทศหนึ่ง
- 10 อันดับแรก – วิดีโอที่มียอดดูมากที่สุดในยุโรป
-
สถิติพื้นฐาน
ตัวอย่างเจ้าของเนื้อหา
-
สถิติพื้นฐาน
- 10 อันดับยอดนิยม - วิดีโอที่มีคนดูมากที่สุดของเจ้าของเนื้อหา
- 10 อันดับยอดนิยม - วิดีโอที่มีคนดูมากที่สุดของเจ้าของเนื้อหา
- 10 อันดับยอดนิยม - วิดีโอที่มีคนดูมากที่สุดสำหรับช่องของเจ้าของเนื้อหา
- 10 อันดับยอดนิยม – อัตราการคลิกผ่านคำอธิบายประกอบสำหรับวิดีโอที่มีจำนวนการดูมากที่สุดของช่อง
- 10 อันดับแรก – เพลย์ลิสต์ที่มีการรับชมมากที่สุดของเจ้าของเนื้อหา
-
ภูมิศาสตร์
- 10 อันดับยอดนิยม - วิดีโอที่มีคนดูมากที่สุดในยุโรปสำหรับเจ้าของเนื้อหา
- 10 อันดับแรก – เพลย์ลิสต์ที่เริ่มต้นมากที่สุดในสหรัฐอเมริกา
-
สถิติพื้นฐาน
พื้นที่ทางภูมิศาสตร์
มิติข้อมูลเหล่านี้จะระบุพื้นที่ทางภูมิศาสตร์ที่เชื่อมโยงกับเมตริกกิจกรรมของผู้ใช้ ประสิทธิภาพโฆษณา หรือรายได้โดยประมาณ
- ประเทศ (มิติข้อมูลหลัก)
- ประเทศที่เชื่อมโยงกับเมตริกในแถวรายงาน ค่ามิติข้อมูลคือรหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 เช่น
US
,CN
(จีน) หรือFR
(ฝรั่งเศส) รหัสประเทศZZ
ใช้สำหรับรายงานเมตริกที่ YouTube ระบุประเทศที่เกี่ยวข้องไม่ได้ This is a core dimension and is subject to the Deprecation Policy. - province
- รัฐหรือเขตแดนของสหรัฐอเมริกาที่เชื่อมโยงกับเมตริกในแถวรายงาน ค่ามิติข้อมูลคือรหัส ISO 3166-2 ที่ระบุรัฐในสหรัฐอเมริกาหรือดิสตริกต์ออฟโคลัมเบีย เช่น
US-MI
(มิชิแกน) หรือUS-TX
(เท็กซัส) รหัสจังหวัดUS-ZZ
ใช้เพื่อรายงานเมตริกที่ YouTube ระบุรัฐที่เกี่ยวข้องของสหรัฐอเมริกาไม่ได้ เมื่อคำขอ API มีprovince
ในค่าพารามิเตอร์dimensions
คำขอจะต้องจำกัดข้อมูลไว้เฉพาะในสหรัฐอเมริกาเท่านั้น โดยใส่country==US
ในค่าพารามิเตอร์filters
หมายเหตุ: มิติข้อมูลนี้ไม่รองรับค่า ISO 3166-2 ที่ระบุพื้นที่รอบนอกของสหรัฐอเมริกา เนื่องจากเขตแดนเหล่านั้นมีรหัสประเทศตามมาตรฐาน ISO 3166-1 เป็นของตัวเองด้วย และยังไม่สนับสนุนการแยกย่อยในประเทศอื่นๆ ที่ไม่ใช่สหรัฐอเมริกาด้วย
- city
- เมืองโดยประมาณที่เชื่อมโยงกับเมตริกในแถวรายงาน ข้อมูลสำหรับมิติข้อมูลนี้มีตั้งแต่วันที่ 1 มกราคม 2022 เป็นต้นไป
- continent (ตัวกรองเท่านั้น)
-
รหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) API รองรับค่าต่อไปนี้
ค่า 002
แอฟริกา 019
อเมริกา (อเมริกาเหนือ ละตินอเมริกา อเมริกาใต้ และแคริบเบียน) 142
เอเชีย 150
ยุโรป 009
โอเชียเนีย filters
เป็นcontinent==REGION_CODE
โดยระบุค่าREGION_CODE
จากรายการด้านบน - subContinent (ตัวกรองเท่านั้น)
-
รหัสภูมิภาคทางสถิติของ UN ที่ระบุภูมิภาคย่อยทางภูมิศาสตร์ แผนกสถิติของสหประชาชาติจะแสดงรายชื่อภูมิภาคย่อยรวมถึงประเทศที่เชื่อมโยงกับแต่ละภูมิภาค
มิติข้อมูลนี้ใช้กรองข้อมูลได้เท่านั้น หากต้องการใช้มิติข้อมูลนี้ ให้ตั้งค่าของพารามิเตอร์
filters
เป็นsubContinent==REGION_CODE
โดยระบุค่าREGION_CODE
จากรายการ UN
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลหรือตัวกรองทางภูมิศาสตร์
ตัวอย่างช่อง
- สถิติพื้นฐาน: จำนวนการดูเฉพาะประเทศ (และอื่นๆ) สำหรับช่อง
-
ภูมิศาสตร์
- เมตริกเวลาในการรับชมเฉพาะประเทศสำหรับวิดีโอของช่อง
- เมตริกคำอธิบายประกอบเฉพาะประเทศสำหรับวิดีโอของช่อง
- เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี.
- เมตริกเวลาในการรับชมของแต่ละประเทศสำหรับเพลย์ลิสต์ของช่อง
- 10 อันดับแรก – เพลย์ลิสต์ที่เริ่มต้นมากที่สุดในสหรัฐอเมริกา
- ตำแหน่งที่เล่น: ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นต่างๆ
- แหล่งที่มาของการเข้าชม: ยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
- ข้อมูลประชากร: ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
-
วิดีโอยอดนิยม
- 10 อันดับยอดนิยม – วิดีโอที่มีคนดูมากที่สุดในประเทศใดประเทศหนึ่ง
- 10 อันดับแรก – วิดีโอที่มียอดดูมากที่สุดในยุโรป
ตัวอย่างเจ้าของเนื้อหา
- สถิติพื้นฐาน: จำนวนการดูเฉพาะประเทศ (และอื่นๆ) สำหรับวิดีโอทั้งหมดที่อัปโหลดด้วยตนเอง
-
ภูมิศาสตร์
- เมตริกเวลาในการรับชมของแต่ละประเทศสำหรับเนื้อหาที่อัปโหลดด้วยตนเอง
- เมตริกคำอธิบายประกอบเฉพาะประเทศสำหรับเนื้อหาที่อัปโหลดด้วยตนเอง
- เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี.
- เมตริกเวลาในการรับชมเฉพาะประเทศสำหรับเพลย์ลิสต์ของเจ้าของเนื้อหา
- 10 อันดับแรก – เพลย์ลิสต์ที่เริ่มต้นมากที่สุดในสหรัฐอเมริกา
- ตำแหน่งที่เล่น: ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นต่างๆ
- ข้อมูลประชากร: ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
- วิดีโอยอดนิยม: 10 อันดับแรก – วิดีโอที่มีคนดูมากที่สุดในยุโรปสำหรับเจ้าของเนื้อหา
- รายได้/ประสิทธิภาพโฆษณา: เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ
ระยะเวลา
มิติข้อมูลเหล่านี้ระบุว่ารายงานควรรวบรวมข้อมูลตามช่วงเวลา เช่น วัน สัปดาห์ หรือเดือน พารามิเตอร์คำขอ startDate
และ endDate
จะระบุระยะเวลาที่รายงานมีข้อมูล โปรดทราบว่าจริงๆ แล้ว รายงานจะแสดงข้อมูลจนถึงวันสุดท้ายซึ่งมีเมตริกทั้งหมดที่ระบุในคำขอนั้น ณ เวลาที่ทำการค้นหา ในรายงาน วันที่จะแสดงในรูปแบบ YYYY-MM-DD
สำคัญ: วันที่ทั้งหมดหมายถึงระยะเวลาที่เริ่มต้นจากเวลา 00:00 น. เวลาแปซิฟิก (UTC-7 หรือ UTC-8) และสิ้นสุดเวลา 23:59 น. ตามเวลาแปซิฟิกในวันที่ เดือน และปีที่ระบุ วันที่ที่นาฬิกาจะปรับไปข้างหน้าสำหรับเวลาออมแสงหมายถึงช่วงเวลา 23 ชั่วโมง และวันที่ที่มีการปรับนาฬิกาย้อนหลังจะหมายถึงระยะเวลา 25 ชั่วโมง
มิติข้อมูลเดือนหมายถึงระยะเวลาที่เริ่มตั้งแต่เวลา 00:00 น. ตามเวลาแปซิฟิก (UTC-7 หรือ UTC-8) ในวันแรกของเดือนและปีที่ระบุ
- วัน (มิติข้อมูลหลัก)
- เมื่อคุณใช้มิติข้อมูลนี้ ระบบจะรวบรวมข้อมูลในรายงานแบบรายวัน โดยแต่ละแถวจะมีข้อมูลสำหรับ 1 วัน คุณใช้มิติข้อมูลอื่นๆ เพื่อแบ่งย่อยข้อมูลให้ละเอียดยิ่งขึ้นได้ ตัวอย่างเช่น รายงานแหล่งที่มาของการเข้าชมสามารถรวบรวมสถิติการเข้าชมรายวันตามลักษณะที่ผู้ใช้เข้าถึงวิดีโอของคุณ This is a core dimension and is subject to the Deprecation Policy.
- เดือน (มิติข้อมูลหลัก)
- ข้อมูลในรายงานจะรวบรวมตามเดือนปฏิทิน เช่นเดียวกับรายงานรายวัน คุณสามารถใช้ตัวกรองอื่นๆ เพื่อแบ่งกลุ่มข้อมูลให้ละเอียดยิ่งขึ้นได้ ในรายงาน วันที่จะแสดงในรูปแบบ
YYYY-MM
หมายเหตุ: หากการค้นหา API ใช้มิติข้อมูลmonth
พารามิเตอร์start-date
และend-date
ต้องตั้งค่าเป็นวันแรกของเดือน This is a core dimension and is subject to the Deprecation Policy.
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลหรือตัวกรองชั่วคราว
ตัวอย่างช่อง
-
ตามเวลา
- เมตริกเวลาในการรับชมรายวันสำหรับวิดีโอของช่อง
- เมตริกคำอธิบายประกอบรายวันสำหรับวิดีโอของช่อง
- ยอดดูของเพลย์ลิสต์รายวันของช่อง
- ตำแหน่งที่เล่น: ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นต่างๆ
- แหล่งที่มาของการเข้าชม: ยอดดูและเวลาในการรับชมรายวันจากแหล่งที่มาของการเข้าชมต่างๆ
-
อุปกรณ์/ระบบปฏิบัติการ
- เมตริกประเภทอุปกรณ์รายวันสำหรับระบบปฏิบัติการ Android
- เมตริกระบบปฏิบัติการรายวันสำหรับอุปกรณ์เคลื่อนที่
- เมตริกประเภทอุปกรณ์และระบบปฏิบัติการรายวัน
-
ตามเวลา
ตัวอย่างเจ้าของเนื้อหา
-
ตามเวลา
- เมตริกเวลาในการรับชมรายวันสำหรับเนื้อหาที่อัปโหลดด้วยตนเอง
- เมตริกคำอธิบายประกอบสำหรับเนื้อหาที่อ้างสิทธิ์
- ยอดดูของเพลย์ลิสต์รายวันของเจ้าของเนื้อหา
- ตำแหน่งที่เล่น: ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นต่างๆ
- แหล่งที่มาของการเข้าชม: ยอดดูและเวลาในการรับชมรายวันจากแหล่งที่มาของการเข้าชมต่างๆ
-
อุปกรณ์/ระบบปฏิบัติการ
- เมตริกประเภทอุปกรณ์รายวันสำหรับวิดีโอที่อ้างสิทธิ์
- เมตริกระบบปฏิบัติการรายวันสำหรับวิดีโอที่อ้างสิทธิ์ซึ่งดูบนอุปกรณ์เคลื่อนที่
- เมตริกประเภทอุปกรณ์และระบบปฏิบัติการรายวัน
- รายได้/ประสิทธิภาพโฆษณา: เมตริกรายได้และประสิทธิภาพโฆษณารายวัน
-
ตามเวลา
ตำแหน่งที่เล่น
มิติข้อมูลเหล่านี้ให้ข้อมูลเชิงลึกเกี่ยวกับหน้าเว็บหรือแอปพลิเคชันที่มีกิจกรรมของผู้ใช้
- insightPlaybackLocationType
-
ระบบจะรวบรวมข้อมูลในรายงานตามประเภทของหน้าเว็บหรือแอปพลิเคชันที่มีการเล่นวิดีโอ ค่าที่เป็นไปได้สําหรับมิติข้อมูลนี้คือ
-
BROWSE
– ข้อมูลนี้อธิบายถึงการดูที่เกิดขึ้นบนหน้าแรกหรือหน้าจอหลักของ YouTube, ในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การเรียกดูอื่นๆ ของ YouTube -
CHANNEL
– ข้อมูลนี้อธิบายยอดดูที่เกิดขึ้นในหน้าช่อง -
EMBEDDED
– ข้อมูลนี้อธิบายถึงการดูที่เกิดขึ้นในเว็บไซต์หรือแอปพลิเคชันอื่นที่มีการฝังวิดีโอโดยใช้การฝัง<iframe>
หรือ<object>
-
EXTERNAL_APP
– ข้อมูลนี้อธิบายยอดดูที่เกิดขึ้นในแอปพลิเคชันของบุคคลที่สามที่มีการเล่นวิดีโอด้วยวิธีการอื่นที่ไม่ใช่การฝัง<iframe>
หรือ<object>
เช่น การเล่นในแอปพลิเคชันที่ใช้ YouTube Android Player API จะจัดหมวดหมู่โดยใช้ค่านี้ -
MOBILE
– ข้อมูลอธิบายยอดดูที่เกิดขึ้นบนเว็บไซต์ YouTube บนอุปกรณ์เคลื่อนที่หรือไคลเอ็นต์ YouTube API ที่ได้รับอนุมัติ รวมถึงอุปกรณ์เคลื่อนที่ตั้งแต่วันที่ 10 กันยายน 2013 เป็นต้นไป การเล่นไม่ได้ถูกจัดหมวดหมู่เป็นการเล่น
MOBILE
ในรายงาน YouTube Analytics อีกต่อไป ค่าอาจยังคงอยู่ในรายงานเนื่องจากข้อมูลเดิมยังอยู่ในหมวดหมู่ดังกล่าว แต่หลังจากวันที่ดังกล่าว การเล่นบนอุปกรณ์เคลื่อนที่จะถูกจัดประเภทเป็นการเล่นWATCH
,EMBEDDED
หรือEXTERNAL_APP
โดยขึ้นอยู่กับประเภทของแอปพลิเคชันที่จะเล่น -
SEARCH
– ข้อมูลนี้อธิบายยอดดูที่เกิดขึ้นในหน้าผลการค้นหาของ YouTube โดยตรง -
WATCH
– ข้อมูลนี้อธิบายถึงยอดดูที่เกิดขึ้นในหน้าสำหรับดูของวิดีโอ YouTube หรือในแอปพลิเคชันอย่างเป็นทางการของ YouTube เช่น แอป YouTube สำหรับ Android -
YT_OTHER
– ข้อมูลนี้อธิบายข้อมูลพร็อพเพอร์ตี้ที่ไม่ได้รับการจำแนกเป็นอย่างอื่น
-
- insightPlaybackLocationDetail
- ระบบจะรวบรวมข้อมูลตามหน้าที่โปรแกรมเล่นอยู่ โปรดทราบว่ารายงานนี้สนับสนุนเฉพาะการดูที่เกิดขึ้นในโปรแกรมเล่นแบบฝังเท่านั้น และระบุโปรแกรมเล่นแบบฝังที่ทำให้เกิดการดูมากที่สุดสำหรับวิดีโอที่ระบุ ดังนั้น จะให้มุมมองที่ละเอียดกว่ารายงานตำแหน่งที่เล่น ด้วยการระบุ URL หรือแอปพลิเคชันที่เชื่อมโยงกับโปรแกรมเล่นแบบฝังยอดนิยม
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลตำแหน่งที่เล่น
ตัวอย่างช่อง
-
ตำแหน่งที่เล่น
- จำนวนการดูและเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
- ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกันไป
- 10 อันดับยอดนิยม – ไซต์บุคคลที่สามที่สร้างการดูวิดีโอแบบฝังมากที่สุด
- ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
- ยอดดูเพลย์ลิสต์และเวลาในการรับชมรายวันจากตำแหน่งที่เล่นต่างกัน
-
ตำแหน่งที่เล่น
ตัวอย่างเจ้าของเนื้อหา
-
ตำแหน่งที่เล่น
- จำนวนการดูและเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
- ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกันไป
- 10 อันดับยอดนิยม – ไซต์บุคคลที่สามที่สร้างการดูวิดีโอแบบฝังมากที่สุด
- ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
- ยอดดูเพลย์ลิสต์และเวลาในการรับชมรายวันจากตำแหน่งที่เล่นต่างกัน
-
ตำแหน่งที่เล่น
รายละเอียดการเล่น
- creatorContentType
- มิติข้อมูลนี้จะระบุประเภทเนื้อหาที่เชื่อมโยงกับเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูล ข้อมูลสำหรับมิติข้อมูลนี้พร้อมให้ใช้งานตั้งแต่วันที่ 1 มกราคม 2019 เป็นต้นไป
ตารางต่อไปนี้ระบุค่ามิติข้อมูล
ค่า LIVE_STREAM
เนื้อหาที่ดูเป็นสตรีมแบบสดบน YouTube SHORTS
เนื้อหาที่ดูคือ YouTube Shorts STORY
เนื้อหาที่ดูคือสตอรี่ YouTube VIDEO_ON_DEMAND
เนื้อหาที่ดูเป็นวิดีโอ YouTube ที่ไม่ได้อยู่ภายใต้ค่ามิติข้อมูลอื่นๆ ค่าใดค่าหนึ่ง UNSPECIFIED
ไม่ทราบประเภทเนื้อหาของเนื้อหาที่ดู - liveOrOnDemand
- มิติข้อมูลนี้จะระบุว่าเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูลเชื่อมโยงกับการดูการถ่ายทอดสดหรือไม่ ข้อมูลสำหรับมิติข้อมูลนี้ใช้ได้ตั้งแต่วันที่ 1 เมษายน 2014
ตารางต่อไปนี้ระบุค่ามิติข้อมูล
ค่า LIVE
ข้อมูลของแถวจะอธิบายกิจกรรมของผู้ใช้ที่เกิดขึ้นระหว่างการถ่ายทอดสด ON_DEMAND
ข้อมูลของแถวจะอธิบายกิจกรรมของผู้ใช้ที่ไม่ได้เกิดขึ้นระหว่างการถ่ายทอดสด - subscribedStatus
- มิติข้อมูลนี้จะระบุว่าเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูลเชื่อมโยงกับผู้ชมที่ติดตามช่องของวิดีโอหรือเพลย์ลิสต์หรือไม่
ค่าที่เป็นไปได้คือ
SUBSCRIBED
และUNSUBSCRIBED
โปรดทราบว่าค่ามิติข้อมูลจะถูกต้อง ณ เวลาที่เกิดกิจกรรมของผู้ใช้ ตัวอย่างเช่น สมมติว่าผู้ใช้ไม่ได้ติดตามช่อง และดูวิดีโอหนึ่งของช่อง จากนั้นสมัครสมาชิกช่องและดูวิดีโออื่น ทั้งหมดนี้ในวันเดียวกัน รายงานของแชแนลระบุว่าข้อมูลพร็อพเพอร์ตี้ 1 รายการมีค่าsubscribedStatus
เป็นSUBSCRIBED
และข้อมูลพร็อพเพอร์ตี้ 1 รายการมีค่าsubscribedStatus
เป็นUNSUBSCRIBED
- youtubeProduct
- มิติข้อมูลนี้ระบุบริการของ YouTube ที่เกิดกิจกรรมของผู้ใช้ ข้อมูลสำหรับมิติข้อมูลนี้ใช้ได้ตั้งแต่วันที่ 18 กรกฎาคม 2015
ตารางต่อไปนี้ระบุค่ามิติข้อมูล
ค่า CORE
กิจกรรมของผู้ใช้ที่ไม่ได้เกิดขึ้นในแอปพลิเคชัน YouTube แบบพิเศษ (YouTube Gaming, YouTube Kids หรือ YouTube Music) ข้อยกเว้น: กิจกรรมของผู้ใช้ที่เกิดขึ้นใน YouTube Music ก่อนวันที่ 1 มีนาคม 2021 จะรวมอยู่ใน CORE
GAMING
กิจกรรมของผู้ใช้เกิดขึ้นใน YouTube Gaming KIDS
กิจกรรมของผู้ใช้เกิดขึ้นใน YouTube Kids MUSIC
กิจกรรมของผู้ใช้เกิดขึ้นใน YouTube Music ตั้งแต่วันที่ 1 มีนาคม 2021 เป็นต้นไป ข้อมูลก่อนวันที่ 1 มีนาคม 2021 จะรวมอยู่ใน CORE
จะไม่มีการบันทึกข้อมูลแบบเรียลไทม์UNKNOWN
กิจกรรมของผู้ใช้เกิดขึ้นก่อนวันที่ 18 กรกฎาคม 2015
แหล่งที่มาของการเข้าชม
- insightTrafficSourceType
- ข้อมูลในรายงานนี้จะรวบรวมตามประเภท URL ที่มา ซึ่งอธิบายถึงลักษณะที่ผู้ใช้เข้าถึงวิดีโอ ค่าที่เป็นไปได้สําหรับมิติข้อมูลนี้ ได้แก่
ADVERTISING
– โฆษณาอ้างถึงผู้ชมในวิดีโอ หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุประเภทโฆษณาANNOTATION
– ผู้ชมเข้าถึงวิดีโอโดยคลิกที่คำอธิบายประกอบในวิดีโออื่นCAMPAIGN_CARD
– ยอดดูที่มาจากวิดีโอที่ผู้ใช้อัปโหลดซึ่งมีการอ้างสิทธิ์ ซึ่งเจ้าของเนื้อหาใช้เพื่อโปรโมตเนื้อหาที่มีคนดู แหล่งที่มาของการเข้าชมนี้ใช้ได้กับรายงานเจ้าของเนื้อหาเท่านั้นEND_SCREEN
– ยอดดูมาจาก End Screen ของวิดีโออื่นEXT_URL
– ยอดดูวิดีโอมาจากลิงก์ในเว็บไซต์อื่น หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุหน้าเว็บ แหล่งที่มาของการเข้าชมนี้รวมการอ้างอิงจากผลการค้นหาของ GoogleHASHTAGS
- ยอดดูที่มาจากหน้าแฮชแท็ก VOD หรือหน้า Pivot Page ของแฮชแท็ก ShortsLIVE_REDIRECT
- ยอดดูวิดีโอมาจากการส่งผู้ชมแบบสดNO_LINK_EMBEDDED
– วิดีโอฝังอยู่ในเว็บไซต์อื่นเมื่อมีการดูวิดีโอNO_LINK_OTHER
– YouTube ไม่ได้ระบุ URL ที่มาสำหรับการเข้าชม หมวดหมู่นี้ครอบคลุมการเข้าชมวิดีโอโดยตรง ตลอดจนการเข้าชมแอปบนอุปกรณ์เคลื่อนที่NOTIFICATION
– ยอดดูวิดีโอมาจากอีเมลหรือการแจ้งเตือนจาก YouTubePLAYLIST
– ยอดดูวิดีโอเกิดขึ้นขณะที่วิดีโอกำลังเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์ ซึ่งรวมถึงการเข้าชมที่มาจากหน้าเพลย์ลิสต์PRODUCT_PAGE
- ยอดดูวิดีโอมาจากหน้าผลิตภัณฑ์PROMOTED
– จำนวนการดูวิดีโอมาจากการโปรโมตบน YouTube แบบไม่ชำระเงิน เช่น หน้า "วิดีโอที่น่าสนใจ" ของ YouTubeRELATED_VIDEO
– ยอดดูวิดีโอมาจากข้อมูลวิดีโอที่เกี่ยวข้องในหน้าดูวิดีโออื่น หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุรหัสวิดีโอสำหรับวิดีโอนั้นSHORTS
– แนะนำผู้ชมโดยการปัดในแนวตั้งจากวิดีโอก่อนหน้าในประสบการณ์การรับชม ShortsSOUND_PAGE
คือยอดดูที่มาจากหน้า Pivot Page ของเสียงสำหรับ ShortsSUBSCRIBER
– ยอดดูวิดีโอมาจากฟีดในหน้าแรกของ YouTube หรือจากฟีเจอร์การติดตามของ YouTube หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุรายการฟีดหน้าแรกหรือหน้าอื่นๆ ที่มีการอ้างอิงข้อมูลพร็อพเพอร์ตี้YT_CHANNEL
– ยอดดูวิดีโอเกิดขึ้นในหน้าช่อง หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุรหัสแชแนลของแชแนลนั้นYT_OTHER_PAGE
– ยอดดูวิดีโอมาจากลิงก์อื่นที่ไม่ใช่ผลการค้นหาหรือลิงก์วิดีโอที่เกี่ยวข้องซึ่งปรากฏบนหน้า YouTube หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุหน้าเว็บYT_SEARCH
– ยอดดูวิดีโอมาจากผลการค้นหาของ YouTube หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุข้อความค้นหาVIDEO_REMIXES
– ยอดดูวิดีโอมาจากลิงก์วิดีโอรีมิกซ์ในโปรแกรมเล่น Shorts หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุวิดีโอที่อ้างอิงผู้ชม
- insightTrafficSourceDetail
- ข้อมูลในรายงานนี้จะรวบรวมโดยอิงจาก URL ที่มาซึ่งสร้างยอดดูสูงสุดสำหรับวิดีโอที่เฉพาะเจาะจงและประเภทแหล่งที่มาของการเข้าชมที่ระบุ รายการต่อไปนี้ระบุแหล่งที่มาของการเข้าชมที่สามารถใช้รายงานนี้ได้ สำหรับแหล่งที่มาของการเข้าชมแต่ละแห่ง รายการจะระบุข้อมูลที่มิติข้อมูล
insightTrafficSourceDetail
มีให้ADVERTISING
– ประเภทของโฆษณาที่นำไปสู่ยอดดู ค่าที่เป็นไปได้มีดังนี้- โฆษณาเพื่อการมีส่วนร่วมแบบคลิกเพื่อเล่น
- โฆษณาเพื่อการมีส่วนร่วม
- โฆษณา Google Search
- วิดีโอโฆษณาบนหน้าแรก
- โฆษณาในสตรีมแบบข้ามได้ที่จองไว้
- TrueView แบบในผลการค้นหาและแบบบนหน้าจอ
- TrueView ในสตรีม
- การโฆษณาบน YouTube ที่ไม่จัดอยู่ในหมวดหมู่ใดๆ
- แผงวิดีโอ
CAMPAIGN_CARD
คือวิดีโอที่อ้างสิทธิ์ซึ่งนำผู้ชมไปยังวิดีโอที่ระบุไว้ในรายงานEND_SCREEN
– วิดีโอที่นำผู้ชมไปยังวิดีโอที่ระบุไว้ในรายงานEXT_URL
– เว็บไซต์ที่อ้างอิงผู้ชมไปยังวิดีโอHASHTAGS
– แฮชแท็กที่นำไปสู่ยอดดูNOTIFICATION
– อีเมลหรือการแจ้งเตือนที่อ้างอิงการเข้าชมRELATED_VIDEO
คือวิดีโอที่เกี่ยวข้องซึ่งนำผู้ชมไปยังวิดีโอที่กล่าวถึงในรายงานSOUND_PAGE
– วิดีโอที่นำไปสู่ยอดดูSUBSCRIBER
คือรายการในฟีดหน้าแรกหรือฟีเจอร์การสมัครใช้บริการของ YouTube ที่นำผู้ชมไปยังวิดีโอที่กล่าวถึงในรายงาน ค่าที่ใช้ได้มีดังนี้activity
– ยอดดูจากรายการในฟีดการติดตามหน้าแรกที่มาจากกิจกรรมช่องที่ไม่ใช่การอัปโหลดและไม่ใช่โซเชียล รวมถึงการชอบ รายการโปรด โพสต์กระดานข่าวสาร และการเพิ่มเพลย์ลิสต์blogged
– ยอดดูจากรายการในฟีดการติดตามหน้าแรกที่มาจากลิงก์จากบล็อกยอดนิยมmychannel
– ยอดดูจากรายการในฟีดอื่นๆ ที่แสดงบนหน้าแรก เช่น "ชอบ" "ประวัติการดู" และ "ดูภายหลัง"podcasts
– ยอดดูที่มาจากรายการในหน้าปลายทางของพอดแคสต์sdig
– ยอดดูที่มาจากอีเมลอัปเดตการติดตามuploaded
– ยอดดูจากรายการuploaded
ในฟีดการติดตามหน้าแรก/
– ยอดดูอื่นๆ ที่มาจากหน้าแรกของ YouTube/my_subscriptions
– ยอดดูที่มาจากหน้าการสมัครใช้บริการของฉันของผู้ใช้บน YouTube
YT_CHANNEL
– หน้าช่องที่ผู้ชมดูวิดีโอYT_OTHER_PAGE
– หน้า YouTube ที่ระบบใช้อ้างอิงผู้ชมของวิดีโอYT_SEARCH
– ข้อความค้นหาที่นำผู้ชมไปยังวิดีโอVIDEO_REMIXES
– วิดีโอที่นำไปสู่ยอดดู
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลแหล่งที่มาของการเข้าชม
ตัวอย่างช่อง
-
แหล่งที่มาของการเข้าชม
- จำนวนการดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
- ยอดดูรายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
- 10 อันดับยอดนิยม – ข้อความค้นหาบน YouTube ที่สร้างการเข้าชมวิดีโอมากที่สุด
- 10 อันดับยอดนิยม – ข้อความค้นหาใน Google ที่สร้างการเข้าชมวิดีโอมากที่สุด
- ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
- ยอดดูเพลย์ลิสต์และเวลาในการรับชมรายวันจากแหล่งที่มาของการเข้าชมต่างๆ
-
แหล่งที่มาของการเข้าชม
ตัวอย่างเจ้าของเนื้อหา
-
แหล่งที่มาของการเข้าชม
- ยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
- ยอดดูรายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
- 10 อันดับยอดนิยม – ข้อความค้นหาบน YouTube ที่สร้างการเข้าชมวิดีโอมากที่สุด
- 10 อันดับยอดนิยม – ข้อความค้นหาใน Google ที่สร้างการเข้าชมวิดีโอมากที่สุด
- ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
- ยอดดูเพลย์ลิสต์และเวลาในการรับชมรายวันจากแหล่งที่มาของการเข้าชมต่างๆ
-
แหล่งที่มาของการเข้าชม
อุปกรณ์
- deviceType
- มิติข้อมูลนี้จะระบุรูปแบบของอุปกรณ์ทางกายภาพของอุปกรณ์ที่เกิดการดู
รายการต่อไปนี้ระบุประเภทอุปกรณ์ที่ API แสดงผลข้อมูล คุณยังใช้มิติข้อมูล
deviceType
เป็นตัวกรองเพื่อจำกัดรายงานระบบปฏิบัติการให้มีเฉพาะข้อมูลของอุปกรณ์บางประเภทได้อีกด้วยDESKTOP
GAME_CONSOLE
MOBILE
TABLET
TV
UNKNOWN_PLATFORM
- operatingSystem
- มิติข้อมูลนี้ระบุระบบซอฟต์แวร์ของอุปกรณ์ที่เกิดการดู
รายการต่อไปนี้ระบุระบบปฏิบัติการที่ API แสดงผลข้อมูล คุณยังใช้
operatingSystem
เป็นตัวกรองเพื่อจำกัดรายงานประเภทอุปกรณ์ให้มีเฉพาะข้อมูลสำหรับระบบปฏิบัติการที่เฉพาะเจาะจงได้ด้วยANDROID
BADA
BLACKBERRY
CHROMECAST
DOCOMO
FIREFOX
HIPTOP
IOS
KAIOS
LINUX
MACINTOSH
MEEGO
NINTENDO_3DS
OTHER
PLAYSTATION
PLAYSTATION_VITA
REALMEDIA
SMART_TV
SYMBIAN
TIZEN
VIDAA
WEBOS
WII
WINDOWS
WINDOWS_MOBILE
XBOX
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลอุปกรณ์
ตัวอย่างช่อง
-
อุปกรณ์/ระบบปฏิบัติการ
- เมตริกประเภทอุปกรณ์รายวันสำหรับระบบปฏิบัติการ Android
- เมตริกระบบปฏิบัติการรายวันสำหรับอุปกรณ์เคลื่อนที่
- เมตริกประเภทอุปกรณ์และระบบปฏิบัติการรายวัน
- เมตริกประเภทอุปกรณ์รายวันสำหรับยอดดูเพลย์ลิสต์บนระบบปฏิบัติการ Android
- เมตริกระบบปฏิบัติการรายวันสำหรับยอดดูเพลย์ลิสต์บนอุปกรณ์เคลื่อนที่
-
อุปกรณ์/ระบบปฏิบัติการ
ตัวอย่างเจ้าของเนื้อหา
-
อุปกรณ์/ระบบปฏิบัติการ
- เมตริกประเภทอุปกรณ์รายวันสำหรับวิดีโอที่อ้างสิทธิ์
- เมตริกระบบปฏิบัติการรายวันสำหรับวิดีโอที่อ้างสิทธิ์ซึ่งดูบนอุปกรณ์เคลื่อนที่
- เมตริกประเภทอุปกรณ์และระบบปฏิบัติการรายวัน
- เมตริกประเภทอุปกรณ์รายวันสำหรับยอดดูเพลย์ลิสต์บนระบบปฏิบัติการ Android
- เมตริกระบบปฏิบัติการรายวันสำหรับยอดดูเพลย์ลิสต์บนอุปกรณ์เคลื่อนที่
-
อุปกรณ์/ระบบปฏิบัติการ
ข้อมูลประชากร
มิติข้อมูลข้อมูลประชากรจะช่วยให้คุณเข้าใจช่วงอายุและเพศของผู้ชมของคุณ ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลประชากรในรายงาน YouTube Analytics
- ageGroup (มิติข้อมูลหลัก)
- มิติข้อมูลนี้จะระบุกลุ่มอายุของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลรายงาน API ใช้กลุ่มอายุต่อไปนี้
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- เพศ (มิติข้อมูลหลัก)
- มิติข้อมูลนี้จะระบุเพศของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลรายงาน
ค่าที่ถูกต้องคือ
female
,male
และuser_specified
This is a core dimension and is subject to the Deprecation Policy.
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลข้อมูลประชากร
ตัวอย่างช่อง
-
ข้อมูลประชากร
- ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
- ข้อมูลประชากรของผู้ชมเพลย์ลิสต์ในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
-
ข้อมูลประชากร
ตัวอย่างเจ้าของเนื้อหา
-
ข้อมูลประชากร
- ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
- ข้อมูลประชากรของผู้ชมเพลย์ลิสต์ในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
-
ข้อมูลประชากร
การมีส่วนร่วมและการแชร์เนื้อหา
- sharingService (มิติข้อมูลหลัก)
- มิติข้อมูลนี้ระบุบริการที่ใช้ในการแชร์วิดีโอ คุณสามารถแชร์วิดีโอบน YouTube (หรือผ่านโปรแกรมเล่นวิดีโอ YouTube) โดยใช้ปุ่ม "แชร์" This is a core dimension and is subject to the Deprecation Policy.
ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่ถูกต้อง
บริการสำหรับการแชร์ ค่า API Ameba AMEBA
อีเมล Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
การรับส่งข้อความใน Android ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
คัดลอกไปยังคลิปบอร์ด COPY_PASTE
ไซเวิลด์ CYWORLD
Digg DIGG
Dropbox DROPBOX
ฝัง EMBED
อีเมล MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
หน้า Facebook FACEBOOK_PAGES
ฟอตกา FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
ส่ง SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
ข้อความ HTC HTC_MMS
กล่องจดหมายของ Google INBOX
กล่องโต้ตอบกิจกรรมระบบ iOS IOS_SYSTEM_ACTIVITY_DIALOG
เรื่องราวของ KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
กิ๊ก KIK
อีเมล LGE LGE_EMAIL
บรรทัด LINE
Linkedin LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
การรับส่งข้อความของ Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
การแชร์ใกล้เคียง NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (ดูдноклассники) ODNOKLASSNIKI
อื่นๆ OTHER
Pinterest PINTEREST
ราคุเทน (楽天 without場) RAKUTEN
reddit REDDIT
Skype SKYPE
สกายร็อก SKYBLOG
การสนทนาของ Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
ตูเอนติ TUENTI
tumblr. TUMBLR
Twitter TWITTER
ไม่ทราบ UNKNOWN
ข้อความ Verizon VERIZON_MMS
Viber VIBER
VKontakte (จะปรากฏขึ้นเข้าสู่ระบบอย่างน้อยหนึ่งรายการ) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
วิคอป WYKOP
Yahoo! ญี่ปุ่น YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV
โปรดดูเอกสารช่วยเหลือสำหรับข้อมูลเพิ่มเติม
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลโซเชียล
ตัวอย่างช่อง
- โซเชียล: เมตริกการแชร์ที่รวบรวมตามบริการที่มีการแชร์วิดีโอ
ตัวอย่างเจ้าของเนื้อหา
- โซเชียล: เมตริกการแชร์ที่รวบรวมตามบริการที่มีการแชร์วิดีโอ
การคงผู้ชมไว้
- elapsedVideoTimeRatio
- มิติข้อมูลนี้ระบุอัตราส่วนของส่วนที่ผ่านไปแล้วของวิดีโอต่อความยาวของวิดีโอ ระบบใช้มิติข้อมูลและเมตริกของการคงผู้ชมไว้เพื่อวัดการคงผู้ชมไว้เมื่อเวลาผ่านไป และมิติข้อมูล
elapsedVideoTimeRatio
เป็นการวัดเวลา ตัวอย่างเช่น ค่า0.4
บ่งชี้ว่าข้อมูลรายงานที่เกี่ยวข้องแสดงข้อมูลการคงผู้ชมไว้หลังจากที่วิดีโอเล่นไปแล้ว 40 เปอร์เซ็นต์ของรายงาน
API จะแสดงผลจุดข้อมูล 100 จุดสำหรับวิดีโอแต่ละรายการที่มีค่าอัตราส่วนตั้งแต่0.01
ถึง1.0
เวลาที่มีการวัดข้อมูลระหว่างการเล่นวิดีโอจะเว้นระยะเท่าๆ กันสำหรับวิดีโอแต่ละรายการ ซึ่งหมายความว่าสำหรับวิดีโอความยาว 2 นาที ช่วงเวลาระหว่างจุดข้อมูลคือ 1.2 วินาที อย่างไรก็ตาม สำหรับวิดีโอความยาว 2 ชั่วโมง ช่วงเวลาระหว่างจุดข้อมูลคือ 72 วินาที ค่าของมิติข้อมูลหมายถึงจุดสิ้นสุดของช่วงที่ไม่ซ้ำกัน - audienceType (ตัวกรองเท่านั้น)
- ค่ามิติข้อมูลจะระบุประเภทการเข้าชมที่เชื่อมโยงกับข้อมูลรายงาน
ค่าที่รองรับคือ
ORGANIC
,AD_INSTREAM
และAD_INDISPLAY
ดูคำอธิบายเกี่ยวกับแหล่งที่มาของการเข้าชมประเภทต่างๆ เหล่านี้ได้ที่ศูนย์ช่วยเหลือของ YouTube
โปรดทราบว่าข้อมูลของตัวกรองaudienceType
จะพร้อมใช้งานตั้งแต่วันที่ 25 กันยายน 2013 API จะไม่แสดงข้อมูลสำหรับคำค้นหาที่ใช้ตัวกรองเพื่อพยายามดึงข้อมูลจากวันก่อนหน้า ข้อความค้นหาที่ไม่ใช้ตัวกรองนั้นจะใช้ได้กับวันที่ใดๆ หลังจากวันที่ 1 กรกฎาคม 2008
ตัวอย่าง
คำขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลการคงผู้ชมไว้
ตัวอย่างช่อง
- การคงผู้ชมไว้: เมตริกการคงผู้ชมไว้ของวิดีโอ
ตัวอย่างเจ้าของเนื้อหา
- การคงผู้ชมไว้: เมตริกการคงผู้ชมไว้ของวิดีโอ
ประสิทธิภาพโฆษณา
- adType
- ระบบจะใช้มิติข้อมูล
adType
ในรายงานประสิทธิภาพของโฆษณาและรวบรวมเมตริกที่ขอโดยอิงตามประเภทของโฆษณาที่แสดงระหว่างการเล่นวิดีโอ รายการต่อไปนี้อธิบายค่ามิติข้อมูลที่เป็นไปได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบการโฆษณาของ YouTube ได้ที่ศูนย์ช่วยเหลือของ YouTube
-
auctionBumperInstream
– ผู้ชมต้องดูโฆษณาวิดีโอแบบข้ามไม่ได้ความยาวไม่เกิน 6 วินาทีก่อนที่จะดูวิดีโอ -
auctionDisplay
– ริชมีเดียหรือโฆษณาแบบรูปภาพที่ปรากฏ ไม่ว่าจะเป็นโฆษณาซ้อนทับที่ด้านล่างของโปรแกรมเล่นวิดีโอ เป็นหน่วยโฆษณาขนาด 300x250 ในหน้าดูวิดีโอ หรือแสดงเป็นทั้ง 2 แบบ เมื่อโฆษณาซ้อนทับทำงาน โฆษณาซ้อนทับจะปิดโดยอัตโนมัติหลังจากแสดงเป็นระยะเวลาหนึ่ง และผู้ใช้จะปิดโฆษณาซ้อนทับได้เช่นกัน หากมีการแสดงโฆษณาซ้อนทับและแบนเนอร์ร่วมกัน ระบบจะนับโฆษณาแต่ละรายการเป็นการแสดงผลแยกกัน -
auctionInstream
– โฆษณาวิดีโอแบบข้ามไม่ได้ที่แสดงก่อน ระหว่าง หรือหลังวิดีโอหลัก -
auctionTrueviewInslate
– ผู้ชมเลือกโฆษณาวิดีโอ 1 จากหลายรายการจากตัวเลือกที่แสดงอยู่ก่อนวิดีโอSee the TrueView documentation for more information. -
auctionTrueviewInstream
– โฆษณาวิดีโอแบบข้ามได้ที่แสดงก่อนหรือระหว่างวิดีโอหลัก ดูข้อมูลเพิ่มเติมในเอกสารประกอบ TrueView -
auctionUnknown
– โฆษณาที่ซื้อผ่านการประมูลของ AdWords แต่ไม่ได้จัดอยู่ในประเภทโฆษณาอื่นๆ -
reservedBumperInstream
– ผู้ชมต้องดูโฆษณาวิดีโอแบบข้ามไม่ได้และขายในแบบจองได้สูงสุด 6 วินาทีก่อนที่จะดูวิดีโอ -
reservedClickToPlay
– โฆษณาวิดีโอที่ผู้ใช้ต้องคลิกเพื่อเริ่มเล่น ระบบจะบันทึกการแสดงโฆษณาทุกครั้งที่หน่วยโฆษณาคลิกเพื่อเล่นแสดงขึ้น ไม่ว่าผู้ใช้จะเริ่มเล่นหรือไม่ก็ตาม ซึ่งจะขายในรูปแบบการจอง -
reservedDisplay
– ริชมีเดียหรือโฆษณาแบบรูปภาพที่ปรากฏ ไม่ว่าจะเป็นโฆษณาซ้อนทับที่ด้านล่างของโปรแกรมเล่นวิดีโอ เป็นหน่วยโฆษณาขนาด 300x250 ในหน้าดูวิดีโอ หรือแสดงเป็นทั้ง 2 แบบ เมื่อโฆษณาซ้อนทับทำงาน โฆษณาซ้อนทับจะปิดโดยอัตโนมัติหลังจากแสดงเป็นระยะเวลาหนึ่ง และผู้ใช้จะปิดโฆษณาซ้อนทับได้เช่นกัน หากมีการแสดงโฆษณาซ้อนทับและแบนเนอร์ร่วมกัน ระบบจะนับโฆษณาแต่ละรายการเป็นการแสดงผลแยกกัน -
reservedInstream
– โฆษณาวิดีโอแบบข้ามไม่ได้ที่แทรกไว้ก่อน ระหว่าง หรือหลังวิดีโอหลัก -
reservedInstreamSelect
-
reservedMasthead
– โฆษณาขนาดใหญ่ ซึ่งอาจรวมถึงองค์ประกอบวิดีโอและกราฟิกที่ปรากฏบนหน้าแรก -
reservedUnknown
– โฆษณาที่ขายตามวิธีการจองที่ไม่สามารถจัดประเภทเป็นโฆษณาประเภทอื่นได้ -
unknown
– เราไม่สามารถจำแนกประเภทโฆษณานี้ได้
-
ตัวอย่าง
รายงานตัวอย่างต่อไปนี้จะดึงข้อมูลเมตริกประสิทธิภาพโฆษณาหรือรายได้
ตัวอย่างช่อง
-
รายได้/โฆษณา
- เมตริกรายได้และประสิทธิภาพโฆษณาของช่อง
- เมตริกรายได้และประสิทธิภาพโฆษณารายวัน
- เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ
- 10 อันดับแรก – วิดีโอที่สร้างรายได้สูงสุด
- เมตริกประสิทธิภาพโฆษณาสำหรับโฆษณาประเภทต่างๆ
-
รายได้/โฆษณา
ตัวอย่างเจ้าของเนื้อหา
-
รายได้/โฆษณา
- เมตริกรายได้และประสิทธิภาพโฆษณาสำหรับเนื้อหาที่มีการอ้างสิทธิ์
- เมตริกรายได้และประสิทธิภาพโฆษณารายวัน
- เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ
- 10 อันดับแรก – วิดีโอที่สร้างรายได้สูงสุด
- เมตริกประสิทธิภาพโฆษณาสำหรับโฆษณาประเภทต่างๆ
-
รายได้/โฆษณา
เพลย์ลิสต์
- isCurated (ตัวกรองเท่านั้น)
- ตัวกรองนี้บ่งบอกว่าคำขอกำลังดึงข้อมูลเกี่ยวกับยอดดูวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์
ตัวอย่าง
ตัวอย่างคำขอทั้งหมดที่ดึงรายงานเพลย์ลิสต์จะใช้ตัวกรอง isCurated
มิติข้อมูลเจ้าของเนื้อหา
มิติข้อมูลต่อไปนี้ใช้ได้กับรายงานเจ้าของเนื้อหาเท่านั้น
- DMCAStatus (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
- มิติข้อมูลนี้ช่วยให้คุณระบุได้ว่าการตอบกลับจาก API ควรมีเฉพาะเมตริกสำหรับเนื้อหาที่มีการอ้างสิทธิ์เท่านั้น ค่าที่ถูกต้องสำหรับมิติข้อมูลนี้คือ
claimed
หากพารามิเตอร์filters
จำกัดการค้นหาไว้เฉพาะclaimedStatus==claimed
API จะเรียกข้อมูลของเนื้อหาที่อ้างสิทธิ์เท่านั้น ตารางในคำจำกัดความของมิติข้อมูลuploaderType
จะให้รายละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้มิติข้อมูลนี้
- ประเภทผู้อัปโหลด (มิติข้อมูลหลัก) (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
- มิติข้อมูลนี้ช่วยให้คุณระบุได้ว่าการตอบกลับจาก API ควรมีเมตริกสำหรับเนื้อหาที่เจ้าของเนื้อหาที่ระบุและ/หรือเนื้อหาที่อัปโหลดโดยบุคคลที่สาม เช่น วิดีโอที่ผู้ใช้อัปโหลดหรือไม่ ค่าที่ถูกต้องคือ
self
และthirdParty
รายการนี้เป็นมิติข้อมูลหลักและอยู่ภายใต้นโยบายการเลิกใช้งาน
ตารางด้านล่างแสดงชุดค่าผสมที่รองรับสําหรับมิติข้อมูลclaimedStatus
และuploaderType
ซึ่งทั้งคู่ใช้ในพารามิเตอร์filters
มูลค่า claimedStatus
มูลค่า uploaderType
คำอธิบาย [ไม่ได้ตั้งค่า] ตนเอง ดึงข้อมูล YouTube Analytics สำหรับเนื้อหาที่มีการอ้างสิทธิ์และไม่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา มีการอ้างสิทธิ์ [ไม่ได้ตั้งค่า] เรียกดูข้อมูลของเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหาหรือบุคคลที่สาม มีการอ้างสิทธิ์ ตนเอง เรียกดูข้อมูลของเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา มีการอ้างสิทธิ์ thirdParty เรียกดูข้อมูลของเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยบุคคลที่สาม
ตัวอย่าง
คำขอ API ตัวอย่างจำนวนมากสำหรับรายงานเจ้าของเนื้อหาใช้ทั้งมิติข้อมูล claimedStatus
และ uploaderType
ที่รองรับเพื่อกรองข้อมูล