Dimensions

本文定義 YouTube Reporting API 支援的維度。這項 API 可擷取大量報表，內含頻道或內容擁有者的 YouTube 數據分析資料。

維度是用來匯總資料的常見條件，例如使用者活動發生的日期，或使用者所在的國家/地區。

每份大量報表都支援預先定義的維度清單，且在任何報表中，每列資料都有不重複的維度值組合。因此，每個資料列的維度值組合都會做為該資料列的主鍵。您不需要指定報表要包含哪些維度，也沒有指定選項。

核心維度

雖然 YouTube Reporting API 須遵守《服務條款》中定義的廢止政策，但非核心維度 (和非核心指標) 不受該政策規範。在本頁的定義中，任何核心維度都會明確標示為核心維度。

以下列出 API 的核心維度。 這些維度也是 YouTube Analytics API 的核心維度。

詳情請參閱適用於廢止政策的 YouTube API 清單。

尺寸

下列各節定義 YouTube Reporting API 大量報表使用的維度。除非另有說明，否則這些維度會同時用於頻道和內容擁有者報表。

資源

這些維度對應到頻道和內容擁有者在 YouTube 上管理的資源：

video_id (核心維度)
YouTube 影片 ID。在 YouTube Data API 中，這是 video 資源的 id 屬性值。This is a core dimension and is subject to the Deprecation Policy.
playlist_id
YouTube 播放清單的 ID。在 YouTube Data API 中，這是 playlist 資源的 id 屬性值。
channel_id (核心維度)
YouTube 頻道 ID。在 YouTube Data API 中，這是 channel 資源的 id 屬性值。This is a core dimension and is subject to the Deprecation Policy.
asset_id (僅用於內容擁有者報表)
在 YouTube Content ID 系統中管理的資產 ID。在該系統中，資產代表你的智慧財產。在 YouTube 網站上，你可以在 YouTube 內容管理工具中找到資產 ID。你也可以使用 YouTube Content ID API 擷取這些 ID。

地理區域

這些維度可識別與使用者活動、廣告成效或預估收益指標相關聯的地理區域。

country_code (核心維度)
與報表列中指標相關聯的國家/地區。維度值是兩個字母的 ISO-3166-1 國家/地區代碼，例如 US、CN (中國) 或 FR (法國)。如果 YouTube 無法識別相關國家/地區，就會使用國家/地區代碼 ZZ 回報指標。This is a core dimension and is subject to the Deprecation Policy.
province_code
與報表列中指標相關聯的美國州或領地。維度值是 ISO 3166-2 代碼，用於識別美國州別或哥倫比亞特區，例如 US-MI (密西根州) 或 US-TX (德州)。如果 YouTube 無法識別相關聯的美國州別，就會使用省份代碼 US-ZZ 回報指標。

注意：這項維度不支援用於識別美國離島領地的 ISO 3166-2 值，因為這些領地也有自己的 ISO 3166-1 國家/地區代碼。此外，也不支援美國以外國家/地區的行政區。

時間範圍

date (核心維度)
這個維度會指出與各報表列中指標相關聯的日期。在大量報表中，日期是指從太平洋時間凌晨 12:00 開始，到指定日期、月份和年份的太平洋時間晚上 11: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
這個維度會指定播放發生的網址或應用程式。這項維度僅支援在內嵌播放器中發生的觀看，也就是說，只有在維度值為 1 的資料列中，系統才會填入維度值。其他資料列的這個維度值則為空白。

精彩記錄詳細資料

live_or_on_demand
這項維度會指出資料列中的使用者活動指標，是否與現場直播觀看次數相關聯。這個維度提供 2014 年 4 月 1 日起的資料。

下表列出維度值：
值 說明
live 資料列中的資料會說明現場直播期間發生的使用者活動。
onDemand 該列資料說明使用者活動並非發生在現場直播期間。
subscribed_status
這項維度會指出資料列中的使用者活動指標，是否與訂閱影片或播放清單所屬頻道的觀眾相關。 可能的值為 subscribed 和 unsubscribed。

