YouTube Analytics API: Content Owner Reports

注意： Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

本頁列出內容擁有者可透過 YouTube Analytics API 擷取的報表。內容擁有者報表包含與指定 YouTube 內容擁有者連結的頻道指標。指標是使用者活動、廣告成效或預估收益的個別測量結果。

  • 影片報表包含內容擁有者頻道中影片的使用者活動、廣告成效和預估收益指標。

  • 播放清單報表會提供與播放清單中影片觀看次數相關的統計資料。播放清單報表與影片報表使用許多相同的維度和篩選器。

  • 廣告成效報表包含收益和廣告成效相關指標。他們使用 adType 維度，根據影片播放期間放送的廣告類型，將指標分組。「廣告成效報表」一節說明 API 支援的兩種廣告成效指標。

擷取報表

如要擷取內容擁有者報表，請呼叫 API 的 reports.query 方法，並將 API 要求中的 ids 參數值設為 contentOwner==OWNER_NAME，其中 OWNER_NAME 指定內容擁有者的 ID。如果不確定值，請洽詢合作夥伴經理。

授權

所有 YouTube Analytics API 要求皆須獲得授權。授權指南說明如何使用 OAuth 2.0 通訊協定擷取授權權杖。

YouTube Analytics API 要求會使用下列授權範圍：

範圍
https://www.googleapis.com/auth/yt-analytics.readonly 查看您 YouTube 內容的 YouTube 數據分析報表。這個範圍可存取使用者活動指標，例如觀看次數和評分次數。
https://www.googleapis.com/auth/yt-analytics-monetary.readonly 查看您 YouTube 內容的 YouTube 數據分析金額報表。這個範圍可存取使用者活動指標，以及預估收益和廣告成效指標。
https://www.googleapis.com/auth/youtube 管理 YouTube 帳戶。在 YouTube Analytics API 中，頻道擁有者可使用這個範圍管理 YouTube 數據分析群組和群組項目。
https://www.googleapis.com/auth/youtubepartner 查看及管理 YouTube 上的資產和相關內容。在 YouTube Analytics API 中，內容擁有者可使用這個範圍管理 YouTube 數據分析群組和群組項目。

注意：標有星號 (*) 的指標需要授權憑證，才能授予 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 範圍的存取權。

篩選器

所有用來擷取內容擁有者報表的 API 請求，都必須使用 video 維度、channel 維度，或 claimedStatus 和 uploaderType 維度的支援組合來篩選資料。(支援的組合列於uploaderType維度的定義中)。

說明支援報表的表格會指出可用於任何指定報表的篩選器。在說明中，括號內的篩選器為選用。舉例來說，如果報表將 video(,country) 列為篩選選項，則報表可以篩選出特定影片的資料，也可以篩選出特定國家/地區中特定影片的資料。

此外，API 也支援為 video、playlist 和 channel 篩選器指定多個值。如果您為其中一個篩選器指定多個值，也可以將該篩選器新增至您為要求指定的維度清單。即使篩選器未列為特定報表的支援維度，也是如此。

如要完整瞭解如何依特定值或值集篩選 API 結果，請參閱 filters 參數定義。

瞭解報表表格

本節說明定義 API 支援報表的表格所使用的格式和術語。下表列出使用時間維度和 averageViewPercentage 指標時，播放詳細資料影片報表支援的維度、指標和篩選器。

目錄
尺寸：
使用 0 個以上 creatorContentType、subscribedStatus、youtubeProduct
使用 0 或 1 天、月
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
篩選器：
使用 0 或 1 country、province、continent、subContinent
使用 0 或 1 影片、群組
使用 0 個以上 subscribedStatus、youtubeProduct

表格包含兩個維度資料列、一個指標資料列和三個篩選條件資料列。對於維度和篩選器，只要組合符合表格中的使用規則，API 要求中就能合併每個資料列的值。舉例來說，這份報表的有效 dimensions 參數值包括：

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

不過，參數值 day,month 無效，因為它使用兩個時間維度，而要求必須使用 0 或 1。

