Dimensions

本文定義 YouTube Analytics API 支援的維度。這項 API 支援即時指定查詢，可產生 YouTube 數據分析自訂報表。

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

每份查詢報表都會列出支援的維度。舉例來說，依時間擷取使用者活動時，您可以選擇要回報資料的時間範圍：天或月。在任何報表中，每列資料都有一組不重複的維度值。

如要擷取查詢報表，請呼叫 YouTube Analytics API 的 reports.query 方法。在要求中，使用 dimensions 參數指定 YouTube 用於計算報表中指標值的維度。

核心維度

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

以下列出 API 的核心維度。

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

篩選器

所有查詢報表都支援篩選器。篩選器會找出擷取資料集中必須存在的維度值。因此，API 回應只會包含符合特定值或一組值的資料。舉例來說，您可以使用篩選器，只擷取特定國家/地區的使用者活動指標，而非所有國家/地區。

在擷取查詢報表的要求中，選用的 filters 要求參數會指定要篩選資料的維度值。舉例來說，如要擷取歐洲的使用者活動指標，請將 filters 參數值設為 continent==150。

重要事項：擷取內容擁有者報表的 API 要求，必須使用其中一個報表實體維度，或使用支援的 claimedStatus 和 uploaderType 維度組合來篩選資料。

尺寸

下列各節定義 YouTube Analytics API 查詢報表使用的維度。除非另有註明，否則這些維度會同時用於頻道和內容擁有者報表。系統也會標明只能做為篩選器的維度。

資源

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

注意：使用 video、playlist 和 channel 維度做為篩選條件時，API 可讓您指定多個值。做法是將 filters 參數值設為逗號分隔的清單，其中包含要篩選 API 回應的影片、播放清單或頻道 ID。參數值最多可指定 500 個 ID。

video (核心維度)
YouTube 影片 ID。在 YouTube Data API 中，這是 video 資源的 id 屬性值。This is a core dimension and is subject to the Deprecation Policy.
playlist
YouTube 播放清單的 ID。在 YouTube Data API 中，這是 playlist 資源的 id 屬性值。
channel (核心維度) (僅用於內容擁有者報表)
YouTube 頻道 ID。在 YouTube Data API 中，這是 channel 資源的 id 屬性值。This is a core dimension and is subject to the Deprecation Policy.

channel 維度常用於內容擁有者報表，因為這類報表通常會匯總多個頻道的資料。
group (僅限篩選條件)
YouTube 數據分析群組的 ID。你可以使用 YouTube Analytics API 的 groups.list 方法擷取這個值。使用 group 篩選器時，API 回應會包含該群組中所有影片、播放清單或頻道的資料。

範例

下列要求範例使用報表實體維度或篩選器：

  • 管道範例

    • 基本統計資料
      • 前 10 名：頻道中觀看次數最多的影片
      • 前 10 名：頻道觀看次數最高影片的註解點閱率
      • 特定播放清單的統計資料
      • 前 10 名：頻道觀看次數最多的播放清單
    • 地理位置
      • 前 10 名：特定國家/地區觀看次數最多的影片
      • 前 10 名：歐洲觀看次數最多的影片

  • 內容擁有者範例

    • 基本統計資料
      • 前 10 名 - 內容擁有者觀看次數最多的影片
      • 前 10 名 - 內容擁有者觀看次數最多的影片
      • 前 10 名 - 內容擁有者頻道中觀看次數最多的影片
      • 前 10 名：頻道觀看次數最高影片的註解點閱率
      • 前 10 名：內容擁有者觀看次數最多的播放清單
    • 地理位置
      • 前 10 名 - 內容擁有者在歐洲觀看次數最多的影片
      • 前 10 名：美國最常播放的播放清單

地理區域

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

country (核心維度)
與報表列中指標相關聯的國家/地區。維度值是兩個字母的 ISO-3166-1 國家/地區代碼，例如 US、CN (中國) 或 FR (法國)。如果 YouTube 無法識別相關國家/地區，就會使用國家/地區代碼 ZZ 回報指標。This is a core dimension and is subject to the Deprecation Policy.
province
與報表列中指標相關聯的美國州或領地。維度值是 ISO 3166-2 代碼，用於識別美國州別或哥倫比亞特區，例如 US-MI (密西根州) 或 US-TX (德州)。如果 YouTube 無法辨識相關聯的美國州別，就會使用省份代碼 US-ZZ 回報指標。 如果 API 要求的 dimensions 參數值包含 province，則要求也必須在 filters 參數值中加入 country==US，將資料限制在美國境內。

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