請注意，維度值是使用者活動發生當下的準確值。舉例來說，假設某位使用者尚未訂閱某個頻道，但觀看了該頻道的一部影片，接著訂閱該頻道並觀看另一部影片，而這些動作都在當天完成。頻道的報表指出，其中一個觀看次數的 subscribed_status 值為 subscribed，另一個觀看次數的 subscribed_status 值為 unsubscribed。

流量來源

traffic_source_type
這項維度會識別與使用者活動指標相關聯的參照連結網址類型。參照連結網址類型說明使用者如何連到報表資料列中的影片或頻道。下表列出維度值：
值 說明
0 直接或不明來源
這個值包含直接連往網頁的流量，以及參照網址不明的網頁。在查詢報表中，這類流量來源會標示為 NO_LINK_OTHER 或 UNKNOWN_MOBILE_OR_DIRECT。
1 YouTube 廣告
觀眾是透過廣告連到影片。在流量來源報表中，如果這個維度的值為 1，則 traffic_source_detail 維度會指出向觀眾顯示的廣告類型。在查詢報表中，這類流量來源會標示為 ADVERTISING。可能的值包括：
值 說明
ctp_engagement_ad 隨點即播參與廣告
engagement_ad 參與式廣告
googlemediaads Google 搜尋廣告
insearch_display TrueView 搜尋結果廣告和多媒體廣告
instream TrueView 串流內廣告
instream-select 預訂可略過串流內廣告
unknown 未分類的 YouTube 廣告
video_wall 影片縮圖
yva 首頁影片廣告
3 瀏覽功能
觀眾是從 YouTube 頁面連到影片或頻道。在流量來源報表中，如果這個維度的值為 3，則 traffic_source_detail 維度會識別參照流量的功能。在查詢報表中，這類流量來源會標示為 SUBSCRIBER。可能的值包括：
值 說明
explore YouTube 兒童版：探索
learning YouTube 兒童版：學習
music 音樂動態消息
my-history 觀看記錄
my-subscriptions 訂閱內容
my-uploads 我上傳的內容
podcasts Podcast 主題頁面
shows YouTube Kids：節目
watch-later 稍後觀看
what-to-watch 推薦內容
4 YouTube 頻道
觀眾是從 YouTube 頻道頁面連到你的影片。在流量來源報表中，如果這個維度的值為 4，則 traffic_source_detail 維度會指定該頻道的頻道 ID。在查詢報表中，這類流量來源會標示為 YT_CHANNEL。
5 YouTube 搜尋
觀眾是透過 YouTube 搜尋結果找到你的內容。在流量來源報表中，如果這個維度的值為 5，則 traffic_source_detail 維度會指定相關聯的搜尋字詞。在查詢報表中，這類流量來源會標示為 YT_SEARCH。
7 推薦影片
觀眾是從其他影片觀賞頁面的相關影片清單，連到你的影片。在流量來源報表中，如果這個維度的值為 7，則 traffic_source_detail 維度會識別該影片的影片 ID。在查詢報表中，這類流量來源會標示為 RELATED_VIDEO 或 YT_RELATED。
8 其他 YouTube 功能
觀眾是從不屬於其他流量來源類型的 YouTube 頁面連到你的影片。在流量來源報表中，如果這個維度的值是 8，則 traffic_source_detail 維度會識別網頁網址。在查詢報表中，這類流量來源會標示為 YT_OTHER_PAGE。可能的值包括：
值 說明
creator YouTube 工作室
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 影片上傳後，系統傳送給訂閱者的非推播通知 (例如電子郵件或收件匣通知) 帶來的觀看次數
uploaded_push 影片上傳時，系統向訂閱者傳送推播通知所帶來的觀看次數
18 播放清單頁面
觀看次數來自列出播放清單中所有影片的頁面。在查詢報表中，這類流量來源會標示為 YT_PLAYLIST_PAGE。

