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 國家/地區代碼,例如 USCN (中國) 或 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 國家/地區代碼。也不支援美國以外國家/地區的細分區域。

時間範圍

日期 (核心維度)
這個維度代表與每個報表列中的指標相關聯的日期。在大量報表中,日期是指從太平洋時間凌晨 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 官方應用程式 (例如 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
這個維度指出資料列中的使用者活動指標是否與訂閱影片或播放清單頻道的觀眾相關聯。 可能的值為 subscribedunsubscribed

請注意,維度值是使用者活動發生當下的準確資料。舉例來說,假設使用者尚未訂閱某個頻道,在觀看該頻道的影片後,又訂閱了該頻道,並觀看了另一部影片,而且全都在同一天內完成。 管道報表指出有一項資料檢視的 subscribed_status 值為 subscribed,而一項資料檢視的 subscribed_status 值為 unsubscribed

流量來源

traffic_source_type
這個維度可找出與使用者活動指標相關聯的參照網址類型。參照網址類型會針對與報表中的資料列,指出使用者觸及影片或頻道的方式。下表列出維度值:
0 直接或不明
這個值涵蓋網頁的直接流量和參照網址不明的網頁。在查詢報表中,這個流量來源類型會標示為 NO_LINK_OTHERUNKNOWN_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」traffic_source_detail維度會指出帶來流量的功能。在查詢報表中,這個流量來源類型會標示為 SUBSCRIBER。可能的值包括:
explore 兒童:探索
learning 兒童:學習
music 音樂動態消息
my-history 觀看記錄
my-subscriptions 我的訂閱內容
my-uploads 我的上傳內容
podcasts Podcast 到達網頁
shows YouTube Kids:節目
watch-later 稍後觀看
what-to-watch 推薦內容
4 YouTube 頻道
觀眾透過 YouTube 頻道頁面吸引更多觀眾。在流量來源報表中,如果這個維度的值是 4,則「traffic_source_detail」traffic_source_detail維度就會指定該管道的管道 ID。在查詢報表中,這個流量來源類型會標示為 YT_CHANNEL
5 YouTube 搜尋
觀眾透過 YouTube 搜尋結果找到你的影片。在流量來源報表中,如果這個維度的值是 5,則「traffic_source_detail」traffic_source_detail維度會指定相關搜尋字詞。在查詢報表中,這個流量來源類型會標示為 YT_SEARCH
7 推薦影片
觀眾是透過其他影片觀賞頁面上的相關影片資訊吸引到觀眾。在流量來源報表中,如果這個維度的值是 7,「traffic_source_detail」維度就會識別該影片的影片 ID。在查詢報表中,這個流量來源類型會標示為 RELATED_VIDEOYT_RELATED
8 其他 YouTube 功能
觀眾是指未歸入其他流量來源類型的 YouTube 網頁。在流量來源報表中,如果這個維度的值是 8,則「traffic_source_detail」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」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 直播重新導向
來自直播重新導向的觀看。
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 TV
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.
gender(核心維度)
這個維度可識別與報表資料相關聯的登入使用者的性別。 有效值為 FEMALEMALEGENDER_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 不明
1 迪格
4 reddit
5 StumbleUpon
6 mixi
7 Yahoo! 日本
8 goo
9 Ameba
10 Facebook
11 Myspace
12 NUjij
18 Tuenti (Tuenti)
20 Menéame
21 威科普
22 摩洛哥
25 福特卡
28 hi5
31 Twitter
32 天世界
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 Embed
60 簡訊
61 Android 訊息功能
62 Verizon 訊息
63 HTC 簡訊
64 Sony Conversations
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
廣告成效報表會使用ad_type維度,並根據影片播放期間放送的廣告類型匯總要求的指標。 下表列出可能的維度值。如要進一步瞭解 YouTube 廣告格式,請參閱 YouTube 說明中心
說明 查詢報表中的值
1 可略過的影片廣告 (競價) auctionTrueviewInstream
2 多媒體廣告 (競價) auctionDisplay
3 不可略過的影片廣告 (競價) auctionInstream
5 多媒體廣告 (預訂) reservedDisplay
6 不可略過的影片廣告 (預訂) reservedInstream
13 不明 unknown
15 可略過的影片廣告 (預訂) reservedInstreamSelect
19 串場廣告 (競價) auctionBumperInstream
20 串場廣告 (預訂) reservedBumperInstream

注意:查詢報表可能會針對先前在 YouTube 上使用過的其他廣告類型傳回查詢報表。

內容擁有者維度

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

has_status(僅適用於內容擁有者報表)
這個維度代表某一列只包含已聲明版權內容的指標。這個維度的唯一有效值是 claimed。「uploader_type」維度定義中的表格詳述如何使用這個維度。
upload_type (核心維度)(僅適用於內容擁有者報表)
這個維度會指出資料列是否包含指定內容擁有者和/或第三方上傳內容的指標,例如使用者上傳的影片。有效值為 selfthirdParty。這是核心維度,受《廢止政策》規範。

下表列出 claimed_statusuploader_type 維度支援的組合:

claimed_status uploader_type 說明
[未設定] 自己 這一列包含內容擁有者上傳且未聲明版權的內容,以及其 YouTube 數據分析資料。
已聲明版權 自己 資料列包含內容擁有者所上傳已聲明版權內容的資料。
已聲明版權 thirdParty 此列包含第三方上傳已聲明版權內容的資料。