報表表格術語

表格會使用下列術語，指出維度是必要還是選用：

  • 下列字詞表示必須提供值：
    • 必要：您必須加入值。
    • 只能使用 1 個：你必須從群組中加入一個值。
    • 使用 1 個以上：您可以納入群組中的任何或所有值，但至少須納入一個。
  • 下列字詞表示值為選用：
    • 選用：您可以選擇納入值。
    • 使用 0 或 1：你可以選擇納入群組中的一個值。
    • 使用 0 個以上的值：您可以選擇納入群組中的任何或所有值。
重要事項：所有用來擷取內容擁有者影片報表的 API 要求，都必須使用 video 維度、channel 維度、group 維度，或是 claimedStatus 和 uploaderType 維度的支援組合，篩選資料。(部分報表不支援所有選項)。支援的組合 (也列在 uploaderType 維度的定義中) 如下：
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

影片報表

基本數據

基本統計資料 (包括訂閱人數)

這份報表提供與內容擁有者所有頻道的使用者動作相關的統計資料。您可以篩選報表，只傳回特定影片或國家/地區的資料。您也可以使用這項功能，只擷取已聲明著作權的內容統計資料，包括內容擁有者、第三方或兩者上傳的已聲明著作權內容。

目錄
尺寸：
[None]
指標：
使用 1 個以上 engagedViews、views、redViews、comments、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、continent、subContinent

美國各州的基本統計資料

這份報表提供特定美國州別或哥倫比亞特區的統計資料。請注意，這份報表僅支援上述國家/地區專屬報表中的部分指標。

目錄
尺寸：
[None]
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
必填 province

根據時間

特定時間範圍的活動

這份報表提供特定時間間隔內，內容擁有者所有頻道的使用者動作相關統計資料。您可以篩選報表，只傳回特定影片或國家/地區的資料。

目錄
尺寸：
使用 1 個 天、月
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、comments、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks、subscribersGained、subscribersLost、uniques、estimatedRevenue*、estimatedAdRevenue*、grossRevenue*、estimatedRedPartnerRevenue*、monetizedPlaybacks*、playbackBasedCpm*、adImpressions*、cpm*
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、continent、subContinent

特定時間範圍內，美國各州的使用者活動

這份報表提供特定美國州別或哥倫比亞特區的統計資料。請注意，這份報表僅支援上述國家/地區專屬報表中的部分指標。

目錄
尺寸：
使用 1 個 天、月
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
必填 province

使用者地理位置

使用者活動 (按國家/地區)

這份報表提供所有內容擁有者頻道的使用者活動統計資料，並依國家/地區分類。您可以篩選報表，只傳回特定影片或頻道的資料。

目錄
尺寸：
必填 country
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、comments、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 continent、subContinent

使用者活動 (依省分組)

這份報表提供美國各州和哥倫比亞特區的使用者活動統計資料。如要產生這份報表，請將 filters 參數值設為 country==US。

目錄
尺寸：
必填 province
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
必填 country==US

依城市劃分的使用者活動 (最多 250 項結果)

注意：如要產生這份報表，請將 maxResults 參數設為 250 以下的整數值。與大多數其他報表不同，這份報表也需要您為 sort 要求參數指定值。

這份報表提供按城市劃分的使用者活動統計資料。

目錄
尺寸：
必填 city
使用 0 個以上 creatorContentType、country、province、subscribedStatus

注意：如果加入 province 維度，也必須使用 country==US 篩選器。
使用 0 或 1 天、月
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
排序選項： -engagedViews
-views
-estimatedMinutesWatched

播放詳細資料

播放詳細資料報表提供與下列觀看屬性相關的統計資料：

  • 觀看的是直播影片還是隨選影片？
  • 觀眾是否訂閱影片所屬頻道？
  • 觀看次數是在哪個 YouTube 產品上產生？

從技術上來說，這些報表支援的播放詳細資料維度皆為選填。如果要求中未納入播放詳細資料維度，傳回的報表實際上會與基本統計資料、以時間為準或使用者地理位置報表類似。

