เอกสารนี้จะแสดงมิติข้อมูลที่ YouTube Reporting API รองรับ API นี้จะดึงรายงานจำนวนมากที่มีข้อมูลจากข้อมูลวิเคราะห์ YouTube ของช่องหรือเจ้าของเนื้อหา
มิติข้อมูลคือเกณฑ์ทั่วไปที่ใช้ในการรวมข้อมูล เช่น วันที่เกิดกิจกรรมของผู้ใช้หรือประเทศที่ผู้ใช้อยู่
รายงานจำนวนมากแต่ละรายการรองรับรายการมิติข้อมูลที่กำหนดไว้ล่วงหน้า และในรายงานแต่ละรายการ ข้อมูลแต่ละแถวจะมีชุดค่าผสมของค่ามิติข้อมูลที่ไม่ซ้ำกัน ด้วยเหตุนี้ ชุดค่าผสมของค่ามิติข้อมูลของแต่ละแถวจึงทำหน้าที่เป็นคีย์หลักสำหรับแถวนั้น คุณไม่จำเป็นต้องระบุและไม่มีตัวเลือกในการระบุมิติข้อมูลที่จะรวมไว้ในรายงาน
มิติข้อมูลหลัก
แม้ว่า YouTube Reporting API จะอยู่ภายใต้นโยบายการเลิกใช้งานที่ระบุไว้ในข้อกำหนดในการให้บริการ แต่มิติข้อมูลที่ไม่ใช่หลัก (และเมตริกที่ไม่ใช่หลัก) จะไม่อยู่ภายใต้นโยบายดังกล่าว ในคําจํากัดความในหน้านี้ มิติข้อมูลใดๆ ที่เป็นมิติข้อมูลหลักจะได้รับการระบุไว้อย่างชัดเจน
รายการต่อไปนี้จะระบุมิติข้อมูลหลักของ API นอกจากนี้ มิติข้อมูลทั้งหมดเหล่านี้ยังเป็นมิติข้อมูลหลักใน YouTube Analytics API ด้วย
ดูข้อมูลเพิ่มเติมได้ที่รายการ API ของ YouTube ที่อยู่ภายใต้นโยบายการเลิกใช้งาน
ขนาด
ส่วนต่อไปนี้จะอธิบายมิติข้อมูลที่ใช้ในรายงานจำนวนมากของ YouTube Reporting API มิติข้อมูลเหล่านี้ใช้ในทั้งรายงานช่องและรายงานเจ้าของเนื้อหา เว้นแต่จะระบุไว้เป็นอย่างอื่น
แหล่งข้อมูล
มิติข้อมูลเหล่านี้สอดคล้องกับแหล่งข้อมูลที่ช่องและเจ้าของเนื้อหาจัดการบน YouTube ดังนี้
- video_id (มิติข้อมูลหลัก)
- รหัสของวิดีโอ YouTube ใน YouTube Data API ค่านี้คือค่าของพร็อพเพอร์ตี้
idของทรัพยากรvideoThis 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ของทรัพยากรchannelThis is a core dimension and is subject to the Deprecation Policy. - asset_id (ใช้ในรายงานของเจ้าของเนื้อหาเท่านั้น)
- รหัสของเนื้อหาที่จัดการในระบบ Content ID ของ YouTube เนื้อหาคือตัวแทนทรัพย์สินทางปัญญาของคุณในระบบนั้น ในเว็บไซต์ YouTube คุณจะดูรหัสเนื้อหาได้ในระบบจัดการเนื้อหาของ YouTube นอกจากนี้ คุณยังเรียกดูรายงานดังกล่าวได้โดยใช้ API สำหรับ Content ID ของ YouTube
พื้นที่ทางภูมิศาสตร์
มิติข้อมูลเหล่านี้จะระบุภูมิภาคที่เชื่อมโยงกับกิจกรรมของผู้ใช้ ประสิทธิภาพโฆษณา หรือเมตริกรายได้โดยประมาณ
- 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 11ข้อมูลนี้เกี่ยวข้องกับยอดดูที่เกิดขึ้นในฟีดการถ่ายทอดสดแนวตั้ง 12ข้อมูลนี้เกี่ยวข้องกับยอดดูที่เกิดขึ้นในแท็บลองฟังของ YouTube Music - 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_DIRECT1การโฆษณาบน YouTube
ผู้ชมได้รับการแนะนำวิดีโอจากโฆษณา ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ1มิติข้อมูล traffic_source_detail จะระบุประเภทของโฆษณาที่แสดงต่อผู้ชม ในรายงานการค้นหา ระบบจะระบุประเภทแหล่งที่มาของการเข้าชมนี้เป็นADVERTISINGค่าที่เป็นไปได้มีดังนี้ค่า คำอธิบาย ctp_engagement_adโฆษณาเพื่อการมีส่วนร่วมแบบคลิกเพื่อเล่น engagement_adโฆษณาเพื่อการมีส่วนร่วม googlemediaadsโฆษณา Google Search insearch_displayTrueView ในผลการค้นหาและในดิสเพลย์ instreamTrueView ในสตรีม 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_CHANNEL5การค้นหาบน YouTube
ผู้ชมได้รับการอ้างอิงจากผลการค้นหาบน YouTube ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ5มิติข้อมูล traffic_source_detail จะระบุข้อความค้นหาที่เกี่ยวข้อง ในรายงานการค้นหา ระบบจะระบุประเภทแหล่งที่มาของการเข้าชมนี้เป็นYT_SEARCH7วิดีโอแนะนำ
ผู้ชมได้รับการแนะนำจากรายการวิดีโอที่เกี่ยวข้องในหน้าดูวิดีโออื่น ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ7มิติข้อมูล traffic_source_detail จะระบุรหัสวิดีโอของวิดีโอนั้น ในรายงานการค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะระบุเป็นRELATED_VIDEOหรือYT_RELATED8ฟีเจอร์อื่นๆ ของ YouTube
ผู้ชมได้รับการอ้างอิงจากหน้า YouTube ที่ไม่ตรงกับประเภทแหล่งที่มาของการเข้าชมอื่นๆ ที่ระบุไว้ ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ8มิติข้อมูล traffic_source_detail จะระบุ URL ของหน้าเว็บ ในรายงานการค้นหา ระบบจะระบุประเภทแหล่งที่มาของการเข้าชมนี้เป็นYT_OTHER_PAGEค่าที่เป็นไปได้มีดังนี้ค่า คำอธิบาย creatorCreator Studio g-crecช่องแนะนำ offlineออฟไลน์ promotionการโปรโมตพาร์ทเนอร์ unknownไม่ทราบ widgetวิดเจ็ตหน้าจอหลักของ Android youtu.beyoutu.be ytremoteรีโมต YouTube 9ภายนอก
ผู้ชมได้รับการแนะนำจากลิงก์ในเว็บไซต์อื่น แหล่งที่มาของการเข้าชมนี้รวมถึงการอ้างอิงจากผลการค้นหาของ Google Search ในรายงานแหล่งที่มาของการเข้าชม หากค่าของมิติข้อมูลนี้คือ9มิติข้อมูล traffic_source_detail จะระบุหน้าเว็บภายนอก ในรายงานการค้นหา ระบบจะระบุประเภทแหล่งที่มาของการเข้าชมนี้เป็นEXT_URL11การ์ดวิดีโอและคำอธิบายประกอบ
ผู้ชมได้รับการแนะนำโดยการคลิกคำอธิบายประกอบหรือการ์ดในวิดีโออื่น ในรายงานการค้นหา ระบบจะระบุประเภทแหล่งที่มาของการเข้าชมนี้เป็นANNOTATION14เพลย์ลิสต์
ยอดดูที่เกิดขึ้นขณะเล่นวิดีโอซึ่งเป็นส่วนหนึ่งของเพลย์ลิสต์ ในรายงานการค้นหา ประเภทแหล่งที่มาของการเข้าชมนี้จะระบุเป็นPLAYLIST
โปรดทราบว่าแหล่งที่มาของการเข้าชมนี้แตกต่างจากประเภทแหล่งที่มา18ซึ่งระบุว่ายอดดูมาจากหน้าที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์17การแจ้งเตือน
ผู้ชมได้รับการอ้างอิงจากอีเมลหรือการแจ้งเตือนจาก YouTube ในรายงานการค้นหา ระบบจะระบุประเภทแหล่งที่มาของการเข้าชมนี้เป็นNOTIFICATIONค่าที่เป็นไปได้มีดังนี้ค่า คำอธิบาย inboxpushsdigยอดดูที่มาจากการแจ้งเตือนซึ่งเป็นส่วนหนึ่งของสรุปสำหรับผู้ติดตาม uploaded_otherยอดดูที่มาจากข้อความที่ไม่ใช่ข้อความ Push เช่น อีเมลหรือการแจ้งเตือนในกล่องจดหมาย ซึ่งส่งถึงผู้ติดตามเมื่อมีการอัปโหลดวิดีโอ uploaded_pushยอดดูที่มาจากข้อความ Push ที่ส่งถึงผู้ติดตามเมื่อมีการอัปโหลดวิดีโอ 18หน้าเพลย์ลิสต์
ยอดดูที่มาจากหน้าเว็บที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์ ในรายงานการค้นหา แหล่งที่มาของการเข้าชมประเภทนี้จะระบุเป็นYT_PLAYLIST_PAGE
โปรดทราบว่าแหล่งที่มาของการเข้าชมนี้แตกต่างจากประเภทแหล่งที่มา14ซึ่งบ่งชี้ว่ายอดดูเกิดขึ้นขณะที่วิดีโอเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์19การจัดโปรแกรมจากเนื้อหาที่มีการอ้างสิทธิ์
ยอดดูที่มาจากวิดีโอที่มีการอ้างสิทธิ์ซึ่งผู้ใช้อัปโหลด ซึ่งเจ้าของเนื้อหาใช้เพื่อโปรโมตเนื้อหาที่มีการดู ในรายงานการค้นหา แหล่งที่มาของการเข้าชมนี้จะระบุเป็นCAMPAIGN_CARDแหล่งที่มาของการเข้าชมนี้รองรับเฉพาะรายงานของเจ้าของเนื้อหาเท่านั้น20End Screen ของวิดีโอแบบอินเทอร์แอกทีฟ
ยอดดูที่มาจาก End Screen ของวิดีโออื่น ในรายงานการค้นหา ระบบจะระบุประเภทแหล่งที่มาของการเข้าชมนี้เป็นEND_SCREEN23เรื่องราว
ผู้ชมได้รับการอ้างอิงโดยการปัดในแนวตั้งจากวิดีโอก่อนหน้าในประสบการณ์การดูเรื่องราว24Shorts
ผู้ชมได้รับการแนะนำโดยการปัดวิดีโอก่อนหน้าในแนวตั้งในประสบการณ์การรับชม Shorts25หน้าสินค้า
วิดีโอในหน้าสินค้าพาผู้ชมไปยังช่องอื่น26หน้าแฮชแท็ก
ยอดดูที่มาจากหน้าแฮชแท็กของ VOD หรือหน้า Pivot Page สำหรับแฮชแท็กของ Shorts27หน้าเสียง
ยอดดูที่มาจากหน้า Pivot Page ของเสียงใน Shorts28การส่งผู้ชมแบบสด
ยอดดูที่มาจากการส่งผู้ชมแบบสด29พอดแคสต์
ยอดดูที่มาจากหน้าพอดแคสต์บน YouTube30วิดีโอรีมิกซ์
ยอดดูที่มาจากลิงก์วิดีโอรีมิกซ์ในเพลเยอร์ Shorts31ฟีดการถ่ายทอดสดแนวตั้ง
ยอดดูที่มาจากฟีดการถ่ายทอดสดแนวตั้ง32วิดีโอที่เกี่ยวข้อง
ยอดดูที่มาจากลิงก์วิดีโอที่เกี่ยวข้องในเพลเยอร์ Shorts - traffic_source_detail
- มิติข้อมูลนี้ให้รายละเอียดเพิ่มเติมเกี่ยวกับแหล่งที่มาของการเข้าชมซึ่งเป็นค่ามิติข้อมูล traffic_source_type ของแถว ระบบจะป้อนค่ามิติข้อมูลนี้สําหรับค่ามิติข้อมูล traffic_source_type ต่อไปนี้
1– ค่ามิติข้อมูลจะระบุประเภทของโฆษณาที่แสดงต่อผู้ชม ดูรายการค่าที่เป็นไปได้ในคำจำกัดความของ traffic_source_type3– ค่ามิติข้อมูลจะระบุฟีเจอร์ของ YouTube ที่ทำให้เกิดการเข้าชมที่อ้างอิง ดูรายการค่าที่เป็นไปได้ในคำจำกัดความของ traffic_source_type4– ค่ามิติข้อมูลจะระบุรหัสช่องที่อ้างอิงผู้ชม5– ค่ามิติข้อมูลจะระบุข้อความค้นหาที่ทำให้เกิดการเข้าชมที่อ้างอิง7– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชม8– ค่ามิติข้อมูลจะระบุประเภทของหน้า YouTube ที่นำไปสู่การเข้าชมที่อ้างอิง ดูรายการค่าที่เป็นไปได้ในคำจำกัดความของ traffic_source_type9– ค่ามิติข้อมูลจะระบุหน้าเว็บภายนอกที่อ้างอิงการเข้าชม17– ค่ามิติข้อมูลจะระบุประเภทการแจ้งเตือนที่ทำให้เกิดการเข้าชมที่อ้างอิง ดูรายการค่าที่เป็นไปได้ในคำจำกัดความของ traffic_source_type19– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชมมา20– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชม25– ค่ามิติข้อมูลจะระบุรหัสสินค้า ซึ่งเป็นรหัส Google กราฟความรู้26– ค่ามิติข้อมูลจะระบุแฮชแท็กที่นำไปสู่การเข้าชมที่อ้างอิง27– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชม28– ค่ามิติข้อมูลจะระบุรหัสช่องที่ผู้ชมได้รับการแนะนำผ่านการส่งผู้ชมแบบสด30– ค่ามิติข้อมูลจะระบุวิดีโอที่อ้างอิงผู้ชมมา
อุปกรณ์
- device_type
- มิติข้อมูลนี้ระบุรูปแบบของอุปกรณ์ที่เกิดการดู
ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่ถูกต้อง
ค่า คำอธิบาย 100ไม่ทราบ 101คอมพิวเตอร์ 102ทีวี 103คอนโซลเกม 104โทรศัพท์มือถือ 105แท็บเล็ต - operating_system
- มิติข้อมูลนี้ระบุระบบซอฟต์แวร์ของอุปกรณ์ที่เกิดการดู
ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่ถูกต้อง
ค่า คำอธิบาย 1อื่นๆ 2Windows 3Windows Mobile 4Android 5iOS 6Symbian 7BlackBerry 9Macintosh 10PlayStation 11Bada 12WebOS 13Linux 14Hiptop 15MeeGo 16Wii 17Xbox 18PlayStation Vita 19สมาร์ททีวี 20Nintendo 3DS 21Chromecast 22Tizen 23Firefox 24RealMedia 25KaiOS 26Roku 27Nintendo Switch 28Apple tvOS 29Fire OS 30ChromeOS 31Vidaa 32VegaOS
ข้อมูลประชากร
มิติข้อมูลประชากรช่วยให้คุณเข้าใจช่วงอายุและการแจกแจงเพศของกลุ่มเป้าหมาย ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลประชากรในรายงาน YouTube Analytics
- age_group (มิติข้อมูลหลัก)
- มิติข้อมูลนี้ระบุกลุ่มอายุของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลการรายงาน และรวมถึงผู้ใช้ที่ YouTube คาดว่ามีอายุต่ำกว่า 18 ปี API ใช้กลุ่มอายุดังต่อไปนี้
AGE_13_17AGE_18_24AGE_25_34AGE_35_44AGE_45_54AGE_55_64AGE_65_
- gender (มิติข้อมูลหลัก)
- มิติข้อมูลนี้ระบุเพศของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลการรายงาน
ค่าที่ถูกต้องคือ
FEMALE,MALEและGENDER_OTHERThis 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ไม่ทราบ 1Digg 4reddit 5StumbleUpon 6mixi 7Yahoo! ญี่ปุ่น 8goo 9Ameba 10Facebook 11Myspace 12NUjij 18Tuenti 20menéame 21Wykop 22Skyrock 25Fotka 28hi5 31Twitter 32Cyworld 34Blogger 36VKontakte (ВКонтакте) 37Rakuten (楽天市場) 38LiveJournal 39Odnoklassniki (Одноклассники) 40tumblr 42Linkedin 43Google+ 44Weibo 45Pinterest 46อีเมล 47Facebook Messenger 49WhatsApp 50Hangouts 51Gmail 52Kakao (Kakao Talk) 53อื่นๆ 55คัดลอกไปยังคลิปบอร์ด 59ฝัง 60ข้อความ 61การรับส่งข้อความใน Android 62Verizon Messages 63ข้อความ HTC 64Sony Conversations 65Go SMS 66อีเมล LGE 67บรรทัด 68Viber 69Kik 70Skype 71Blackberry Messenger 72WeChat 73KAKAO Story 74ดรอปบ็อกซ์ 75Telegram 76หน้า Facebook 77GroupMe 78อีเมล Android 79Motorola Messaging 80การแชร์ใกล้เคียง 81Naver 82กล่องโต้ตอบกิจกรรมของระบบ iOS 83กล่องจดหมาย Google 84Android Messenger 85YouTube Music 86YouTube Gaming 87YouTube Kids 88YouTube TV 89ฟีเจอร์ดู YouTube กับเพื่อนๆ 90Allo 91โพสต์ชุมชน YouTube 92รีโพสต์ในชุมชน YouTube 93ข้อความ KaiOS 94คัดลอก/วาง Maps 95แชร์กับบุตรหลาน 96กล่องโต้ตอบกิจกรรมของระบบบนเว็บ 97Snapchat 98แชร์จาก YouTube Music ไปยังพรีวิว Snapchat 99แชร์ไปยังกล้อง Snapchat 100กล่องโต้ตอบการแชร์ของระบบ Android 101บันทึกลงในที่เก็บรูปภาพบนอุปกรณ์ 102Instagram 103กล่องโต้ตอบกิจกรรมของระบบโดยตรง 104Discord 105Instagram Stories 106Facebook Stories 107การแชร์สดของ Meet 108Samsung Messages 109WhatsApp Business 110Samsung Notes 111Google Keep 112Facebook Lite 113IMO 114YouTube Mango 115แชร์ไปยังกลุ่ม Facebook 116Google Chat 117เชิญผู้ร่วมสร้างเพลย์ลิสต์ 118Quick Share 119Quick Share (Samsung) 120คิวอาร์โค้ดที่แสดง 121กรีนสกรีนของ YouTube Shorts 122แชร์แบบไม่มีโฆษณา 123แอป Google 124Google Chrome 125รีแอ็กชันแบบไม่เห็นหน้าจอ 126ลิงก์คำเชิญ (Android) 127ลิงก์คำเชิญ (iOS) 128รีมิกซ์
ดูข้อมูลเพิ่มเติมได้ในเอกสารความช่วยเหลือ
คำอธิบายประกอบ
- annotation_type
- มิติข้อมูลนี้ระบุลักษณะที่คำอธิบายประกอบแสดงในระหว่างวิดีโอ ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่เป็นไปได้
ศูนย์ช่วยเหลือของ YouTube มีรายละเอียดเพิ่มเติมเกี่ยวกับคำอธิบายประกอบประเภทต่างๆ รวมถึงขั้นตอนการเพิ่มคำอธิบายประกอบลงในวิดีโอค่า คำอธิบาย 0ไม่ทราบ 1หมายเหตุ 3สปอตไลท์ 4ชื่อ 8ลูกโป่งคำพูด 9ป้ายกำกับ 10ลายน้ำของแบรนด์ 11วิดีโอเด่น 12เพลย์ลิสต์เด่น 30คำกระตุ้นการตัดสินใจ - annotation_id
- รหัสที่ YouTube ใช้เพื่อระบุคำอธิบายประกอบที่ไม่ซ้ำกัน
การ์ด
- card_type
- มิติข้อมูลนี้ระบุประเภทของการ์ดที่แสดงต่อผู้ใช้ ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่เป็นไปได้
ศูนย์ช่วยเหลือของ YouTube มีรายละเอียดเพิ่มเติมเกี่ยวกับการ์ดประเภทต่างๆ รวมถึงขั้นตอนการเพิ่มการ์ดลงในวิดีโอค่า คำอธิบาย 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โฆษณาวิดีโอแบบข้ามได้ (ประมูล) auctionTrueviewInstream2โฆษณาแบบดิสเพลย์ (ประมูล) auctionDisplay3โฆษณาวิดีโอแบบข้ามไม่ได้ (ประมูล) auctionInstream5โฆษณา Display (จอง) reservedDisplay6โฆษณาวิดีโอแบบข้ามไม่ได้ (จอง) reservedInstream13ไม่ทราบ unknown15โฆษณาวิดีโอแบบข้ามได้ (จอง) reservedInstreamSelect19โฆษณาบัมเปอร์ (การประมูล) auctionBumperInstream20โฆษณาบัมเปอร์ (จอง) reservedBumperInstreamหมายเหตุ: รายงานการค้นหาอาจแสดงผลสำหรับประเภทโฆษณาเพิ่มเติมบางประเภทที่เคยใช้ใน YouTube
มิติข้อมูลเจ้าของเนื้อหา
มิติข้อมูลต่อไปนี้ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น
- claimed_status (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
- มิติข้อมูลนี้ระบุว่าแถวของข้อมูลมีเฉพาะเมตริกสำหรับเนื้อหาที่มีการอ้างสิทธิ์เท่านั้น ค่าที่ถูกต้องเพียงค่าเดียวสำหรับมิติข้อมูลนี้คือ
claimedตารางในคําจํากัดความของมิติข้อมูลuploader_typeจะให้รายละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้มิติข้อมูลนี้
- uploader_type (มิติข้อมูลหลัก) (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
- มิติข้อมูลนี้ระบุว่าแถวของข้อมูลมีเมตริกสำหรับเนื้อหาที่อัปโหลดโดยเจ้าของเนื้อหาที่ระบุและ/หรือเนื้อหาที่อัปโหลดโดยบุคคลที่สาม เช่น วิดีโอที่ผู้ใช้อัปโหลดหรือไม่ ค่าที่ถูกต้องคือ
selfและthirdPartyมิติข้อมูลนี้เป็นมิติข้อมูลหลักและขึ้นอยู่กับนโยบายการเลิกใช้งาน
ตารางต่อไปนี้แสดงชุดค่าผสมที่รองรับสำหรับมิติข้อมูลclaimed_statusและuploader_type
ค่า claimed_statusค่า uploader_typeคำอธิบาย [ไม่ได้ตั้งค่า] self แถวนี้มีข้อมูลวิเคราะห์ YouTube สำหรับเนื้อหาที่อ้างสิทธิ์และไม่ได้อ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา มีการอ้างสิทธิ์ self แถวนี้มีข้อมูลสำหรับเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา มีการอ้างสิทธิ์ thirdParty แถวนี้มีข้อมูลสำหรับเนื้อหาที่อ้างสิทธิ์ซึ่งอัปโหลดโดยบุคคลที่สาม