Dimensions

本文將說明 YouTube 數據分析 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 數據分析 API 查詢報表使用的維度。除非另有說明，否則這些維度會同時用於頻道和內容擁有者報表。系統也會標示只能做為篩選器的維度。

資源

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

注意：當 video、playlist 和 channel 維度做為篩選器使用時，API 允許您指定多個值。如要這麼做，請將 filters 參數值設為以半形逗號分隔的影片、播放清單或頻道 ID 清單，API 回應會據此進行篩選。參數值最多可指定 500 個 ID。

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

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

範例

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

  • 頻道範例

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

  • 內容擁有者示例

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

地理區域

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

國家/地區 (核心維度)
報表列中指標所屬的國家/地區。維度值為雙字母 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 點開始的時間範圍。

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

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

範例

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

  • 頻道範例

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

  • 內容擁有者示例

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

播放位置

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

insightPlaybackLocationType
報表中的資料是根據影片播放的頁面或應用程式類型匯總而成。這項維度的可能值包括：

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

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

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

  • EXTERNAL_APP：這項資料說明在第三方應用程式中發生的觀看次數，且影片並非透過 <iframe> 或 <object> 嵌入方式播放。舉例來說，如果應用程式使用 YouTube Android Player API，系統就會根據這個值將播放次數分類。

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

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

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

  • 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：觀看次數來自隨選影片主題標記頁面或 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 欄位會指定觀眾的參照影片。
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：帶來觀看次數的影片。

範例

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

  • 頻道範例

    • 流量來源
      • 特定國家/地區不同流量來源的觀看次數和觀看時間
      • 不同流量來源的每日觀看次數和觀看時間
      • 前 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

範例

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

  • 頻道範例

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

  • 內容擁有者示例

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

客層

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

ageGroup (核心維度)
這個維度會指出與報表資料相關聯的登入使用者年齡層。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.
性別 (核心維度)
這個維度會識別與報表資料相關聯的已登入使用者性別。 有效值為 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 值
Ameba AMEBA
Android 電子郵件 ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android 訊息 ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
複製到剪貼簿 COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
嵌入 EMBED
電子郵件 MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook 粉絲專頁 FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC 簡訊 HTC_MMS
Google Inbox INBOX
iOS 系統活動對話方塊 IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
LGE 電子郵件 LGE_EMAIL
折線圖 LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola 訊息 MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
鄰近分享 NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
其他 OTHER
Pinterest PINTEREST
樂天 (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
簡訊 TEXT_MESSAGE
Tuenti TUENTI
tumblr。 TUMBLR
Twitter TWITTER
不明 UNKNOWN
Verizon 訊息 VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
微博 WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! 日本 YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

詳情請參閱說明文件。

範例

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

  • 頻道範例

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

  • 內容擁有者示例

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

觀眾續看率

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

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

請注意，audienceType 篩選器的資料可回溯至 2013 年 9 月 25 日。如果查詢使用篩選器嘗試擷取較早的資料，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 維度組合來篩選資料。