Dimensions

เอกสารนี้จะกำหนดมิติข้อมูลซึ่ง YouTube Reporting API รองรับ API นี้จะดึงรายงานจำนวนมากที่มีข้อมูลจากข้อมูลวิเคราะห์ YouTube ของช่องหรือเจ้าของเนื้อหา

มิติข้อมูลคือเกณฑ์ทั่วไปที่ใช้รวบรวมข้อมูล เช่น วันที่เกิดกิจกรรมของผู้ใช้หรือประเทศที่ผู้ใช้อยู่

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

มิติข้อมูลหลัก

แม้ว่า YouTube Reporting API จะเป็นไปตามนโยบายการเลิกใช้งานที่ระบุไว้ในข้อกำหนดในการให้บริการ แต่มิติข้อมูลที่ไม่สําคัญ (และเมตริกที่ไม่สําคัญ) จะไม่อยู่ภายใต้นโยบายนี้ ในคําจํากัดความในหน้านี้ มิติข้อมูลที่เป็นมิติข้อมูลหลักจะระบุไว้อย่างชัดเจน

รายการต่อไปนี้ระบุมิติข้อมูลหลักของ API มิติข้อมูลทั้งหมดเหล่านี้ยังเป็นมิติข้อมูลหลักใน YouTube Analytics API ด้วย

ดูข้อมูลเพิ่มเติมได้ที่รายการ 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 นอกจากนี้ คุณยังดึงข้อมูลโดยใช้ YouTube Content ID API ได้ด้วย

พื้นที่ทางภูมิศาสตร์

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

country_code (มิติข้อมูลหลัก)
ประเทศที่เชื่อมโยงกับเมตริกในแถวรายงาน ค่ามิติข้อมูลคือรหัสประเทศ ISO-3166-1 แบบ 2 อักขระ เช่น 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 เป็นของตัวเองด้วย นอกจากนี้ ระบบยังไม่รองรับเขตการปกครองของประเทศอื่นนอกเหนือจากสหรัฐอเมริกา

ระยะเวลา

date (มิติข้อมูลหลัก)
มิติข้อมูลนี้จะระบุวันที่ที่เชื่อมโยงกับเมตริกในแต่ละแถวของรายงาน ในรายงานกลุ่ม วันที่หมายถึงช่วงเวลาที่เริ่มต้นเวลา 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
มิติข้อมูลนี้ระบุประเภทผู้อ้างอิงที่เชื่อมโยงกับเมตริกกิจกรรมของผู้ใช้ ประเภทผู้อ้างอิงจะอธิบายวิธีที่ผู้ใช้เข้าถึงวิดีโอหรือช่องที่เชื่อมโยงกับแถวข้อมูลในรายงาน ตารางต่อไปนี้แสดงค่าของมิติข้อมูล
ค่า
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 ใน Search และ Display
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
ผู้ชมได้รับการแนะนำจากผลการค้นหาของ 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 Search ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ 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 หน้าเสียง
ยอดดูที่มาจากหน้าเปลี่ยนเส้นทางเสียงของ 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 Tuenti
20 menéame
21 Wykop
22 Skyrock
25 Fotka
28 hi5
31 Twitter
32 Cyworld
34 Blogger
36 VKontakte (ВКонтакте)
37 Rakuten (楽天市場)
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 ข้อความ
61 การรับส่งข้อความของ Android
62 Verizon Messages
63 ข้อความ HTC
64 Sony Conversations
65 Go SMS
66 อีเมล LGE
67 บรรทัด
68 Viber
69 Kik
70 Skype
71 Blackberry Messenger
72 WeChat
73 KAKAO Story
74 Dropbox
75 Telegram
76 หน้า Facebook
77 GroupMe
78 Android Email
79 Motorola Messaging
80 การแชร์ใกล้เคียง
81 Naver
82 กล่องโต้ตอบกิจกรรมของระบบ iOS
83 Google Inbox
84 Android Messages
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 ใช้เพื่อระบุองค์ประกอบของหน้าจอส่วนท้ายโดยไม่ซ้ำกัน

คำบรรยาย

