Dimensions

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

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

每個查詢報表都會識別其支援的維度。例如，按時間擷取使用者活動時，您可以選擇報告資料的時間範圍：天或月份。在任何報表中，每一列都會有不重複的維度值組合。

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

核心尺寸

使用 YouTube 數據分析時，您必須遵守《服務條款》中的廢止政策，但非核心維度 (以及非核心指標) 則不受此政策限制。在此頁面上的定義中，任何是核心維度的維度都明確識別為這類維度。

以下清單列出 API 的核心維度。

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

篩選器

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

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

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

尺寸

以下各節說明 YouTube Analytics API 查詢報表中使用的維度。除非另有註明，否則這些維度都會用於頻道和內容擁有者報表中。另外，系統也會找出只可做為篩選器的維度。

資源

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

注意：這個 API 可讓您為 video、playlist 和 channel 維度指定多個值做為篩選器使用時的值。只要將 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 Analytics 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 (德州)。省代碼 US-ZZ 可用於回報 YouTube 無法辨識相關美國州別的指標。 如果 API 要求在 dimensions 參數值中包含 province，該要求也必須在 filters 參數值中加入 country==US，藉此將資料限制為美國。

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

city
與報表列中的指標相關聯的預估城市。這個維度的資料可回溯至 2022 年 1 月 1 日的資料。
大陸 (僅限篩選器)
聯合國統計區碼。這個 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 - UTC 或 UTC-8) 的凌晨 12:00 至晚上 11:59 結束，時間範圍則為指定日期、月份及年份的太平洋時間。因此，將日光節約時間往前調整的日期代表 23 小時，而將時鐘往後調整的日期則代表 25 小時的時段。

「月」維度是指指定月份及年份的第一天，太平洋時間的凌晨 12 點 (UTC-7 或世界標準時間 8) 開始。

日 (核心維度)
使用這個維度時，報表會每天匯總資料，每列資料包含一天的資料。您可以使用其他維度進一步細分資料。舉例來說，「流量來源」報表可根據使用者到達影片的方式，彙整每日觀看次數統計資料。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 作業系統的每日裝置類型指標
      • 行動裝置的每日作業系統指標
      • 每日作業系統和裝置類型指標

  • 內容擁有者範例

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

播放位置

這些維度可提供有關使用者活動的網頁或應用程式深入分析。

insightplayLocationType
系統會根據發生影片播放的網頁或應用程式類型，彙整報表資料。這個維度的可能值如下：

  • 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：資料所描述的檢視畫面未經過分類。

insightplayLocationDetails
系統會根據玩家所在的網頁匯總相關資料，請注意，此報告僅適用於內嵌播放器中發生的檢視，並且能夠識別特定影片獲得最多觀看次數的內嵌播放器。因此，與播放位置報表相比，它能找出與熱門內嵌播放器相關聯的網址或應用程式，讓您取得更精細的收視資料。

範例

以下請求範例使用播放位置維度：

  • 頻道範例

    • 播放位置
      • 來自不同播放位置的觀看次數和觀看時間
      • 來自不同播放位置的每日觀看次數和觀看時間
      • 前 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 這一列的資料代表在現場直播期間未發生的使用者活動。
subscriptiondStatus
這個維度可指出資料列中的使用者活動指標是否與訂閱影片或播放清單頻道的觀眾相關。可能的值為 SUBSCRIBED 和 UNSUBSCRIBED。

請注意，維度值與使用者活動發生時完全相同。舉例來說，假設使用者尚未訂閱某個頻道，並觀看該頻道的其中一部影片，然後於同天訂閱該頻道並觀看其他影片。 管道的報表顯示，某個資料檢視的 subscribedStatus 值是 SUBSCRIBED，而一個資料檢視的 subscribedStatus 值是 UNSUBSCRIBED。
YouTube 產品
這個維度可識別發生使用者活動的 YouTube 服務。這個維度的資料可回溯至 2015 年 7 月 18 日。

下表列出維度值：
值
CORE 未發生在特殊 YouTube 應用程式 (YouTube 遊戲、YouTube Kids 或 YouTube Music) 中的使用者活動。例外情況：CORE
GAMING YouTube 遊戲發生了使用者活動。
KIDS YouTube Kids 中的使用者活動。
MUSIC 2021 年 3 月 1 日當天或之後，YouTube Music 的使用者活動發生了。2021 年 3 月 1 日以前的資料會納入 CORE。系統不會記錄即時資料。
UNKNOWN 使用者活動是在 2015 年 7 月 18 日前發生。

