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
ผู้ชมมาจากผลการค้นหาของ 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 ดิกก์
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 ราคุเทน (楽天市場)
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 จะให้รายละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้มิติข้อมูลนี้
Uploader_type (มิติข้อมูลหลัก) (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
มิติข้อมูลนี้จะระบุว่าแถวของข้อมูลมีเมตริกสำหรับเนื้อหาที่เจ้าของเนื้อหาที่ระบุและ/หรือเนื้อหาที่อัปโหลดโดยบุคคลที่สามหรือไม่ เช่น วิดีโอที่ผู้ใช้อัปโหลด ค่าที่ถูกต้องคือ self และ thirdParty นี่คือมิติข้อมูลหลักและอยู่ภายใต้นโยบายการเลิกใช้งาน

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

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