請注意，這類流量來源與來源類型 14 不同，後者代表觀看次數是在影片做為播放清單的一部分播放時產生。
19 已聲明版權內容的節目
觀看次數來自已聲明版權、由使用者上傳的影片，內容擁有者使用這些影片宣傳觀看的內容。在查詢報表中，這項流量來源會標示為 CAMPAIGN_CARD。這項流量來源僅支援內容擁有者報表。
20 互動式影片片尾
觀看次數來自其他影片的片尾。在查詢報表中，這類流量來源會標示為 END_SCREEN。
23 精選故事
觀眾在精選故事觀看體驗中，從上一部影片垂直滑動至你的影片。
24 Shorts
觀眾在觀看 Shorts 時，從上一部影片垂直滑動至這部影片。
25 產品頁面
產品頁面上的影片將觀眾帶往其他頻道。
26 主題標記頁面
觀看次數來自 VOD 主題標記頁面或 Shorts 主題標記分類頁面。
27 音效頁面
觀看次數來自 Shorts 音效分類頁面。
28 直播重新導向
源自直播重新導向的觀看次數。
29 Podcast
觀看次數來自 YouTube Podcast 頁面。
30 重混影片
觀看次數來自 Shorts 播放器中的重混影片連結。
31 直式直播動態
源自直式直播動態的觀看次數。
32 相關影片
：觀眾透過 Shorts 播放器中的相關影片連結觀看。
traffic_source_detail
這個維度會提供流量來源的額外詳細資料，也就是該列的 traffic_source_type 維度值。系統會為下列 traffic_source_type 維度值填入這個維度值：
  • 1：這個維度值會指出向觀眾顯示的廣告類型。如需可能值的清單，請參閱 traffic_source_type 定義。
  • 3：這個維度值會指出帶來參照流量的 YouTube 功能。如需可能值的清單，請參閱 traffic_source_type 定義。
  • 4：維度值會指定觀眾來源的頻道 ID。
  • 5：維度值會指定帶來參照流量的搜尋字詞。
  • 7：維度值會指出觀眾是從哪部影片連到你的影片。
  • 8：這個維度值會指出帶來參照流量的 YouTube 網頁類型。如需可能值的清單，請參閱 traffic_source_type 定義。
  • 9：這個維度值會指出流量來源的外部網頁。
  • 17：維度值會指出帶來參照流量的通知類型。如需可能值的清單，請參閱 traffic_source_type 定義。
  • 19：維度值會指出觀眾是從哪部影片連到你的影片。
  • 20：維度值會指出觀眾是從哪部影片連到你的影片。
  • 25：維度值會識別產品 ID，也就是 Google 知識圖譜 ID。
  • 26：維度值會指出帶來參照流量的主題標記。
  • 27：維度值會指出觀眾是從哪部影片連到你的影片。
  • 28：維度值會指定觀眾透過直播重新導向功能，從哪個頻道 ID 導向。
  • 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 任天堂 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
32 VegaOS

客層

客層維度可協助您瞭解觀眾的年齡層和性別分布情形。如要進一步瞭解YouTube Analytics報表中的客層資料，請前往 YouTube 說明中心。

age_group (核心維度)
這項維度會根據報表資料，識別登入使用者的年齡層，包括 YouTube 預估未滿 18 歲的使用者。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.
gender (核心維度)
這項維度會指出與報表資料相關聯的已登入使用者性別。 有效值為 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 樂天 (楽天市場)
38 LiveJournal
39 Odnoklassniki (Одноклассники)
40 tumblr。
42 LinkedIn
43 Google+
44 微博
45 Pinterest
46 電子郵件
47 Facebook Messenger
49 WhatsApp
50 Hangouts
51 Gmail
52 Kakao (Kakao Talk)
53 其他
55 複製到剪貼簿
59 嵌入
60 簡訊
61 Android 訊息
62 Verizon 訊息
63 HTC 簡訊
64 Sony 對話
65 Go SMS
66 LGE 電子郵件
67 Line
68 Viber
69 Kik
70 Skype
71 Blackberry Messenger
72 WeChat
73 KAKAO Story
74 Dropbox
75 Telegram
76 Facebook 粉絲專頁
77 GroupMe
78 Android 電子郵件
79 Motorola 訊息
80 鄰近分享
81 Naver
82 iOS 系統活動對話方塊
83 Google Inbox
84 Android Messenger
85 YouTube Music
86 YouTube Gaming
87 YouTube Kids
88 YouTube TV
89 YouTube 與好友一起看
90 Allo
91 YouTube 社群貼文
92 YouTube 社群轉貼
93 KaiOS 訊息
94 複製/貼上地圖
95 與孩子分享
96 網路系統活動對話方塊
97 Snapchat
98 從 YouTube Music 分享內容到 Snapchat 的預覽畫面
99 分享至 Snapchat 相機
100 Android 系統分享對話方塊
101 儲存至裝置上的相片庫
102 Instagram
103 直接系統活動對話方塊
104 Discord
105 Instagram 限時動態
106 Facebook 限時動態
107 Meet 即時分享
108 Samsung 訊息
109 WhatsApp Business
110 Samsung Notes
111 Google Keep
112 Facebook Lite
113 IMO
114 YouTube Mango
115 Facebook 分享至社團
116 Google Chat
117 邀請播放清單協作者
118 快速分享
119 快速分享 (Samsung)
120 顯示 QR code
121 YouTube Shorts 綠幕
122 分享零廣告體驗
123 Google 應用程式
124 Google Chrome
125 盲測反應
126 邀請連結 (Android)
127 邀請連結 (iOS)
128 重混