注意：liveOrOnDemand 維度和篩選器無法與 averageViewPercentage 指標一併使用。因此，下列每個小節都會列出兩份報表。其中一份報表支援 liveOrOnDemand 維度 (和篩選器)，另一份則支援 averageViewPercentage 指標。

使用者活動 (按訂閱狀態劃分)

這份報表提供訂閱者和非訂閱者的使用者活動指標。統計資料可依時間範圍 (天或月) 分組，報表也可依國家/地區、洲或subContinent篩選。

目錄
尺寸：
使用 0 個以上 creatorContentType、subscribedStatus
使用 0 或 1 天、月
指標：
使用 1 個以上 engagedViews、views、redViews、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、continent、subContinent
選用 subscribedStatus

各省份使用者活動 (依訂閱狀態劃分)

這份報表提供美國各州或哥倫比亞特區的訂閱者和非訂閱者觀眾使用者活動指標。這份報表支援的指標比舊版報表少。

目錄
尺寸：
使用 0 個以上 creatorContentType、subscribedStatus
使用 0 或 1 天、月
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
必填 province
選用 subscribedStatus

播放詳細資料 (可選時間維度)

這些報表可選擇是否加入時間維度 (天或月)，因為無論如何，您都必須使用 startDate 和 endDate 要求參數，指定報表涵蓋的日期範圍。如果維度存在，表示您希望報表中的資料依日期、月份等彙整。

播放詳細資料，包括選用的時間維度和 liveOrOnDemand 統計資料

這份報表會提供特定時間間隔的播放詳細統計資料。支援 liveOrOnDemand 維度 (和篩選器)。

目錄
尺寸：
使用 0 個以上 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
使用 0 或 1 天、月
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus、youtubeProduct
播放詳細資料 (可選時間維度和 averageViewPercentage 指標)

這份報表會提供特定時間間隔的播放詳細統計資料。

目錄
尺寸：
使用 0 個以上 creatorContentType、subscribedStatus、youtubeProduct
使用 0 或 1 天、月
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 subscribedStatus、youtubeProduct

依國家/地區劃分的播放詳細資料

依國家/地區顯示的播放詳細資料，以及 liveOrOnDemand 統計資料

這份報表提供各國家/地區的播放詳細資料統計數據。支援 liveOrOnDemand 維度 (和篩選器)。

目錄
尺寸：
選用 country
使用 0 個以上 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus、youtubeProduct
使用 averageViewPercentage 指標，依國家/地區查看播放詳細資料

以下報表與前一個類似，這個版本新增了averageViewPercentage指標的支援，但不支援將liveOrOnDemand做為維度或篩選器。

目錄
尺寸：
選用 country
使用 0 個以上 creatorContentType、subscribedStatus、youtubeProduct
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 continent、subContinent
使用 0 個以上 subscribedStatus、youtubeProduct

各省份的播放詳細資料

依省份顯示的播放詳細資料，以及 liveOrOnDemand 統計資料

這份報表提供美國各州和哥倫比亞特區的播放詳細統計資料。支援 liveOrOnDemand 維度 (和篩選器)。

目錄
尺寸：
選用 province
使用 0 個以上 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
必填 country==US
使用 0 個以上 liveOrOnDemand、subscribedStatus、youtubeProduct
按省份列出播放詳細資料，並提供 averageViewPercentage 指標

以下報表與前一個類似，這個版本新增了averageViewPercentage指標的支援，但不支援將liveOrOnDemand做為維度或篩選器。

目錄
尺寸：
選用 province
使用 0 個以上 creatorContentType、subscribedStatus、youtubeProduct
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
必填 country==US
使用 0 個以上 subscribedStatus、youtubeProduct

播放位置

影片播放位置報表

這份報表提供影片播放次數的統計資料，並依據播放影片的頁面或應用程式類型分類。

目錄
尺寸：
必填 insightPlaybackLocationType
使用 0 個以上 creatorContentType、day、liveOrOnDemand、subscribedStatus
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus

