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 (法國)。如果 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 國家/地區代碼。此外，這項功能也不支援美國以外國家/地區的次級行政區。

時間範圍

日期 (核心維度)
這個維度會指出每個報表列中指標的相關日期。在大量報表中，日期是指從太平洋時間凌晨 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 動態的觀看次數有關。
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 兒童：探索
learning 兒童：學習
music 音樂動態消息
my-history 觀看記錄
my-subscriptions 訂閱內容
my-uploads 我上傳的內容
podcasts Podcast 專頁
shows 兒童節目
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 主題標記頁面
來自 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 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
32 VegaOS

客層

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

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 樂天 (楽天市場)
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 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 電子郵件
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

詳情請參閱說明文件。

註解

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 商品 - 連結至 YouTube 核准的商品網站。
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 維度定義中的表格提供更多關於如何使用這個維度的詳細資料。
上傳者類型 (核心維度) (僅用於內容擁有者報表)
這個維度會指出資料列是否包含指定內容擁有者上傳的內容指標，以及/或是第三方上傳的內容指標，例如使用者上傳的影片。有效值為 self 和 thirdParty。這是核心維度，適用於淘汰政策。

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

claimed_status值 uploader_type值 說明
[未設定] self 這個資料列包含內容擁有者上傳的已聲明著作權和未聲明著作權內容的 YouTube 數據分析資料。
已聲明版權 self 該列包含內容擁有者上傳的已聲明版權內容資料。
已聲明版權 thirdParty 該列包含第三方上傳的已聲明著作權內容資料。