dma
Nielsen 用來識別指定行銷區域 (DMA) 的 3 位數 ID，與資料列中描述的觀看事件相關聯。
city
與報表列中指標相關聯的預估城市。這個維度可提供 2022 年 1 月 1 日起的資料。
continent (僅限篩選條件)
聯合國 (UN) 統計區域代碼。這個 API 支援下列值：
值 說明
002 非洲
019 美洲 (北美洲、拉丁美洲、南美洲和加勒比海地區)
142 亞洲
150 歐洲
009 大洋洲
這個維度只能用於篩選資料，如要使用這個維度，請將 filters 參數的值設為 continent==REGION_CODE，並指定表格中的 REGION_CODE 值。
subContinent (僅限篩選條件)
聯合國統計區域代碼，用於識別地理子區域。聯合國統計司列出了子區域，以及與各區域相關聯的國家/地區。

這個維度只能用於篩選資料，如要使用這個維度，請將 filters 參數的值設為 subContinent==REGION_CODE，並指定聯合國清單中的 REGION_CODE 值。

範例

下列範例要求使用地理維度或篩選器：

  • 管道範例

    • 基本統計資料：頻道在各國家/地區的觀看次數 (及其他資料)
    • 地理位置
      • 頻道影片在特定國家/地區的觀看時間指標
      • 頻道影片在各國家/地區的註解指標
      • 美國各州和華盛頓特區的省級指標
      • 頻道播放清單的國家/地區專屬觀看時間指標
      • 前 10 名：美國最常播放的播放清單
    • 播放位置：不同播放位置的每日觀看次數和觀看時間
    • 流量來源：某個國家/地區不同流量來源的觀看次數和觀看時間
    • 客層：加州觀眾客層 (年齡層和性別)
    • 熱門影片
      • 前 10 名：特定國家/地區觀看次數最多的影片
      • 前 10 名：歐洲觀看次數最多的影片

  • 內容擁有者範例

    • 基本統計資料：所有自行上傳影片在各國家/地區的觀看次數 (及其他資料)
    • 地理位置
      • 自行上傳內容在各國家/地區的觀看時間指標
      • 自行上傳內容的國家/地區專屬註解指標
      • 美國各州和華盛頓特區的省級指標
      • 內容擁有者播放清單的國家/地區專屬觀看時間指標
      • 前 10 名：美國最常播放的播放清單
    • 播放位置：不同播放位置的每日觀看次數和觀看時間
    • 客層：加州觀眾客層 (年齡層和性別)
    • 熱門影片：前 10 名 - 內容擁有者在歐洲最多人觀看的影片
    • 收益/廣告成效：各國家/地區的收益和廣告成效指標

時間範圍

這些維度表示報表應根據時間範圍 (例如一天、一週或一個月) 匯總資料。startDate 和 endDate 要求參數會指定報表資料的時間範圍。請注意，報表實際傳回的資料，只會到查詢時要求中指定的所有指標都可用的最後一天。報表中的日期格式為 YYYY-MM-DD。

重要事項：所有日期均指太平洋時間 (UTC-7 或 UTC-8) 凌晨 12:00 開始，到指定日期、月份和年份的太平洋時間晚上 11:59 結束的時間範圍。因此，時鐘因日光節約時間而向前調整的日期代表 23 小時的時間範圍，而時鐘向後調整的日期則代表 25 小時的時間範圍。

「月份」維度是指從指定月份和年份的第一天太平洋時間 (UTC-7 或 UTC-8) 凌晨 12:00 開始的時間範圍。

day (核心維度)
使用這個維度時，報表中的資料會按日匯總，每列包含一天的資料。您可以使用其他維度進一步細分資料。舉例來說，流量來源報表可以根據使用者觀看影片的方式，匯總每日觀看統計資料。This is a core dimension and is subject to the Deprecation Policy.
month (核心維度)
報表中的資料會依日曆月匯總。與每日報表一樣，您可以使用其他篩選器進一步區隔資料。報表中的日期會以 YYYY-MM 格式列出。

