Dimensions

เอกสารนี้จะระบุมิติข้อมูลที่ 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
ผู้ชมได้รับการแนะนำโดยการปัดเป็นแนวตั้งจากวิดีโอก่อนหน้าในประสบการณ์การดู Shorts
25 หน้าผลิตภัณฑ์
วิดีโอในหน้าผลิตภัณฑ์นำผู้ชมไปยังช่องอื่น
26 หน้าแฮชแท็ก
ยอดดูที่มาจากหน้าแฮชแท็ก VOD หรือหน้า Pivot Page ของแฮชแท็ก Shorts
27 หน้าเสียง
ยอดดูที่มาจากหน้า Pivot Page ของเสียงสำหรับ Shorts
28 การส่งผู้ชมแบบสด
ยอดดูที่มาจากการส่งผู้ชมแบบสด
30 วิดีโอรีมิกซ์
ยอดดูที่มาจากลิงก์วิดีโอรีมิกซ์ในโปรแกรมเล่น Shorts
31 ฟีดการถ่ายทอดสดแนวตั้ง
ยอดดูที่มาจากฟีดการถ่ายทอดสดแนวตั้ง
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 – ค่ามิติข้อมูลจะระบุรหัสผลิตภัณฑ์ ซึ่งเป็นรหัสกราฟความรู้ของ Google
  • 26 – ค่ามิติข้อมูลจะระบุแฮชแท็กที่นำไปยังการเข้าชมที่อ้างอิง
  • 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_
This is a core dimension and is subject to the Deprecation Policy.
เพศ (มิติข้อมูลหลัก)
มิติข้อมูลนี้จะระบุเพศของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลรายงาน ค่าที่ถูกต้องคือ 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 คำกระตุ้นการตัดสินใจ
ศูนย์ช่วยเหลือของ YouTube จะให้รายละเอียดเพิ่มเติมเกี่ยวกับคำอธิบายประกอบประเภทต่างๆ รวมถึงกระบวนการเพิ่มคำอธิบายประกอบลงในวิดีโอของคุณ
annotation_id
รหัสที่ YouTube ใช้เพื่อระบุคำอธิบายประกอบโดยไม่ซ้ำกัน

การ์ด

card_type
มิติข้อมูลนี้ระบุประเภทของการ์ดที่แสดงต่อผู้ใช้ ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่เป็นไปได้
ค่า
0 ไม่ทราบ
60 ลิงก์
61 การระดมทุน
62 วิดีโอ
63 เพลย์ลิสต์
65 การให้เงินสนับสนุนของแฟนๆ
66 สินค้า
68 เว็บไซต์ที่เกี่ยวข้อง
69 ช่อง
ศูนย์ช่วยเหลือของ YouTube มีรายละเอียดเพิ่มเติมเกี่ยวกับการ์ดประเภทต่างๆ รวมถึงกระบวนการเพิ่มการ์ดลงในวิดีโอ
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 แถวนี้ประกอบด้วยข้อมูลเกี่ยวกับเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยบุคคลที่สาม