流量來源

insight TrafficSourceType
報表中的資料是根據參照網址類型匯總，其中說明瞭使用者觸及影片的方式。這個維度可能的值包括：
  • 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：影片在播放清單中播放時的觀看次數。請注意，這種流量來源與 YT_PLAYLIST_PAGE 不同，表示觀看次數的來源為列出播放清單中所有影片的網頁。
  • 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_PLAYLIST_PAGE：影片觀看次數來源為列出播放清單中所有影片的網頁。請注意，這個流量來源與 PLAYLIST 不同，代表影片以播放清單的形式播放時的觀看次數。
  • 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 - 來自播客到達網頁頁面中項目的觀看次數。
    • 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 搜尋字詞
      • 某國家/地區不同流量來源的播放清單觀看次數和觀看時間
      • 來自不同流量來源的每日播放清單觀看次數和觀看時間

裝置

裝置類型
這個維度可識別發生觀看次數的裝置實體板型規格。 下列清單列出 API 會傳回資料的裝置類型。您也可以使用 deviceType 維度做為篩選器，將作業系統報表限制為只包含特定裝置類型的資料。
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
作業系統
這個維度可識別發生觀看次數的裝置軟體系統。 下列清單列出 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 說明中心針對 YouTube Analytics 報表提供了客層資料的其他相關資訊，

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
黑莓 Messenger BBM
Blogger BLOGGER
複製到剪貼簿 COPY_PASTE
世界世界 CYWORLD
挖掘 DIGG
Dropbox DROPBOX
嵌入 EMBED
電子郵件 MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook 專頁 FACEBOOK_PAGES
福塔 FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
傳送簡訊 GO_SMS
群組我 GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC 簡訊 HTC_MMS
Google Inbox INBOX
iOS 系統活動對話方塊 IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO 故事 KAKAO_STORY
考考文 (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
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
其他 OTHER
Pinterest PINTEREST
樂天 (日本天市) RAKUTEN
reddit REDDIT
Skype SKYPE
天空搖滾 SKYBLOG
Sony 對話 SONY_CONVERSATIONS
StumbleUpon 音樂 STUMBLEUPON
Telegram TELEGRAM
簡訊 TEXT_MESSAGE
坦蒂文 TUENTI
tumblr。 TUMBLR
Twitter TWITTER
不明 UNKNOWN
Verizon 訊息 VERIZON_MMS
Viber VIBER
VKontakte (QHКонтакте) 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

詳情請參閱說明文件。

範例

以下請求範例使用了社交維度：

  • 頻道範例

    • 社交：分享指標，依影片分享次數匯總顯示

  • 內容擁有者範例

    • 社交：分享指標，依影片分享次數匯總顯示

觀眾續看率

eeddVideoTimeRatio
這個維度指定影片的播放時間比例與影片長度。使用回訪率維度和指標，即可評估長期下來的觀眾續看率，而 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 日後，任何不使用篩選器的查詢都會運作。

範例

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

廣告成效

廣告類型
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 – 我們無法對這個廣告類型進行分類。

範例

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

  • 頻道範例

    • 收益/廣告
      • 頻道收益和廣告成效指標
      • 每日收益和廣告成效成效指標
      • 國家/地區專屬的收益和廣告成效成效指標
      • 百大熱門影片 - 收益最高的影片
      • 不同廣告類型的廣告成效指標

  • 內容擁有者範例

    • 收益/廣告
      • 已聲明版權內容的收益和廣告成效成效指標
      • 每日收益和廣告成效成效指標
      • 國家/地區專屬的收益和廣告成效成效指標
      • 百大熱門影片 - 收益最高的影片
      • 不同廣告類型的廣告成效指標

播放清單

isCurated(僅限篩選器)
這個篩選器表示要求正在擷取播放清單中相關的影片觀看次數資料。任何播放清單報表都必須使用這個篩選器，且其值必須設為 1。

範例

擷取播放清單報表的所有請求範例都使用 isCurated 篩選器。

內容擁有者維度

內容擁有者報表僅支援下列維度。

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

下表顯示 claimedStatus 和 uploaderType 維度支援的組合，兩者均用於 filters 參數：

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

範例

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