注意：如果 API 查詢使用 month 維度，則 start-date 和 end-date 參數都必須設為當月的第一天。This is a core dimension and is subject to the Deprecation Policy.

範例

下列範例要求使用時間維度或篩選器：

  • 管道範例

    • 根據時間
      • 頻道影片的每日觀看時間指標
      • 頻道影片的每日註解指標
      • 頻道每日播放清單觀看次數
    • 播放位置：不同播放位置的每日觀看次數和觀看時間
    • 流量來源：不同流量來源的每日觀看次數和觀看時間
    • 裝置/OS
      • Android 作業系統的每日裝置類型指標
      • 行動裝置的每日作業系統指標
      • 每日作業系統和裝置類型指標

  • 內容擁有者範例

    • 根據時間
      • 自行上傳內容的每日觀看時間指標
      • 已聲明版權內容的註解指標
      • 內容擁有者的每日播放清單觀看次數
    • 播放位置：不同播放位置的每日觀看次數和觀看時間
    • 流量來源：不同流量來源的每日觀看次數和觀看時間
    • 裝置/OS
      • 已聲明著作權影片的每日裝置類型指標
      • 在行動裝置上觀看已聲明著作權影片的每日作業系統指標
      • 每日作業系統和裝置類型指標
    • 收益/廣告成效：每日收益和廣告成效指標

播放位置

這些維度可讓您深入瞭解發生使用者活動的網頁或應用程式。

insightPlaybackLocationType
報表中的資料會根據影片播放的網頁或應用程式類型匯總。這項維度的可能值如下：

  • BROWSE：這項資料說明在 YouTube 首頁或主畫面、使用者的訂閱頻道動態消息，或其他 YouTube 瀏覽功能中發生的觀看次數。

  • CHANNEL：這項資料說明頻道頁面上的觀看次數。

  • EMBEDDED：這項資料說明在其他網站或應用程式上，使用 <iframe> 或 <object> 嵌入影片的觀看次數。

  • EXTERNAL_APP：這項資料代表在第三方應用程式中，使用 <iframe> 或 <object> 嵌入以外的方式播放影片所產生的觀看次數。舉例來說，如果應用程式使用 YouTube Android Player API，系統會使用這個值分類播放次數。

  • IMMERSIVE_LIVE_FEED：這項資料說明直式直播動態的觀看次數。

  • MOBILE：這項資料說明在 YouTube 行動版網站或核准的 YouTube API 用戶端 (包括行動裝置) 上發生的觀看次數。

    自 2013 年 9 月 10 日起，YouTube 數據分析報表不再將播放次數歸類為MOBILE播放次數。由於舊版資料仍屬於該類別，因此報表中可能仍會顯示該值。不過，自該日期起，行動裝置播放次數會根據播放次數發生的應用程式類型，分類為 WATCH、EMBEDDED 或 EXTERNAL_APP 播放次數。

  • SEARCH：這項資料說明直接在 YouTube 搜尋結果網頁上發生的觀看次數。

  • SHORTS_FEED：這項資料說明 YouTube Shorts 動態中的觀看次數。

  • WATCH：這項資料說明在影片的 YouTube 觀賞頁面或官方 YouTube 應用程式 (例如 YouTube Android 應用程式) 中發生的觀看次數。

  • YT_OTHER：資料描述未分類的觀看次數。

insightPlaybackLocationDetail
系統會根據播放器所在的網頁匯總資料。請注意，這份報表只會記錄內嵌播放器產生的觀看次數，並列出為特定影片帶來最多觀看次數的內嵌播放器。因此，這份報表會找出與熱門嵌入播放器相關聯的網址或應用程式，提供比播放位置報表更精細的資料。

範例

下列範例要求使用播放位置維度：

  • 管道範例

    • 播放位置
      • 不同播放位置的觀看次數和觀看時間
      • 不同播放位置的每日觀看次數和觀看時間
      • 前 10 名：為嵌入影片帶來最多觀看次數的第三方網站
      • 不同播放位置的播放清單觀看次數和觀看時間
      • 不同播放位置的每日播放清單觀看次數和觀看時間

  • 內容擁有者範例

    • 播放位置
      • 不同播放位置的觀看次數和觀看時間
      • 不同播放位置的每日觀看次數和觀看時間
      • 前 10 名：為嵌入影片帶來最多觀看次數的第三方網站
      • 不同播放位置的播放清單觀看次數和觀看時間
      • 不同播放位置的每日播放清單觀看次數和觀看時間