播放位置詳細資料 (最多 25 項結果)

注意：如要產生這份報表，請將 maxResults 參數設為 25 以下的整數值。與大多數其他報表不同，這份報表也需要您為 sort 要求參數指定值。

這份報表會列出為內容擁有者內容帶來最多觀看次數或觀看時間的嵌入式影片播放器。擷取這份報表時，您必須將 insightPlaybackLocationType 篩選器設為 EMBEDDED。

目錄
尺寸：
必填 insightPlaybackLocationDetail
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
必填 insightPlaybackLocationType==EMBEDDED
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus
排序選項： -engagedViews
-views
-estimatedMinutesWatched

流量來源

流量來源

這份報表會根據觀眾觀看影片內容的方式，匯總觀看統計資料。舉例來說，這項指標會指出 Google 搜尋或相關影片連結帶來的觀看次數。

注意：如果「查詢的影片數量」X「日期範圍內的天數」超過 50,000，這份報表就會傳回錯誤。舉例來說，如果查詢擷取 500 個影片 ID 的資料，最多可要求 100 天的資料。如要減少要求傳回的列數，請將查詢拆分為多個查詢，並指定較少的影片或設定較短的日期範圍。

目錄
尺寸：
必填 insightTrafficSourceType
使用 0 個以上 creatorContentType、day、liveOrOnDemand、subscribedStatus
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus

流量來源詳細資料 (最多 25 項結果)

注意：如要產生這份報表，請將 maxResults 參數設為 25 以下的整數值。與大多數其他報表不同，這份報表也需要您為 sort 要求參數指定值。

這份報表會根據為內容擁有者內容帶來最多觀看次數的推薦來源，彙整觀看統計資料。參照連結網址會依流量來源類型分類，而 insightTrafficSourceDetail 維度的定義會指出報表適用的流量來源。舉例來說，如果將 insightTrafficSourceType 篩選器設為 ADVERTISING，報表就會列出為內容擁有者內容帶來最多觀看次數或觀看時間的廣告類型。

目錄
尺寸：
必填 insightTrafficSourceDetail
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
必填 insightTrafficSourceType (請參閱下表附註)
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus
排序選項： -engagedViews
-views
-estimatedMinutesWatched

注意：這份報表僅支援特定流量來源。VIDEO_REMIXES、NOTIFICATION、END_SCREEN、CAMPAIGN_CARD、VIDEO_REMIXES 和 NO_LINK_EMBEDDED 流量來源就是不支援的來源。

裝置類型和作業系統

裝置類型

這份報表會根據觀眾觀看內容時使用的裝置類型，匯總觀看統計資料。例如，系統會找出平板電腦或遊戲主機的觀看次數。

目錄
尺寸：
必填 deviceType
使用 0 個以上 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

作業系統

這份報表會根據觀眾的作業系統匯總觀看統計資料。舉例來說，這項資料會指出在 Android 裝置或 PlayStation 上發生的觀看次數。

目錄
尺寸：
必填 operatingSystem
使用 0 個以上 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 deviceType、liveOrOnDemand、subscribedStatus、youtubeProduct

作業系統和裝置類型

這份報表會根據觀眾的作業系統和裝置類型，匯總觀看統計資料。舉例來說，這項指標會指出在 Android 平板電腦或 Windows 桌機上發生的觀看次數。

目錄
尺寸：
必填 operatingSystem、deviceType
使用 0 個以上 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus、youtubeProduct

觀眾客層

這份報表會根據觀眾的年齡層和性別匯總觀看統計資料。

目錄
尺寸：
使用 1 個以上 ageGroup、gender
使用 0 個以上 creatorContentType、liveOrOnDemand、subscribedStatus
指標：
使用 1 個以上 viewerPercentage
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus
注意：這份報表中的 viewerPercentage 值不會針對不同 subscribedStatus 播放詳細資料維度值進行正規化。

