เอกสารนี้จะระบุมิติข้อมูลที่ API การรายงานของ YouTube รองรับ API นี้จะดึงรายงานจำนวนมากที่มีข้อมูล YouTube Analytics สำหรับช่องหรือเจ้าของเนื้อหา
มิติข้อมูลคือเกณฑ์ทั่วไปที่ใช้ในการรวบรวมข้อมูล เช่น วันที่ที่มีกิจกรรมของผู้ใช้หรือประเทศที่ผู้ใช้อยู่
รายงานแบบเป็นกลุ่มแต่ละฉบับรองรับรายการมิติข้อมูลที่กำหนดไว้ล่วงหน้า และข้อมูลแต่ละแถวจะมีชุดค่าผสมของมิติข้อมูลที่ไม่ซ้ำกันในรายงานฉบับใดก็ตาม ด้วยเหตุนี้ ชุดค่าผสมของค่ามิติข้อมูลของแต่ละแถวจึงทำหน้าที่เป็นคีย์หลักสำหรับแถวนั้น คุณไม่จําเป็นต้องระบุหรือตัวเลือกในการระบุมิติข้อมูลที่รวมอยู่ในรายงาน
มิติข้อมูลหลัก
แม้ว่า API การรายงานของ YouTube จะอยู่ภายใต้นโยบายการเลิกใช้งานที่ระบุไว้ในข้อกำหนดในการให้บริการ แต่มิติข้อมูลที่ไม่ใช่กลุ่มหลัก (และเมตริกที่ไม่ใช่กลุ่มหลัก) จะไม่อยู่ภายใต้นโยบาย ในคําจํากัดความในหน้านี้ จะมีการระบุมิติข้อมูลที่เป็นมิติข้อมูลหลักไว้อย่างชัดเจน
รายการต่อไปนี้ระบุมิติข้อมูลหลักของ API ทุกรายการยังเป็นมิติข้อมูลหลักใน API ของ YouTube Analytics ด้วย
ดูข้อมูลเพิ่มเติมได้ที่รายการ YouTube API ภายใต้นโยบายการเลิกใช้งาน
ขนาด
ส่วนต่อไปนี้จะระบุมิติข้อมูลที่ใช้ในรายงานจำนวนมากของ YouTube Reporting API มิติข้อมูลเหล่านี้จะใช้ทั้งในรายงานช่องและเจ้าของเนื้อหา เว้นแต่จะระบุไว้เป็นอย่างอื่น
แหล่งข้อมูล
มิติข้อมูลเหล่านี้สอดคล้องกับทรัพยากรที่ช่องและเจ้าของเนื้อหาจัดการบน YouTube
- video_id (มิติข้อมูลหลัก)
- รหัสของวิดีโอ YouTube ใน YouTube Data API ค่านี้คือค่าพร็อพเพอร์ตี้
id
ของทรัพยากรvideo
This is a core dimension and is subject to the Deprecation Policy. - playlist_id
- รหัสเพลย์ลิสต์ YouTube ใน YouTube Data API ค่านี้คือค่าพร็อพเพอร์ตี้
id
ของทรัพยากรplaylist
- channel_id (มิติข้อมูลหลัก)
- รหัสสำหรับช่อง YouTube ใน YouTube Data API ค่านี้คือค่าพร็อพเพอร์ตี้
id
ของทรัพยากรchannel
This is a core dimension and is subject to the Deprecation Policy. - asset_id (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
- รหัสของเนื้อหาที่จัดการในระบบ Content ID ของ YouTube เนื้อหาคือทรัพย์สินทางปัญญาของคุณในระบบนั้น ในเว็บไซต์ YouTube คุณสามารถค้นหารหัสเนื้อหาในระบบจัดการเนื้อหาของ YouTube นอกจากนี้ คุณยังเรียกดูวิดีโอได้โดยใช้ API สำหรับ Content ID ของ YouTube
พื้นที่ทางภูมิศาสตร์
มิติข้อมูลเหล่านี้จะระบุพื้นที่ทางภูมิศาสตร์ที่เชื่อมโยงกับเมตริกกิจกรรมของผู้ใช้ ประสิทธิภาพโฆษณา หรือรายได้โดยประมาณ
- country_code (มิติข้อมูลหลัก)
- ประเทศที่เชื่อมโยงกับเมตริกในแถวรายงาน ค่ามิติข้อมูลคือรหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 เช่น
US
,CN
(จีน) หรือFR
(ฝรั่งเศส) รหัสประเทศZZ
ใช้สำหรับรายงานเมตริกที่ YouTube ระบุประเทศที่เกี่ยวข้องไม่ได้ This is a core dimension and is subject to the Deprecation Policy. - province_code
- รัฐหรือเขตแดนของสหรัฐอเมริกาที่เชื่อมโยงกับเมตริกในแถวรายงาน ค่ามิติข้อมูลคือรหัส ISO 3166-2 ที่ระบุรัฐในสหรัฐอเมริกาหรือดิสตริกต์ออฟโคลัมเบีย เช่น
US-MI
(มิชิแกน) หรือUS-TX
(เท็กซัส) รหัสจังหวัดUS-ZZ
ใช้เพื่อรายงานเมตริกที่ YouTube ระบุรัฐที่เกี่ยวข้องของสหรัฐอเมริกาไม่ได้หมายเหตุ: มิติข้อมูลนี้ไม่รองรับค่า ISO 3166-2 ที่ระบุพื้นที่รอบนอกของสหรัฐอเมริกา เนื่องจากเขตแดนเหล่านั้นมีรหัสประเทศตามมาตรฐาน ISO 3166-1 เป็นของตัวเองด้วย และยังไม่สนับสนุนการแยกย่อยในประเทศอื่นๆ ที่ไม่ใช่สหรัฐอเมริกาด้วย
ระยะเวลา
- วันที่ (มิติข้อมูลหลัก)
- มิติข้อมูลนี้จะระบุวันที่ที่เชื่อมโยงกับเมตริกในแต่ละแถวของรายงาน ในรายงานแบบเป็นกลุ่ม วันที่หมายถึงระยะเวลาที่เริ่มต้นจากเวลา 00:00 น. เวลาเขตแปซิฟิก และสิ้นสุดเวลา 23:59 น. ตามเวลาแปซิฟิกในวันที่ เดือน และปีที่ระบุ เวลามาตรฐานแปซิฟิกคือ UTC-7 หรือ UTC-8 ทั้งนี้ขึ้นอยู่กับช่วงเวลาของปี
โปรดทราบว่าโดยปกติวันที่จะแสดงระยะเวลา 24 ชั่วโมง แต่วันที่ที่มีการปรับนาฬิกาไปข้างหน้าสำหรับเวลาออมแสงหมายถึงระยะเวลา 23 ชั่วโมง และวันที่ที่มีการปรับนาฬิกาย้อนหลังจะหมายถึงระยะเวลา 25 ชั่วโมง This is a core dimension and is subject to the Deprecation Policy.
ตำแหน่งที่เล่น
มิติข้อมูลเหล่านี้ให้ข้อมูลเชิงลึกเกี่ยวกับหน้าเว็บหรือแอปพลิเคชันที่มีกิจกรรมของผู้ใช้
- playback_location_type
-
มิติข้อมูลนี้ระบุประเภทของหน้าเว็บหรือแอปพลิเคชันที่มีกิจกรรมของผู้ใช้ ตารางต่อไปนี้แสดงค่ามิติข้อมูล
ค่า 0
ข้อมูลนี้เกี่ยวข้องกับกิจกรรมที่เกิดขึ้นบนหน้าดูวิดีโอของ YouTube ของวิดีโอหรือในแอปพลิเคชันอย่างเป็นทางการของ YouTube เช่น แอป YouTube บน Android 1
ข้อมูลนี้เกี่ยวข้องกับกิจกรรมที่เกิดขึ้นในเว็บไซต์หรือแอปพลิเคชันอื่นที่มีการฝังวิดีโอโดยใช้การฝัง <iframe>
หรือ<object>
2
ข้อมูลนี้เกี่ยวข้องกับกิจกรรมที่เกิดขึ้นในหน้าช่อง YouTube 5
ข้อมูลนี้เกี่ยวข้องกับเมตริกที่ไม่สามารถจัดประเภทเป็นสถานที่ตั้งประเภทอื่นที่แสดงด้านบน 7
ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นบนหน้าแรกหรือหน้าจอหลักของ YouTube ในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การเรียกดูอื่นๆ ของ YouTube 8
ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นโดยตรงในหน้าผลการค้นหาของ YouTube 10
ข้อมูลนี้เกี่ยวข้องกับยอดดูที่เกิดขึ้นในฟีด YouTube Shorts - playback_location_detail
- มิติข้อมูลนี้ระบุ URL หรือแอปพลิเคชันที่เกิดการเล่นขึ้น มิติข้อมูลนี้รองรับเฉพาะข้อมูลพร็อพเพอร์ตี้ที่เกิดขึ้นในโปรแกรมเล่นแบบฝังเท่านั้น ซึ่งหมายความว่าค่าของมิติข้อมูลจะปรากฏในแถวที่ค่าของมิติข้อมูลคือ
1
เท่านั้น ในแถวอื่นๆ ค่าของมิติข้อมูลนี้จะว่างเปล่า
รายละเอียดการเล่น
- live_or_on_demand
- มิติข้อมูลนี้จะระบุว่าเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูลเชื่อมโยงกับการดูการถ่ายทอดสดหรือไม่ ข้อมูลสำหรับมิติข้อมูลนี้ใช้ได้ตั้งแต่วันที่ 1 เมษายน 2014
ตารางต่อไปนี้ระบุค่ามิติข้อมูล
ค่า live
ข้อมูลของแถวจะอธิบายกิจกรรมของผู้ใช้ที่เกิดขึ้นระหว่างการถ่ายทอดสด onDemand
ข้อมูลของแถวจะอธิบายกิจกรรมของผู้ใช้ที่ไม่ได้เกิดขึ้นระหว่างการถ่ายทอดสด - subscribed_status
- มิติข้อมูลนี้จะระบุว่าเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูลเชื่อมโยงกับผู้ชมที่ติดตามช่องของวิดีโอหรือเพลย์ลิสต์หรือไม่
ค่าที่เป็นไปได้คือ
subscribed
และunsubscribed
โปรดทราบว่าค่ามิติข้อมูลจะถูกต้อง ณ เวลาที่เกิดกิจกรรมของผู้ใช้ ตัวอย่างเช่น สมมติว่าผู้ใช้ไม่ได้ติดตามช่อง และดูวิดีโอหนึ่งของช่อง จากนั้นสมัครสมาชิกช่องและดูวิดีโออื่น ทั้งหมดนี้ในวันเดียวกัน รายงานของแชแนลระบุว่าข้อมูลพร็อพเพอร์ตี้ 1 รายการมีค่าsubscribed_status
เป็นsubscribed
และข้อมูลพร็อพเพอร์ตี้ 1 รายการมีค่าsubscribed_status
เป็นunsubscribed
แหล่งที่มาของการเข้าชม
- traffic_source_type
- มิติข้อมูลนี้จะระบุประเภท URL ที่มาที่เชื่อมโยงกับเมตริกกิจกรรมของผู้ใช้ ประเภท URL ที่มาอธิบายลักษณะที่ผู้ใช้เข้าถึงวิดีโอหรือช่องที่เชื่อมโยงกับแถวของข้อมูลในรายงาน ตารางต่อไปนี้แสดงค่ามิติข้อมูล
ค่า 0
โดยตรงหรือไม่ทราบ
ค่านี้ครอบคลุมการเข้าชมโดยตรงที่ไปยังหน้าเว็บ ตลอดจนหน้าเว็บที่ไม่รู้จัก URL ที่มา ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะระบุเป็นNO_LINK_OTHER
หรือUNKNOWN_MOBILE_OR_DIRECT
1
การโฆษณาใน YouTube
ผู้ชมเรียกวิดีโอนั้นจากการโฆษณา ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ1
มิติข้อมูล traffic_source_detail จะระบุประเภทโฆษณาที่แสดงต่อผู้ชม ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นADVERTISING
ค่าที่เป็นไปได้มีดังนี้ค่า ctp_engagement_ad
โฆษณาเพื่อการมีส่วนร่วมแบบคลิกเพื่อเล่น engagement_ad
โฆษณาเพื่อการมีส่วนร่วม googlemediaads
โฆษณา Google Search insearch_display
TrueView แบบในผลการค้นหาและแบบบนหน้าจอ instream
TrueView ในสตรีม instream-select
โฆษณาในสตรีมแบบข้ามได้ที่จองไว้ unknown
การโฆษณาบน YouTube ที่ไม่จัดอยู่ในหมวดหมู่ใดๆ video_wall
แผงวิดีโอ yva
วิดีโอโฆษณาบนหน้าแรก 3
ฟีเจอร์การเรียกดู
ระบบเรียกผู้ชมจากหน้า YouTube ที่นำไปยังวิดีโอหรือช่อง ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ3
มิติข้อมูล traffic_source_detail จะระบุฟีเจอร์ที่อ้างอิงการเข้าชมนั้น ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นSUBSCRIBER
ค่าที่เป็นไปได้มีดังนี้ค่า explore
เด็ก: สำรวจ learning
เด็ก: การเรียนรู้ music
ฟีดเพลง my-history
ดูประวัติ my-subscriptions
การสมัครใช้บริการของฉัน my-uploads
การอัปโหลดของฉัน podcasts
หน้าปลายทางของพอดแคสต์ shows
เด็ก: รายการ watch-later
ดูภายหลัง what-to-watch
ดูอะไรดี 4
ช่อง YouTube
ระบบเรียกผู้ชมจากหน้าช่อง YouTube ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ4
มิติข้อมูล traffic_source_detail จะระบุรหัสแชแนลของแชแนลนั้น ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นYT_CHANNEL
5
YouTube Search
ผู้ชมจะมาจากผลการค้นหาของ YouTube ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ5
มิติข้อมูล traffic_source_detail จะระบุข้อความค้นหาที่เกี่ยวข้อง ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นYT_SEARCH
7
วิดีโอแนะนำ
ระบบนำผู้ชมมาจากรายการวิดีโอที่เกี่ยวข้องในหน้าดูวิดีโออื่น ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ7
มิติข้อมูล traffic_source_detail จะระบุรหัสวิดีโอของวิดีโอนั้น ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะระบุเป็นRELATED_VIDEO
หรือYT_RELATED
8
ฟีเจอร์อื่นๆ ของ YouTube
ระบบเรียกผู้ชมจากหน้า YouTube ที่ไม่ได้จัดอยู่ในหมวดหมู่แหล่งที่มาของการเข้าชมประเภทอื่นๆ ที่ระบุไว้ ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ8
มิติข้อมูล traffic_source_detail จะระบุ URL ของหน้าเว็บ ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นYT_OTHER_PAGE
ค่าที่เป็นไปได้มีดังนี้ค่า g-crec
ช่องแนะนำ offline
ออฟไลน์ promotion
การโปรโมตพาร์ทเนอร์ unknown
ไม่ทราบ widget
วิดเจ็ตหน้าจอหลักของ Android youtu.be
youtu.be ytremote
รีโมต YouTube 9
ภายนอก
ผู้ชมมาจากลิงก์ในเว็บไซต์อื่น แหล่งที่มาของการเข้าชมนี้รวมการอ้างอิงจากผลการค้นหาของ Google ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ9
มิติข้อมูล traffic_source_detail จะระบุหน้าเว็บภายนอก ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นEXT_URL
11
การ์ดวิดีโอและคำอธิบายประกอบ
ผู้ดูได้รับการอ้างอิงจากการคลิกคำอธิบายประกอบหรือการ์ดในวิดีโออื่น ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นANNOTATION
14
เพลย์ลิสต์
ยอดดูเกิดขึ้นขณะที่วิดีโอกำลังเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์ ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุว่าเป็นPLAYLIST
โปรดทราบว่าแหล่งที่มาของการเข้าชมนี้แตกต่างจากประเภทแหล่งที่มา18
ซึ่งบ่งชี้ว่ายอดดูมาจากหน้าเว็บที่แสดงรายการวิดีโอทั้งหมดในเพลย์ลิสต์17
การแจ้งเตือน
ระบบนำผู้ชมมาจากอีเมลหรือการแจ้งเตือนจาก YouTube ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นNOTIFICATION
ค่าที่เป็นไปได้มีดังนี้ค่า inbox
push
sdig
ยอดดูที่มาจากการแจ้งเตือนที่เป็นส่วนหนึ่งของอีเมลสรุปของผู้ติดตาม uploaded_other
ยอดดูที่มาจากข้อความที่ไม่ใช่ข้อความ Push เช่น การแจ้งเตือนทางอีเมลหรือกล่องจดหมาย ที่ส่งไปยังผู้ติดตามเมื่ออัปโหลดวิดีโอ uploaded_push
ยอดดูที่มาจากข้อความ Push ที่ส่งถึงผู้ติดตามเมื่ออัปโหลดวิดีโอ 18
หน้าเพลย์ลิสต์
ยอดดูจะมาจากหน้าที่แสดงรายการวิดีโอทั้งหมดในเพลย์ลิสต์ ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุว่าเป็นYT_PLAYLIST_PAGE
โปรดทราบว่าแหล่งที่มาของการเข้าชมนี้แตกต่างจากประเภทแหล่งที่มา14
ซึ่งระบุว่ายอดดูเกิดขึ้นขณะที่วิดีโอกำลังเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์19
การจัดโปรแกรมจากเนื้อหาที่มีการอ้างสิทธิ์
ยอดดูจะมาจากวิดีโอที่ผู้ใช้อัปโหลดซึ่งมีการอ้างสิทธิ์ ซึ่งเจ้าของเนื้อหาใช้เพื่อโปรโมตเนื้อหาที่มีคนดู ในรายงานคำค้นหา แหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นCAMPAIGN_CARD
แหล่งที่มาของการเข้าชมนี้ใช้ได้กับรายงานเจ้าของเนื้อหาเท่านั้น20
End Screen ของวิดีโอแบบอินเทอร์แอกทีฟ
ยอดดูที่มาจาก End Screen ของวิดีโออื่น ในรายงานคำค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะได้รับการระบุเป็นEND_SCREEN
23
เรื่องราว
ผู้ดูได้รับการแนะนำโดยการปัดเป็นแนวตั้งจากวิดีโอก่อนหน้าในประสบการณ์การดูเรื่องราว24
Shorts
ผู้ชมได้รับการแนะนำโดยการปัดเป็นแนวตั้งจากวิดีโอก่อนหน้าในประสบการณ์การดู Shorts25
หน้าผลิตภัณฑ์
วิดีโอในหน้าผลิตภัณฑ์นำผู้ชมไปยังช่องอื่น26
หน้าแฮชแท็ก
ยอดดูที่มาจากหน้าแฮชแท็ก VOD หรือหน้า Pivot Page ของแฮชแท็ก Shorts27
หน้าเสียง
ยอดดูที่มาจากหน้า Pivot Page ของเสียงสำหรับ Shorts28
การส่งผู้ชมแบบสด
ยอดดูที่มาจากการส่งผู้ชมแบบสด30
วิดีโอรีมิกซ์
ยอดดูที่มาจากลิงก์วิดีโอรีมิกซ์ในโปรแกรมเล่น Shorts31
ฟีดการถ่ายทอดสดแนวตั้ง
ยอดดูที่มาจากฟีดการถ่ายทอดสดแนวตั้ง32
วิดีโอที่เกี่ยวข้อง
ยอดดูที่มาจากลิงก์วิดีโอที่เกี่ยวข้องในโปรแกรมเล่น Shorts - traffic_source_detail
- มิติข้อมูลนี้ให้รายละเอียดเพิ่มเติมเกี่ยวกับแหล่งที่มาของการเข้าชมซึ่งเป็นค่ามิติข้อมูล traffic_source_type ของแถว ค่ามิติข้อมูลนี้จะสร้างขึ้นสำหรับค่ามิติข้อมูล traffic_source_type ต่อไปนี้
1
– ค่าขนาดจะระบุประเภทของโฆษณาที่แสดงต่อผู้ชม ดูคําจํากัดความ traffic_source_type สําหรับรายการค่าที่เป็นไปได้3
– ค่ามิติข้อมูลจะระบุฟีเจอร์ของ YouTube ที่นำไปสู่การเข้าชมที่อ้างอิง ดูคําจํากัดความ traffic_source_type สําหรับรายการค่าที่เป็นไปได้4
– ค่ามิติข้อมูลจะระบุรหัสช่องที่อ้างอิงผู้ชม5
– ค่ามิติข้อมูลระบุข้อความค้นหาที่นำไปยังการเข้าชมที่อ้างอิง7
– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชม8
– ค่ามิติข้อมูลจะระบุประเภทของหน้า YouTube ที่นำไปสู่การเข้าชมที่อ้างอิง ดูคําจํากัดความ traffic_source_type สําหรับรายการค่าที่เป็นไปได้9
– ค่ามิติข้อมูลจะระบุหน้าภายนอกที่มีการอ้างอิงการเข้าชม17
– ค่ามิติข้อมูลจะระบุประเภทการแจ้งเตือนที่นำไปสู่การเข้าชมที่อ้างอิง ดูคําจํากัดความ traffic_source_type สําหรับรายการค่าที่เป็นไปได้19
– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชม20
– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชม25
– ค่ามิติข้อมูลจะระบุรหัสผลิตภัณฑ์ ซึ่งเป็นรหัสกราฟความรู้ของ Google26
– ค่ามิติข้อมูลจะระบุแฮชแท็กที่นำไปยังการเข้าชมที่อ้างอิง27
– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชม28
– ค่ามิติข้อมูลจะระบุรหัสช่องที่มีการอ้างอิงผู้ชมผ่านการส่งผู้ชมแบบสด30
– ค่าขนาดจะระบุวิดีโอที่อ้างอิงผู้ชม
อุปกรณ์
- device_type
- มิติข้อมูลนี้จะระบุรูปแบบของอุปกรณ์ทางกายภาพของอุปกรณ์ที่เกิดการดู
ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่ถูกต้อง
ค่า 100
ไม่ทราบ 101
คอมพิวเตอร์ 102
ทีวี 103
คอนโซลเกม 104
โทรศัพท์มือถือ 105
แท็บเล็ต - operating_system
- มิติข้อมูลนี้ระบุระบบซอฟต์แวร์ของอุปกรณ์ที่เกิดการดู
ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่ถูกต้อง
ค่า 1
อื่นๆ 2
Windows 3
Windows Mobile 4
Android 5
iOS 6
Symbian 7
BlackBerry 9
Macintosh 10
PlayStation 11
Bada 12
WebOS 13
Linux 14
Hiptop 15
MeeGo 16
Wii 17
Xbox 18
PlayStation Vita 19
สมาร์ททีวี 20
Nintendo 3DS 21
Chromecast 22
Tizen 23
Firefox 24
RealMedia 25
KaiOS 26
Roku 27
Nintendo Switch 28
Apple tvOS 29
ระบบปฏิบัติการ Fire OS 30
ChromeOS 31
Vidaa
ข้อมูลประชากร
มิติข้อมูลข้อมูลประชากรจะช่วยให้คุณเข้าใจช่วงอายุและเพศของผู้ชมของคุณ ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลประชากรในรายงาน YouTube Analytics
- age_group (มิติข้อมูลหลัก)
- มิติข้อมูลนี้จะระบุกลุ่มอายุของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลรายงาน API ใช้กลุ่มอายุต่อไปนี้
AGE_13_17
AGE_18_24
AGE_25_34
AGE_35_44
AGE_45_54
AGE_55_64
AGE_65_
- เพศ (มิติข้อมูลหลัก)
- มิติข้อมูลนี้จะระบุเพศของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลรายงาน
ค่าที่ถูกต้องคือ
FEMALE
,MALE
และGENDER_OTHER
This is a core dimension and is subject to the Deprecation Policy.
การมีส่วนร่วมและการแชร์เนื้อหา
- sharing_service (มิติข้อมูลหลัก)
- มิติข้อมูลนี้ระบุบริการที่ใช้ในการแชร์วิดีโอ คุณสามารถแชร์วิดีโอบน YouTube (หรือผ่านโปรแกรมเล่นวิดีโอ YouTube) โดยใช้ปุ่ม "แชร์" This is a core dimension and is subject to the Deprecation Policy.
ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่ถูกต้อง
ค่า 0
ไม่ทราบ 1
Digg 4
reddit 5
StumbleUpon 6
mixi 7
Yahoo! ญี่ปุ่น 8
goo 9
Ameba 10
Facebook 11
Myspace 12
NUjij 18
ตูเอนติ 20
Menéame 21
วิคอป 22
สกายร็อก 25
ฟอตกา 28
hi5 31
Twitter 32
ไซเวิลด์ 34
Blogger 36
VKontakte (จะปรากฏขึ้นเข้าสู่ระบบอย่างน้อยหนึ่งรายการ) 37
ราคุเทน (楽天 without場) 38
LiveJournal 39
Odnoklassniki (ดูдноклассники) 40
tumblr. 42
Linkedin 43
Google+ 44
Weibo 45
Pinterest 46
อีเมล 47
Facebook Messenger 49
WhatsApp 50
Hangouts 51
Gmail 52
Kakao (Kakao Talk) 53
อื่นๆ 55
คัดลอกไปยังคลิปบอร์ด 59
ฝัง 60
SMS 61
การรับส่งข้อความใน Android 62
ข้อความ Verizon 63
ข้อความ HTC 64
การสนทนาของ Sony 65
ส่ง SMS 66
อีเมล LGE 67
บรรทัด 68
Viber 69
กิ๊ก 70
Skype 71
Blackberry Messenger 72
WeChat 73
เรื่องราวของ KAKAO 74
Dropbox 75
Telegram 76
หน้า Facebook 77
GroupMe 78
อีเมล Android 79
การรับส่งข้อความของ Motorola 80
การแชร์ใกล้เคียง 81
Naver 82
กล่องโต้ตอบกิจกรรมระบบ iOS 83
กล่องจดหมายของ Google 84
Android Messenger 85
YouTube Music 86
YouTube Gaming 87
YouTube Kids 88
YouTube TV
โปรดดูเอกสารช่วยเหลือสำหรับข้อมูลเพิ่มเติม
หมายเหตุ
- annotation_type
- มิติข้อมูลนี้ระบุลักษณะการแสดงคำอธิบายประกอบในวิดีโอ ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่เป็นไปได้
ค่า 0
ไม่ทราบ 1
หมายเหตุ 3
สปอตไลท์ 4
ชื่อ 8
ลูกโป่งคำพูด 9
ค่ายเพลง 10
ลายน้ำของแบรนด์ 11
วิดีโอเด่น 12
เพลย์ลิสต์เด่น 30
คำกระตุ้นการตัดสินใจ - annotation_id
- รหัสที่ YouTube ใช้เพื่อระบุคำอธิบายประกอบโดยไม่ซ้ำกัน
การ์ด
- card_type
- มิติข้อมูลนี้ระบุประเภทของการ์ดที่แสดงต่อผู้ใช้ ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่เป็นไปได้
ค่า 0
ไม่ทราบ 60
ลิงก์ 61
การระดมทุน 62
วิดีโอ 63
เพลย์ลิสต์ 65
การให้เงินสนับสนุนของแฟนๆ 66
สินค้า 68
เว็บไซต์ที่เกี่ยวข้อง 69
ช่อง - card_id
- รหัสที่ YouTube ใช้ในการระบุบัตรโดยไม่ซ้ำกัน
End Screen
- end_screen_element_type
- มิติข้อมูลนี้จะระบุประเภทขององค์ประกอบ End Screen ที่แสดงต่อผู้ใช้ ตารางต่อไปนี้แสดงประเภทองค์ประกอบ End Screen และค่าขององค์ประกอบ
ค่า 501
วิดีโอ - องค์ประกอบโปรโมตวิดีโอ YouTube อื่น 502
เพลย์ลิสต์ - องค์ประกอบโปรโมตเพลย์ลิสต์ YouTube 503
เว็บไซต์ - องค์ประกอบจะลิงก์ไปยังเว็บไซต์ที่เกี่ยวข้องของคุณ 504
ช่อง - องค์ประกอบลิงก์กับช่องอื่น 505
ติดตาม - องค์ประกอบจะกระตุ้นให้มีการติดตามช่องของคุณ 506
เกี่ยวข้อง 507
การระดมทุน - องค์ประกอบนี้ลิงก์ไปยังเว็บไซต์การระดมทุนที่ได้รับอนุมัติ 508
สินค้า - องค์ประกอบจะลิงก์ไปยังเว็บไซต์สินค้าที่ได้รับอนุมัติ 509
การอัปโหลดล่าสุด - องค์ประกอบจะลิงก์ไปยังวิดีโอที่อัปโหลดล่าสุดของช่อง 510
เหมาะกับผู้ชม - end_screen_element_id
- รหัสที่ YouTube ใช้เพื่อระบุองค์ประกอบ End Screen แบบไม่ซ้ำ
คำบรรยาย
- subtitle_language
- มิติข้อมูลนี้ระบุภาษาของคำบรรยายที่ใช้นานที่สุดในการดู โดยจะไม่นับยอดดูที่คำบรรยายถูกปิดเป็นส่วนใหญ่ ดูเอกสารประกอบสำหรับรายงานแชแนลหรือรายงานเจ้าของเนื้อหาเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานที่มีมิติข้อมูลนี้
- subtitle_language_autotranslated
- มิติข้อมูลนี้จะระบุภาษาของคำบรรยายที่แปลอัตโนมัติซึ่งใช้เป็นเวลานานที่สุดในการดู โดยจะไม่นับยอดดูที่คำบรรยายถูกปิดเป็นส่วนใหญ่ ดูเอกสารประกอบสำหรับรายงานแชแนลหรือรายงานเจ้าของเนื้อหาเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานที่มีมิติข้อมูลนี้
ประสิทธิภาพโฆษณา
- ad_type
- ระบบจะใช้มิติข้อมูล
ad_type
ในรายงานประสิทธิภาพของโฆษณาและรวบรวมเมตริกที่ขอโดยอิงตามประเภทของโฆษณาที่แสดงระหว่างการเล่นวิดีโอ ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่เป็นไปได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบการโฆษณาของ YouTube ได้ที่ศูนย์ช่วยเหลือของ YouTube
ค่า คำอธิบาย ค่าในรายงานการค้นหา 1
โฆษณาวิดีโอแบบข้ามได้ (ประมูล) auctionTrueviewInstream
2
โฆษณาแบบดิสเพลย์ (ประมูล) auctionDisplay
3
โฆษณาวิดีโอแบบข้ามไม่ได้ (ประมูล) auctionInstream
5
โฆษณาแบบดิสเพลย์ (จองไว้) reservedDisplay
6
โฆษณาวิดีโอแบบข้ามไม่ได้ (จอง) reservedInstream
13
ไม่ทราบ unknown
15
โฆษณาวิดีโอแบบข้ามได้ (จอง) reservedInstreamSelect
19
โฆษณาบัมเปอร์ (การประมูล) auctionBumperInstream
20
โฆษณาบัมเปอร์ (จองไว้) reservedBumperInstream
หมายเหตุ: รายงานคำค้นหาอาจแสดงประเภทโฆษณาเพิ่มเติมบางประเภทที่เคยใช้กับ YouTube
มิติข้อมูลเจ้าของเนื้อหา
มิติข้อมูลต่อไปนี้จะใช้ในรายงานเจ้าของเนื้อหาเท่านั้น
- claim_status (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
- มิติข้อมูลนี้บ่งบอกว่าแถวข้อมูลมีเฉพาะเมตริกของเนื้อหาที่อ้างสิทธิ์เท่านั้น ค่าที่ถูกต้องสำหรับมิติข้อมูลนี้คือ
claimed
ตารางในคำจำกัดความของมิติข้อมูลuploader_type
จะให้รายละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้มิติข้อมูลนี้
- upload_type (มิติข้อมูลหลัก) (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
- มิติข้อมูลนี้จะระบุว่าแถวข้อมูลมีเมตริกเนื้อหาที่เจ้าของเนื้อหาที่ระบุอัปโหลด และ/หรือเนื้อหาที่อัปโหลดโดยบุคคลที่สามหรือไม่ เช่น วิดีโอที่ผู้ใช้อัปโหลด ค่าที่ถูกต้องคือ
self
และthirdParty
นี่คือมิติข้อมูลหลักและอยู่ภายใต้นโยบายการเลิกใช้งาน
ตารางด้านล่างแสดงชุดค่าผสมที่รองรับสําหรับมิติข้อมูลclaimed_status
และuploader_type
ดังนี้
มูลค่า claimed_status
มูลค่า uploader_type
คำอธิบาย [ไม่ได้ตั้งค่า] ตนเอง แถวนี้ประกอบด้วยข้อมูล YouTube Analytics สำหรับเนื้อหาที่มีการอ้างสิทธิ์และไม่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา มีการอ้างสิทธิ์ ตนเอง แถวนี้ประกอบด้วยข้อมูลของเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา มีการอ้างสิทธิ์ thirdParty แถวนี้ประกอบด้วยข้อมูลเกี่ยวกับเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยบุคคลที่สาม