精彩記錄詳細資料

creatorContentType
這項維度會識別與資料列中使用者活動指標相關聯的內容類型。系統會從 2019 年 1 月 1 日開始提供這個維度的資料。

下表列出維度值：
值 說明
LIVE_STREAM 觀看的內容是 YouTube 直播。
SHORTS 觀看的內容是 YouTube Shorts。
STORY 觀看的內容是 YouTube 短片故事。
VIDEO_ON_DEMAND 觀看的內容是 YouTube 影片，不屬於其他維度值。
UNSPECIFIED 所瀏覽內容的內容類型不明。
liveOrOnDemand
這項維度會指出資料列中的使用者活動指標，是否與現場直播觀看次數相關聯。這個維度提供 2014 年 4 月 1 日起的資料。

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

請注意，維度值是使用者活動發生當下的準確值。舉例來說，假設使用者尚未訂閱某個頻道，但觀看了該頻道的其中一部影片，接著訂閱該頻道並觀看另一部影片，而這些動作都在當天完成。頻道的報表指出，其中一個觀看次數的 subscribedStatus 值為 SUBSCRIBED，另一個觀看次數的 subscribedStatus 值為 UNSUBSCRIBED。
youtubeProduct
這項維度會指出使用者活動發生的 YouTube 服務。這項維度自 2015 年 7 月 18 日起提供資料。

下表列出維度值：
值 說明
CORE 使用者活動並非發生在 YouTube 專屬應用程式 (YouTube Gaming、YouTube Kids 或 YouTube Music)。例外狀況：2021 年 3 月 1 日前在 YouTube Music 進行的使用者活動會計入CORE。
GAMING 使用者活動發生在 YouTube Gaming。
KIDS 使用者活動發生在 YouTube Kids。
MUSIC 使用者活動在 2021 年 3 月 1 日當天或之後，於 YouTube Music 發生。2021 年 3 月 1 日前的資料會納入CORE。不會記錄即時資料。
UNKNOWN 使用者活動發生在 2015 年 7 月 18 日之前。

流量來源

insightTrafficSourceType
報表中的資料會根據參照連結網址類型匯總，說明使用者如何找到影片。這個維度可能的值包括：
  • ADVERTISING：觀眾是透過廣告連到影片。如果根據這個流量來源進行篩選，insightTrafficSourceDetail 欄位會指出廣告類型。
  • ANNOTATION：觀眾點選其他影片中的註解，進而觀看這部影片。
  • CAMPAIGN_CARD：觀看次數來自使用者上傳、已聲明版權的影片，內容擁有者使用這些影片宣傳觀看內容。這項流量來源僅支援內容擁有者報表。
  • END_SCREEN：觀看次數來自另一部影片的片尾。
  • EXT_URL：影片觀看次數來自其他網站上的連結。如果根據這個流量來源進行篩選，insightTrafficSourceDetail 欄位會識別網頁。這項流量來源包含 Google 搜尋結果的參照連結網址。
  • HASHTAGS：觀看次數來自 VOD 主題標記頁面或 Shorts 主題標記分類頁面。
  • LIVE_REDIRECT：影片觀看次數來自直播重新導向。
  • NO_LINK_EMBEDDED：影片在其他網站內嵌播放。
  • NO_LINK_OTHER：YouTube 未能辨識流量的參照連結網址。這個類別涵蓋直接導向影片的流量，以及行動應用程式的流量。
  • NOTIFICATION：影片觀看次數來自 YouTube 傳送的電子郵件或通知。
  • PLAYLIST：影片在播放清單中播放時產生的觀看次數。包括來自播放清單頁面的流量。
  • PRODUCT_PAGE：影片觀看次數來自產品頁面。
  • PROMOTED：影片觀看次數來自無付費 YouTube 宣傳活動，例如 YouTube「精選影片」頁面。
  • RELATED_VIDEO：影片觀看次數來自其他影片觀賞頁面的相關影片清單。如果根據這個流量來源篩選，insightTrafficSourceDetail 欄位會指定該影片的影片 ID。
  • SHORTS：觀眾在 Shorts 觀看體驗中，從上一部影片垂直滑動至這部影片。
  • SOUND_PAGE：來自 Shorts 音效分類頁面的觀看次數。
  • SUBSCRIBER：影片觀看次數來自 YouTube 首頁的動態消息或 YouTube 訂閱功能。如果依據這項流量來源篩選，insightTrafficSourceDetail 欄位會指定首頁動態消息項目或其他來源網頁。
  • YT_CHANNEL：在頻道頁面觀看影片。如果根據這個流量來源篩選，insightTrafficSourceDetail 欄位會指定該頻道的頻道 ID。
  • YT_OTHER_PAGE：影片觀看次數來自 YouTube 頁面上的連結，但不是搜尋結果或相關影片連結。如果根據這個流量來源進行篩選，insightTrafficSourceDetail 欄位會識別網頁。
  • YT_SEARCH：影片觀看次數來自 YouTube 搜尋結果。如果根據這個流量來源篩選，insightTrafficSourceDetail 欄位會指定搜尋字詞。
  • VIDEO_REMIXES：影片觀看次數來自 Shorts 播放器中的重混影片連結。如果根據這個流量來源篩選，insightTrafficSourceDetail 欄位會指定觀眾來源影片。
  • WATCH_WITH：影片觀看次數來自創作者評論/「一起看」直播。如果根據這個流量來源篩選，insightTrafficSourceDetail 欄位會指定觀眾來源影片。