舉例來說，如果報表使用 subscribedStatus 維度，則會傳回 viewerPercentage 資料，訂閱觀看次數的資料總和為 100%，且未訂閱觀看次數的 viewerPercentage 資料總和為 100%。(報表中所有 viewerPercentage 欄位的總值為 200%。)

您可以使用篩選器，確保報表只包含 subscribedStatus 維度一個值的 viewerPercentage 資料。

參與度和內容分享

這份報表會顯示頻道影片在不同社群平台上的分享頻率統計資料。

目錄
尺寸：
必填 sharingService
選用 creatorContentType、subscribedStatus
指標：
使用 1 個以上 分享
篩選器：
使用 1 個 影片、頻道、群組，或uploaderType和claimedStatus的支援組合
使用 0 或 1 country、continent、subContinent
選用 subscribedStatus

觀眾續看率

這份報表會評估影片吸引觀眾持續收看的成效。elapsedVideoTimeRatio 維度會測量相應指標值經過的影片時間量。audienceWatchRatio 和 relativeRetentionPerformance 這兩項指標可評估影片吸引觀眾駐足觀看的成效。第一個是絕對值，第二個則顯示影片相較於其他長度相近的 YouTube 影片，成效如何。

注意：觀眾續看率報表不支援為 video 篩選器指定以半形逗號分隔的值清單，值必須指定單一影片 ID。

目錄
尺寸：
必填 elapsedVideoTimeRatio
選用 creatorContentType
指標：
使用 1 個以上 audienceWatchRatio、relativeRetentionPerformance
篩選器：
必填 影片
使用 0 個以上 audienceType、subscribedStatus、youtubeProduct

熱門影片

注意：如要使用這些報表，請將 maxResults 參數設為 200 以下的整數值。2013 年 1 月 1 日前的資料僅適用於前 10 大影片。與大多數其他報表不同，這些報表也需要您為 sort 要求參數指定值。

整體、依國家/地區、依洲別或依次大陸列出的熱門影片 (最多 200 項結果)

這份報表會根據指定的篩選和排序條件，列出內容擁有者的熱門影片。

目錄
尺寸：
必填 影片
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、comments、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 頻道，或是支援的 uploaderType 和 claimedStatus 組合
使用 0 或 1 country、continent、subContinent
排序選項： -engagedViews
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

美國各州熱門影片 (最多 200 項結果)

這份報表會列出內容擁有者在特定美國州或哥倫比亞特區的熱門影片。請注意，這份報表僅支援上述國家/地區專屬報表中的部分指標。

目錄
尺寸：
必填 影片
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 頻道，或是支援的 uploaderType 和 claimedStatus 組合
必填 province
排序選項： -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

訂閱者或未訂閱者的熱門影片(最多 200 個結果)

這份報表會列出訂閱者或非訂閱者的熱門影片。你可以篩選報表，依國家/地區、洲別或subContinent列出熱門影片。先前的報表可讓您擷取特定美國州別中，訂閱者或未訂閱者的熱門影片，但支援的指標比這份報表少。

目錄
尺寸：
必填 影片
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 個 頻道，或是支援的 uploaderType 和 claimedStatus 組合
選用 subscribedStatus
使用 0 或 1 country、continent、subContinent
排序選項： -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

依 YouTube 產品列出的熱門影片 (最多 200 個結果)

這份報表會列出熱門影片，並支援播放詳細資料和地理位置篩選器。這份報表與前一份報表類似，但支援的指標較少，並新增了 youtubeProduct 篩選器。

目錄
尺寸：
必填 影片
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
篩選器：
使用 1 個 頻道，或是支援的 uploaderType 和 claimedStatus 組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 subscribedStatus、youtubeProduct
排序選項： -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

熱門影片 (含播放詳細資料篩選器) (<= 200 個結果)

這份報表會列出內容擁有者的熱門影片，並依一或多個播放詳細資料維度篩選：liveOrOnDemand、subscribedStatus 和 youtubeProduct。這份報表也支援依區域篩選。