詳情請參閱說明文件。

註解

annotation_type
這項維度會指出影片播放期間註解的顯示方式。下表列出可能的維度值：
值 說明
0 不明
1 注意事項
3 精選內容
4 標題
8 對話說明圖示
9 標籤
10 品牌浮水印
11 精選影片
12 精選播放清單
30 行動號召
如要進一步瞭解不同類型的註解，以及在影片中加入註解的程序，請參閱 YouTube 說明中心。
annotation_id
YouTube 用來識別註解的專屬 ID。

資訊卡

card_type
這項維度會指出向使用者顯示的資訊卡類型。下表列出可能的維度值：
值 說明
0 不明
60 連結
61 募款活動
62 影片
63 播放清單
65 粉絲贊助
66 商品
68 關聯網站
69 頻道
YouTube 說明中心提供更多關於不同類型資訊卡的詳細資訊，以及在影片中新增資訊卡的程序。
card_id
YouTube 用來識別資訊卡的專屬 ID。

片尾

end_screen_element_type
這項維度會指出向使用者顯示的片尾元素類型。下表列出片尾元素類型和對應的值：
值 說明
501 影片：宣傳其他 YouTube 影片。
502 播放清單：宣傳 YouTube 播放清單。
503 網站：元素會連結至相關聯的網站。
504 頻道：連結至其他頻道。
505 訂閱：鼓勵觀眾訂閱你的頻道。
506 已連結
507 群眾募資：元素連結至核准的群眾募資網站。
508 商品：元素連結至核准的商品網站。
509 近期上傳：連結至頻道最新上傳的影片。
510 配合觀眾喜好
end_screen_element_id
YouTube 用來識別片尾元素的專屬 ID。

字幕

subtitle_language
這項維度會指出觀看期間使用時間最長的隱藏式輔助字幕語言。如果觀看期間大多關閉隱藏式輔助字幕，則不計入。如要進一步瞭解包含這個維度的報表，請參閱頻道報表或內容擁有者報表的說明文件。
subtitle_language_autotranslated
這項維度會指出觀看期間使用時間最長的自動翻譯隱藏式輔助字幕語言。如果觀看期間大多關閉隱藏式輔助字幕，則不計入。如要進一步瞭解包含這個維度的報表，請參閱頻道報表或內容擁有者報表的說明文件。

廣告成效

廣告類型
「ad_type」維度用於廣告成效報表，會根據影片播放期間放送的廣告類型，匯總要求的指標。 下表列出可能的維度值。如要進一步瞭解 YouTube 廣告格式，請參閱 YouTube 說明中心。
值 說明 查詢報表中的值
1 可略過的影片廣告 (競價) auctionTrueviewInstream
2 多媒體廣告 (競價) auctionDisplay
3 不可略過的影片廣告 (競價) auctionInstream
5 多媒體廣告 (預訂) 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 數據分析資料。
已聲明版權 self 該列包含內容擁有者上傳的著作權聲明內容資料。
已聲明版權 thirdParty 該列包含第三方上傳的著作權聲明內容資料。