insightTrafficSourceDetail
報表中的資料會根據為指定影片和指定流量來源類型產生最多觀看次數的參照網址匯總。這份報表適用於下列流量來源。針對每個流量來源，清單會列出 insightTrafficSourceDetail 維度提供的資訊。
  • ADVERTISING：促成觀看的廣告類型。可能的值包括：
    • 隨點即播參與廣告
    • 參與式廣告
    • Google 搜尋廣告
    • 首頁影片廣告
    • 預訂可略過串流內廣告
    • TrueView 搜尋結果廣告和多媒體廣告
    • TrueView 串流內廣告
    • 未分類的 YouTube 廣告
    • 影片縮圖
  • CAMPAIGN_CARD：觀眾透過這部已聲明著作權影片，前往報表中的影片。
  • END_SCREEN：引導觀眾前往報表中所列影片的影片。
  • EXT_URL：將觀眾導向影片的網站。
  • HASHTAGS：帶來觀看次數的主題標記。
  • NOTIFICATION：帶來流量的電子郵件或通知。
  • RELATED_VIDEO：引導觀眾前往報表涵蓋影片的相關影片。
  • SOUND_PAGE：帶來觀看次數的影片。
  • SUBSCRIBER：首頁推薦內容或 YouTube 訂閱功能，引導觀眾觀看報表中的影片。有效值如下：
    • activity：首頁訂閱頻道動態消息中，非上傳和非社交頻道活動 (包括按讚、加入收藏、發布公告和加入播放清單) 產生的觀看次數。
    • blogged：這些觀看次數來自首頁訂閱頻道動態消息被嵌入熱門網誌的活動。
    • mychannel：觀看次數來自首頁列出的其他動態消息項目，例如「喜歡的影片」、「觀看記錄」和「稍後觀看」。
    • podcasts：來自 Podcast 主題頁面項目的觀看次數。
    • sdig：來自訂閱更新電子郵件的觀看次數。
    • uploaded：來自首頁訂閱頻道動態消息中「uploaded」項目的觀看次數。
    • /：源自 YouTube 首頁的其他觀看次數。
    • /my_subscriptions：觀看次數來自 YouTube 的「我的訂閱內容」頁面。
  • YT_CHANNEL：觀眾觀看影片的頻道頁面。
  • YT_OTHER_PAGE：觀眾從哪個 YouTube 頁面連到影片。
  • YT_SEARCH：引導觀眾找到影片的搜尋字詞。
  • VIDEO_REMIXES：帶來觀看次數的影片。
  • WATCH_WITH：帶來觀看次數的影片。

範例