目錄
尺寸：
必填 影片
選用 creatorContentType
指標：
使用 1 個以上 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
篩選器：
使用 1 個 頻道，或是支援的 uploaderType 和 claimedStatus 組合
使用 0 或 1 country、province、continent、subContinent
使用 0 個以上 liveOrOnDemand、subscribedStatus、youtubeProduct
排序選項： -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

播放清單報表

播放清單報表包含與使用者活動相關的指標，這些活動與頻道擁有者播放清單中的影片有關。這些報表有兩個版本，以下各節將說明每個版本：

匯總影片指標

這些指標提供使用者活動和曝光指標，彙整播放清單中所有影片的資料，且這些影片也屬於播放清單所屬的頻道。系統不會在匯總中計算其他頻道擁有的影片指標。因此，如果頻道建立的播放清單只包含其他頻道的影片，這些播放清單的報表就不會提供這些指標的值。

如需 YouTube 支援的匯總影片指標清單，請參閱「支援的播放清單指標」一節。

播放清單內指標

這些指標反映使用者在播放清單頁面中的活動和參與度。這些指標包括播放清單中所有影片的觀看次數，無論影片屬於哪個頻道，但只會計算在播放清單中發生的觀看次數。

支援的播放清單指標

目錄
匯總影片指標 engagedViews、views、estimatedMinutesWatched、averageViewDuration
播放清單內指標 playlistViews、playlistEstimatedMinutesWatched、playlistAverageViewDuration、 playlistSaves、playlistStarts、 viewsPerPlaylistStart、averageTimeInPlaylist

基本數據

這份報表提供統計資料，瞭解使用者與內容擁有者頻道中播放清單影片的互動情形。報表缺少必要維度。

目錄
尺寸：
[None]
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel

根據時間

這份報表提供特定時間間隔內，使用者與內容擁有者頻道播放清單中影片的互動統計資料。您可以篩選報表，只傳回特定播放清單或頻道的資料。

目錄
尺寸：
使用 1 個 天、月
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel

使用者地理位置

這份報表提供特定國家/地區使用者與頻道播放清單中影片互動的相關統計資料。

這份報表會依國家/地區提供播放清單統計資料。

目錄
尺寸：
必填 country
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched、averageViewDuration
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
使用 0 或 1 continent、subContinent
選用 channel

按省份劃分的播放清單活動

這份報表提供美國各州和哥倫比亞特區的播放清單活動統計資料。在這份報表中，您會在 filters 參數值中加入 country==US。

目錄
尺寸：
必填 province
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched、averageViewDuration
篩選器：
必填 country==US
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel

播放位置

這份報表會提供播放清單播放次數的統計資料，並依發生播放次數的頁面或應用程式類型分類。

目錄
尺寸：
必填 insightPlaybackLocationType
指標：
使用 1 個以上 engagedViews、觀看次數、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel

播放位置詳細資料 (最多 25 項結果)

注意：如要產生這份報表，請將 maxResults 參數設為 25 以下的整數值。與大多數其他報表不同，這份報表也需要您為 sort 要求參數指定值。

這份報表會找出為內容擁有者播放清單帶來最多觀看次數或觀看時間的嵌入式影片播放器。

目錄
尺寸：
必填 insightPlaybackLocationDetail
指標：
使用 1 個以上 engagedViews、觀看次數、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
必填 insightPlaybackLocationType==EMBEDDED
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel
排序選項： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

流量來源

這份報表會根據觀眾觀看播放清單內容的方式，匯總觀看統計資料。舉例來說，這項指標會指出 Google 搜尋或頻道頁面帶來的觀看次數。

目錄
尺寸：
必填 insightTrafficSourceType
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel

流量來源詳細資料 (最多 25 項結果)

注意：如要產生這份報表，請將 maxResults 參數設為 25 以下的整數值。與大多數其他報表不同，這份報表也需要您為 sort 要求參數指定值。

