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 擷取這些內容。

地理區域

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

country_code (核心維度)
與報表列中的指標相關聯的國家/地區。維度值是兩個字母組成的 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 (德州)。如果 YouTube 無法辨識相關美國州別，系統會使用州/省代碼 US-ZZ 來回報相關指標。

注意：這個維度不支援用於識別美國外界區域的 ISO 3166-2 值，因為這些地區也有自己的 ISO 3166-1 國家/地區代碼。而且不支援美國以外的國家/地區的子行政區。

時間範圍

日期 (核心維度)
這個維度代表與各報表列中的指標相關聯的日期。大量 報表的日期是指從太平洋時間凌晨 12 點開始，結束日期為 太平洋時間指定日、月份和年度晚上 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 動態平台上的觀看次數。
playback_location_detail
這個維度可指定播放內容的網址或應用程式。這個維度僅適用於出現在內嵌播放器中的觀看次數，也就是說，維度值只會在維度值為 1 的列中填入。在其他資料列中，這項維度的值為空白。

播放詳細資料

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

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

請注意，維度值是使用者活動發生當下的準確資料。舉例來說，假設使用者尚未訂閱某個頻道，並觀看該頻道的其中一部影片，然後又訂閱頻道，並觀看了另一部影片，而且這一天全都在同一天。 該管道的報表指出，一次觀看的 subscribed_status 值為 subscribed，而 1 次觀看的 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 孩子：探索
learning YouTube Kids：學習
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。可能的值包括：
值
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 主題標記頁面
這些觀看次數來自隨選影片主題標記頁面或 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：維度值會指定觀眾參照的頻道 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 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.
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 挖掘
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 福卡
28 hi5
31 Twitter
32 熱帶風情
34 Blogger
36 VKontakte (hijackонтакте)
37 樂天 (院空區)
38 LiveJournal
39 奧德諾克拉斯尼文 (🇨?днокласкики)
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 前往簡訊
66 LGE 電子郵件
67 折線圖
68 Viber
69 Kik
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 用來識別註解的 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 群眾募資 - 元素會連結至 YouTube 核准的群眾募資網站。
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 上使用，查詢報表可能會傳回。

內容擁有者維度

下列維度僅適用於內容擁有者報表。

Copyright_status (僅適用於內容擁有者報表)
這個維度代表一列只包含已聲明版權內容的指標。這個維度的唯一有效值是 claimed。「uploader_type」維度定義中的表格提供了更詳細的使用方式。
Upload_type (核心維度) (僅適用於內容擁有者報表)
這個維度可指出資料的資料列是否包含指定內容擁有者上傳內容和/或第三方上傳內容 (例如使用者上傳的影片) 的指標。有效值為 self 和 thirdParty。這是一項核心維度，且須遵守《廢止政策》。

下表列出 claimed_status 和 uploader_type 維度支援的組合：

claimed_status 值 uploader_type 值 說明
[未設定] 自己 針對由內容擁有者所上傳且已聲明著作權和未聲明版權的內容，每列包含 YouTube 數據分析資料。
已聲明版權 自己 這一列包含內容擁有者所上傳內容的已聲明版權內容相關資料。
已聲明版權 thirdParty 這一列包含已聲明版權內容 (由第三方上傳) 的相關資料。