下列範例要求使用流量來源維度：

  • 管道範例

    • 流量來源
      • 某國家/地區不同流量來源的觀看次數和觀看時間
      • 不同流量來源的每日觀看次數和觀看時間
      • 前 10 名：為影片帶來最多流量的 YouTube 搜尋字詞
      • 前 10 名：為影片帶來最多流量的 Google 搜尋字詞
      • 某國家/地區不同流量來源的播放清單觀看次數和觀看時間
      • 每日播放清單觀看次數和不同流量來源的觀看時間

  • 內容擁有者範例

    • 流量來源
      • 不同流量來源的觀看次數和觀看時間
      • 不同流量來源的每日觀看次數和觀看時間
      • 前 10 名：為影片帶來最多流量的 YouTube 搜尋字詞
      • 前 10 名：為影片帶來最多流量的 Google 搜尋字詞
      • 某國家/地區不同流量來源的播放清單觀看次數和觀看時間
      • 每日播放清單觀看次數和不同流量來源的觀看時間

裝置

deviceType
這項維度會指出影片播放裝置的種類規格。 下列清單列出 API 傳回資料的裝置類型。您也可以使用 deviceType 維度做為篩選條件，限制作業系統報表只包含特定類型裝置的資料。
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_PLATFORM
operatingSystem
這個維度代表影片播放裝置的軟體系統。 以下清單列出 API 傳回資料的作業系統。您也可以使用 operatingSystem 做為篩選器，限制裝置類型報表只包含特定作業系統的資料。
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

範例

下列範例要求使用裝置維度：

  • 管道範例

    • 裝置/OS
      • Android 作業系統的每日裝置類型指標
      • 行動裝置的每日作業系統指標
      • 每日作業系統和裝置類型指標
      • Android 作業系統上播放清單觀看次數的每日裝置類型指標
      • 行動裝置上播放清單觀看次數的每日作業系統指標

  • 內容擁有者範例

    • 裝置/OS
      • 已聲明著作權影片的每日裝置類型指標
      • 在行動裝置上觀看已聲明著作權影片的每日作業系統指標
      • 每日作業系統和裝置類型指標
      • Android 作業系統上播放清單觀看次數的每日裝置類型指標
      • 行動裝置上播放清單觀看次數的每日作業系統指標

客層

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

ageGroup (核心維度)
這項維度會根據報表資料，識別登入使用者的年齡層，包括 YouTube 預估未滿 18 歲的使用者。API 使用下列年齡層：
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
gender (核心維度)
這項維度會指出與報表資料相關聯的已登入使用者性別。 有效值為 female、male 和 user_specified。 This is a core dimension and is subject to the Deprecation Policy.

範例

下列範例要求使用客層維度：

  • 管道範例

    • 客層
      • 加州觀眾客層 (年齡層和性別)
      • 加州播放清單觀眾客層 (年齡層和性別)

  • 內容擁有者範例

    • 客層
      • 加州觀眾客層 (年齡層和性別)
      • 加州播放清單觀眾客層 (年齡層和性別)

參與度和內容分享

sharingService (核心維度)
這個維度會指出用來分享影片的服務。使用者可以透過「分享」按鈕，在 YouTube 上 (或透過 YouTube 播放器) 分享影片。This is a core dimension and is subject to the Deprecation Policy.

