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 [播放清單 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 內容管理員中找到資產 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.
vintcode [省代碼]
與報表列指標相關的美國州/省或領土。維度值是 ISO 3166-2 代碼，可用來識別美國各州或哥倫比亞特區，例如 US-MI (密西根州) 或 US-TX (德州)。省代碼 US-ZZ 可用於回報 YouTube 無法辨識相關美國州別的指標。

注意：由於這個國家/地區也有自己的 ISO 3166-1 國家/地區代碼，因此不支援這個可識別美國外域的 ISO 3166-2 值。本區也不支援美國以外的國家/地區。

時間範圍

日期 (核心維度)
這個維度可識別每個報表列中的指標相關日期。在大量報表中，日期是指從太平洋時間 (太平洋時間) 午夜 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 官方應用程式 (例如 Android 版 YouTube 應用程式) 中發生的活動。
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 播客實際連結網頁
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 維度可用來識別該影片的影片 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 即時重新導向
來自直播重新導向的觀看次數。
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。

裝置

裝置類型
這個維度可識別發生觀看次數的裝置實體板型規格。 下表列出有效維度值：
值
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

客層

客層維度有助於瞭解目標對象的年齡層和性別分佈情形。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 西吉
18 坦蒂文
20 Menéame
21 威科普 (Wykop)
22 天空搖滾
25 福塔
28 hi5
31 Twitter
32 世界世界
34 Blogger
36 VKontakte (QHКонтакте)
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 Talk)
53 其他
55 複製到剪貼簿
59 嵌入
60 簡訊
61 Android 訊息傳遞
62 Verizon 訊息
63 HTC 簡訊
64 Sony 對話
65 傳送簡訊
66 LGE 電子郵件
67 折線圖
68 Viber
69 Kik
70 Skype
71 黑莓 Messenger
72 WeChat
73 KAKAO 故事
74 Dropbox
75 Telegram
76 Facebook 專頁
77 群組我
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 群眾募資 - 這項元素連結到經核准的群眾募資網站。
508 商品 - 元素會連結到已核准的商品網站。
509 最新上傳 - 元素連結至您的頻道最近上傳的影片。
510 最符合觀眾喜好
end_screen_element_id
YouTube 在用來識別片尾元素時使用的 ID。

字幕

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 維度定義中的表格會進一步說明如何使用這個維度。
upload_type (核心維度) (僅適用於內容擁有者報表)
這個維度代表某列的資料是否包含特定內容擁有者所上傳的內容，以及/或是第三方上傳的內容 (例如使用者上傳的影片)。有效值為 self 和 thirdParty。這是核心維度，受到廢止政策規範。

下表顯示 claimed_status 和 uploader_type 維度支援的組合：

claimed_status 值 uploader_type 值 說明
[未設定] 自己 此資料列包含由內容擁有者上傳的已聲明版權和未聲明版權的內容的 YouTube 數據分析資料。
已聲明版權 自己 此資料列包含由內容擁有者上傳的已聲明版權內容資料。
已聲明版權 第三方 此資料列包含由第三方上傳的已聲明版權內容資料。