subtitle_language
มิติข้อมูลนี้จะระบุภาษาของคำบรรยายแทนเสียงที่ใช้เป็นเวลานานที่สุดระหว่างการรับชม ระบบจะไม่นับยอดดูที่มีการเปิดคำบรรยายแทนเสียงเป็นส่วนใหญ่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานที่มีมิติข้อมูลนี้ได้ในเอกสารประกอบของรายงานช่องหรือรายงานเจ้าของเนื้อหา
subtitle_language_autotranslated
มิติข้อมูลนี้ระบุภาษาของคำบรรยายแทนเสียงที่แปลอัตโนมัติซึ่งใช้เป็นเวลานานที่สุดระหว่างการรับชม ระบบจะไม่นับยอดดูที่มีการเปิดคำบรรยายแทนเสียงเป็นส่วนใหญ่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานที่มีมิติข้อมูลนี้ได้ในเอกสารประกอบของรายงานช่องหรือรายงานเจ้าของเนื้อหา

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

ad_type
มิติข้อมูล ad_type ใช้ในรายงานประสิทธิภาพโฆษณาและรวบรวมเมตริกที่ขอตามประเภทโฆษณาที่แสดงระหว่างการเล่นวิดีโอ ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่เป็นไปได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบโฆษณาบน YouTube ได้ที่ศูนย์ช่วยเหลือของ YouTube
ค่า คำอธิบาย ค่าในรายงานคำค้นหา
1 โฆษณาวิดีโอแบบข้ามได้ (ประมูล) auctionTrueviewInstream
2 โฆษณาแบบดิสเพลย์ (ประมูล) auctionDisplay
3 โฆษณาวิดีโอแบบข้ามไม่ได้ (ประมูล) auctionInstream
5 โฆษณา Display (สงวนไว้) reservedDisplay
6 โฆษณาวิดีโอแบบข้ามไม่ได้ (จอง) reservedInstream
13 ไม่ทราบ unknown
15 โฆษณาวิดีโอแบบข้ามได้ (จอง) reservedInstreamSelect
19 โฆษณาบัมเปอร์ (การประมูล) auctionBumperInstream
20 โฆษณาบัมเปอร์ (สงวนไว้) reservedBumperInstream

หมายเหตุ: รายงานข้อความค้นหาอาจแสดงโฆษณาบางประเภทเพิ่มเติมที่เคยใช้ใน YouTube ก่อนหน้านี้

มิติข้อมูลเจ้าของเนื้อหา

มิติข้อมูลต่อไปนี้ใช้ในรายงานของเจ้าของเนื้อหาเท่านั้น

claimed_status (ใช้ในรายงานของเจ้าของเนื้อหาเท่านั้น)
มิติข้อมูลนี้ระบุว่าแถวข้อมูลมีเฉพาะเมตริกสําหรับเนื้อหาที่อ้างสิทธิ์เท่านั้น ค่าที่ใช้ได้ค่าเดียวสำหรับมิติข้อมูลนี้คือ claimed ตารางในคําจํากัดความของมิติข้อมูล uploader_type มีรายละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้มิติข้อมูลนี้
uploader_type (มิติข้อมูลหลัก) (ใช้ในรายงานของเจ้าของเนื้อหาเท่านั้น)
มิติข้อมูลนี้ระบุว่าแถวข้อมูลมีเมตริกสําหรับเนื้อหาที่เจ้าของเนื้อหาที่ระบุและ/หรือเนื้อหาที่อัปโหลดโดยบุคคลที่สาม เช่น วิดีโอที่ผู้ใช้อัปโหลด หรือไม่ ค่าที่ใช้ได้คือ self และ thirdParty มิติข้อมูลนี้เป็นมิติข้อมูลหลักและอยู่ภายใต้นโยบายการเลิกใช้งาน

ตารางด้านล่างแสดงชุดค่าผสมที่รองรับสําหรับมิติข้อมูล claimed_status และ uploader_type

ค่า claimed_status ค่า uploader_type คำอธิบาย
[ไม่ได้ตั้งค่า] self แถวนี้มีข้อมูล YouTube Analytics สำหรับเนื้อหาที่อ้างสิทธิ์และไม่ได้อ้างสิทธิ์ซึ่งเจ้าของเนื้อหาอัปโหลด
มีการอ้างสิทธิ์ self แถวนี้มีข้อมูลของเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา
มีการอ้างสิทธิ์ thirdParty แถวนี้มีข้อมูลของเนื้อหาที่อ้างสิทธิ์ซึ่งอัปโหลดโดยบุคคลที่สาม