下表列出有效的維度值：
分享服務 API 值
Allo ALLO
Ameba AMEBA
Android 電子郵件 ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android 訊息 ANDROID_MMS
Android 系統分享對話方塊 ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
獲得回應 BLIND_REACT
Blogger BLOGGER
複製到剪貼簿 COPY_PASTE
Cyworld CYWORLD
Digg DIGG
直接系統活動對話方塊 DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
顯示 QR code DISPLAYED_QR_CODE
Dropbox DROPBOX
嵌入 EMBED
電子郵件 MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
Facebook 粉絲專頁 FACEBOOK_PAGES
Facebook 分享至社團 FACEBOOK_SHARE_TO_GROUP
Facebook 限時動態 FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google 應用程式 GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC 簡訊 HTC_MMS
IMO IMO
Instagram INSTAGRAM
Instagram 限時動態 INSTAGRAM_STORIES
邀請連結 (Android) INVITE_LINK_ANDROID
邀請連結 (iOS) INVITE_LINK_IOS
邀請播放清單協作者 INVITE_PLAYLIST_COLLABORATORS
iOS 系統活動對話方塊 IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
KaiOS 訊息 KAIOS_MESSAGES
Kik KIK
LGE 電子郵件 LGE_EMAIL
Line LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
複製/貼上地圖 MAPS_COPY_PASTE
Meet 即時分享 MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola 訊息 MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
鄰近分享 NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
其他 OTHER
Pinterest PINTEREST
快速分享 QUICK_SHARE
快速分享 (Samsung) QUICK_SHARE_SAMSUNG
樂天 (楽天市場) RAKUTEN
reddit REDDIT
重混 REMIX
Samsung 訊息 SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
儲存至裝置上的相片庫 SAVE_TO_DEVICE_PHOTOS
分享零廣告體驗 SHARE_AD_FREE
分享至 Snapchat 相機 SHARE_TO_SNAPCHAT_CAMERA
與孩子分享 SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
Sony 對話 SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
簡訊 TEXT_MESSAGE
Tuenti TUENTI
tumblr。 TUMBLR
Twitter TWITTER
不明 UNKNOWN
Verizon 訊息 VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
網路系統活動對話方塊 WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
微博 WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! 日本 YAHOO
YouTube 社群貼文 YOUTUBE_COMMUNITY_POST
YouTube 社群轉貼 YOUTUBE_COMMUNITY_REPOST
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
從 YouTube Music 分享內容到 Snapchat 的預覽畫面 YTM_SHARE_TO_SNAPCHAT_PREVIEW
YouTube Shorts 綠幕 YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
YouTube 與好友一起看 YOUTUBE_WATCH_WITH_FRIENDS

詳情請參閱說明文件。

範例

下列範例要求使用社群維度：

  • 管道範例

    • 社群：分享指標，依分享影片的服務匯總

  • 內容擁有者範例

    • 社群：分享指標，依分享影片的服務匯總

觀眾續看率

elapsedVideoTimeRatio
這項維度會指定影片已播放部分與影片長度的比例。留存維度和指標可用來評估一段時間內的觀眾續看率，而 elapsedVideoTimeRatio 維度則是時間測量值。舉例來說，如果值為 0.4，表示對應的報表資料會顯示影片播放 40% 後的續看率資料。

API 會傳回每部影片的 100 個資料點，比率值介於 0.01 到 1.0 之間。系統會以固定時間間隔，在影片播放期間評估資料。也就是說，如果影片長度為兩分鐘，資料點之間的間隔就是 1.2 秒。不過，如果是兩小時的影片，資料點之間的間隔為 72 秒。維度值代表間隔的結束時間 (不含)。
audienceType (僅限篩選)
維度值會識別與報表資料相關聯的流量類型。 支援的值為 ORGANIC、AD_INSTREAM 和 AD_INDISPLAY。 如要瞭解這些流量來源類型，請參閱 YouTube 說明中心。

請注意，系統提供 2013 年 9 月 25 日起的「audienceType」篩選器資料。如果查詢使用篩選器嘗試擷取更早日期的資料，API 就不會傳回資料。不使用篩選器的查詢適用於 2008 年 7 月 1 日之後的任何日期。

範例

下列範例要求使用觀眾續看率維度：

直播

livestreamPosition
這項維度會指定即時影像串流中的特定分鐘。報表指標會指出當時觀看直播的使用者人數。

取消會員資格

membershipsCancellationSurveyReason
在報表統計期內，YouTube 使用者取消指定頻道會籍後完成的問卷調查數量。下表列出有效的維度值：
API 值 說明
UNKNOWN 使用者未完成問卷調查。
DISLIKE_PERKS 使用者不喜歡會員福利。
PERKS_NOT_DELIVERED 使用者表示未收到承諾的會員福利。
CANNOT_ACCESS_PERKS 使用者無法存取福利。
NO_LONGER_INTERESTED 使用者對頻道會員資格不再感興趣。
FEEL_UNAPPRECIATED 使用者認為頻道會員身分未受到重視。
FINANCIAL_REASONS 使用者因財務因素取消訂閱。
JOIN_LIMITED_TIME 使用者只想短暫加入。
OTHER 使用者因其他原因取消。

廣告成效