這份報表會根據為內容擁有者播放清單帶來最多觀看次數的參照連結網址，匯總觀看統計資料。參照連結網址會依流量來源類型分類，而 insightTrafficSourceDetail 維度的定義會指出報表適用的流量來源。舉例來說，如果將 insightTrafficSourceType 篩選器設為 ADVERTISING，報表就會列出為內容擁有者的播放清單帶來最多觀看次數或觀看時間的廣告類型。

目錄
尺寸：
必填 insightTrafficSourceDetail
指標：
使用 1 個以上 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
必填 insightTrafficSourceType
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel
排序選項： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

注意：這份報表僅支援特定流量來源。VIDEO_REMIXES、NOTIFICATION、END_SCREEN、CAMPAIGN_CARD、VIDEO_REMIXES 和 NO_LINK_EMBEDDED 流量來源就是不支援的來源。

裝置類型和作業系統

播放清單的裝置類型

這份報表會根據觀眾觀看播放清單內容時使用的裝置類型，匯總觀看統計資料。舉例來說，這項指標會顯示行動裝置或遊戲主機的觀看次數。

目錄
尺寸：
必填 deviceType
指標：
使用 1 個以上 engagedViews、觀看次數、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel

播放清單的作業系統

這份報表會根據觀眾的作業系統匯總觀看統計資料。舉例來說，這項資料會指出在 Android 裝置或 PlayStation 上發生的播放清單觀看次數。

目錄
尺寸：
必填 operatingSystem
指標：
使用 1 個以上 engagedViews、觀看次數、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel

播放清單的作業系統和裝置類型

這份報表會根據觀眾的作業系統和裝置類型，匯總觀看統計資料。舉例來說，這項指標會指出在 Android 平板電腦或 Windows 桌機上觀看播放清單的次數。

目錄
尺寸：
必填 deviceType、operatingSystem
指標：
使用 1 個以上 engagedViews、觀看次數、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel

觀眾客層

這份報表會根據觀眾的年齡層和性別匯總觀看統計資料。

目錄
尺寸：
使用 1 個以上 ageGroup、gender
指標：
必填 viewerPercentage
篩選器：
使用 0 或 1 個 * 播放清單、群組

注意：如果報表要求提供任何觀看次數、estimatedMinutesWatched 或averageViewDuration指標，則必須指定其中一個篩選器。
選用 channel
注意：這份報表中的 viewerPercentage 值，不會針對播放詳細資料維度 (subscribedStatus 和 youtubeProduct) 的不同值或值組合進行正規化。

舉例來說，使用 subscribedStatus 維度的報表會傳回 viewerPercentage 資料，訂閱觀看次數的資料總和為 100%，而未訂閱觀看次數的資料總和也為 100%。viewerPercentage(報表中所有 viewerPercentage 欄位的總值為 200%。)

您可以使用篩選器，確保報表只包含播放詳細資料維度中一個值 (或值組合) 的 viewerPercentage 資料。

觀看時間最長的播放清單

注意：如要使用這些報表，請將 maxResults 參數設為 200 以下的整數值。2013 年 1 月 1 日之前的資料僅適用於前 10 名的播放清單。與大多數其他報表不同，這些報表也需要您為 sort 要求參數指定值。

這份報表會根據指定的篩選和排序條件，列出內容擁有者的熱門播放清單。

目錄
尺寸：
必填 播放清單
指標：
使用 1 個以上 averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
排序選項： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

廣告成效報表

注意：廣告成效報表需要授權權杖，才能授予 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 範圍的存取權。

廣告成效報表會提供影片播放期間放送廣告的曝光次數指標。這些指標會計算每次廣告曝光，而每次播放影片可能會產生多次曝光。

以曝光為準的廣告成效指標包括：

此外，部分影片報表支援下列以播放為準的廣告成效指標。不過，廣告成效報表不會納入這些指標。

依廣告類型劃分的廣告成效

目錄
尺寸：
必填 adType
選用 天
指標：
使用 1 個以上 grossRevenue、adImpressions、cpm
篩選器：
使用 1 個 影片、群組，或支援的 uploaderType 和 claimedStatus 組合
使用 0 或 1 country、continent、subContinent