adType
「adType」維度用於廣告成效報表，會根據影片播放期間放送的廣告類型，匯總要求的指標。 下表說明可能的維度值。如要進一步瞭解 YouTube 廣告格式，請前往 YouTube 說明中心。

  • auctionBumperInstream：透過競價刊登、長度不超過 6 秒的不可略過影片廣告，觀眾必須看完才能觀賞影片。

  • auctionDisplay：互動式多媒體或圖像廣告，會重疊顯示在影片播放器底部、影片觀賞頁面的 300x250 廣告單元，或同時顯示在兩處。重疊廣告會在顯示一段時間後自動關閉，使用者也可以手動關閉。如果重疊廣告和橫幅廣告同時顯示，系統會將每個廣告計為一次曝光。

  • auctionInstream：在主要影片播放前後或期間放送，且不可略過的影片廣告。

  • auctionTrueviewInslate：影片播放前會顯示多個影片廣告選項，觀眾可選擇其中一個觀看。See the TrueView documentation for more information.

  • auctionTrueviewInstream：在主要影片播放前後或期間放送的可略過影片廣告。詳情請參閱 TrueView 說明文件。

  • auctionUnknown：透過 AdWords 競價購買，但尚未歸入其他廣告類型的廣告。

  • reservedBumperInstream：不可略過的影片廣告，以預訂方式銷售，最長 6 秒。觀眾必須先看完這段廣告，才能觀賞影片。

  • reservedClickToPlay：使用者必須點擊才能播放的影片廣告。無論使用者是否開始播放，只要隨點即播廣告單元顯示，系統就會記錄一次廣告曝光。這類廣告是以預訂方式銷售。

  • reservedDisplay：互動式多媒體或圖像廣告，會重疊顯示在影片播放器底部、影片觀賞頁面的 300x250 廣告單元，或同時顯示在兩處。重疊廣告會在顯示一段時間後自動關閉，使用者也可以手動關閉。如果重疊廣告和橫幅廣告同時顯示，系統會將每個廣告計為一次曝光。

  • reservedInstream：在主要影片播放前後或期間放送的不可略過影片廣告。

  • reservedInstreamSelect

  • reservedMasthead：顯示在首頁的大型廣告，可包含影片和圖像元素。

  • reservedUnknown：以預訂方式銷售，但無法歸類為其他廣告類型的廣告。

  • unknown：YouTube 無法辨別這種廣告類型。

範例

下列報表範例會擷取廣告成效或收益指標：

  • 管道範例

    • 收益/廣告
      • 頻道收益和廣告成效指標
      • 每日收益和廣告成效指標
      • 特定國家/地區的收益和廣告成效指標
      • 前 10 名：收益最高的影片
      • 不同廣告類型的廣告成效指標

  • 內容擁有者範例

    • 收益/廣告
      • 已聲明版權內容的收益和廣告成效指標
      • 每日收益和廣告成效指標
      • 特定國家/地區的收益和廣告成效指標
      • 前 10 名：收益最高的影片
      • 不同廣告類型的廣告成效指標

內容擁有者維度

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

重要事項：擷取內容擁有者報表的 API 要求，必須使用下列其中一個維度篩選資料：
  • video
  • channel
  • claimedStatus 和 uploaderType 維度的支援組合，定義如下。
claimedStatus (僅用於內容擁有者報表)
這個維度可讓你指定 API 回應只應包含已聲明版權內容的指標。這個維度唯一有效的值是 claimed。如果 filters 參數將查詢限制為 claimedStatus==claimed，API 只會擷取已聲明版權內容的資料。uploaderType 維度定義中的表格詳細說明瞭如何使用這個維度。
uploaderType (核心維度) (僅用於內容擁有者報表)
這項維度可讓你指定 API 回應是否應包含特定內容擁有者上傳內容和/或第三方上傳內容 (例如使用者上傳的影片) 的指標。有效值為 self 和 thirdParty。這是核心維度，適用廢止政策。

下表列出 claimedStatus 和 uploaderType 維度支援的組合，這兩個維度都用於 filters 參數：

claimedStatus值 uploaderType值 說明
[未設定] self 擷取內容擁有者上傳的已聲明和未聲明內容的 YouTube 數據分析資料。
已聲明版權 [未設定] 擷取內容擁有者或第三方上傳的已聲明版權內容資料。
已聲明版權 self 擷取內容擁有者上傳的已聲明版權內容資料。
已聲明版權 thirdParty 擷取第三方上傳的已聲明版權內容資料。

範例

許多內容擁有者報表的 API 要求範例，都會使用支援的 claimedStatus 和 uploaderType 維度組合來篩選資料。