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 Analytics 群組和群組項目。
https://www.googleapis.com/auth/youtubepartner 查看及管理 YouTube 素材資源和相關內容。在 YouTube Analytics API 中，內容擁有者可使用這個範圍管理 YouTube Analytics 群組和群組項目。

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

篩選器

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

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

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

請參閱 filters 參數定義，瞭解如何篩選特定值或值組合的 API 結果。

瞭解報表表格

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

目錄
尺寸：
使用 0 或更多 creatorContentType、subscribedStatus、youtubeProduct
使用 0 或 1 day、month
指標：
使用 1 個以上 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
篩選器：
使用 0 或 1 country、province、continent、subContinent
使用 0 或 1 video、group
使用 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 要求，都必須使用 影片維度、頻道維度、群組維度，或是 claimedStatus 和 uploaderType 維度的支援組合來篩選資料。(部分報表不支援所有這些選項)。系統支援的組合 (亦列於 uploaderType 維度的定義中) 如下：
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

影片報表

基本統計資料

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

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

目錄
尺寸：
[None]
指標：
使用 1 個以上 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、estimatedRevenue*、estimatedAdRevenue*、grossRevenue*、estimatedRedPartnerRevenue*、monetizedPlaybacks*、playbackBasedCpm*、adImpressions*、cpm*
篩選器：
使用 1 影片、頻道、群組，或支援的 uploaderType 和 claimedStatus 組合
使用 0 或 1 country、continent、subContinent

美國各州的基本統計資料

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

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

根據時間

時間範圍的活動

這份報表會提供與使用者動作相關的統計資料，範圍涵蓋特定時間間隔內的所有內容擁有者頻道。你可以篩選報表，只顯示特定影片或國家/地區的資料。

目錄
尺寸：
使用 1 day、month
選用 creatorContentType
指標：
使用 1 個以上 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 day、month
選用 creatorContentType
指標：
使用 1 個以上 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 個以上 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、estimatedRevenue*、estimatedAdRevenue*、grossRevenue*、estimatedRedPartnerRevenue*、monetizedPlaybacks*、playbackBasedCpm*、adImpressions*、cpm*
篩選器：
使用 1 影片、頻道、群組，或支援的 uploaderType 和 claimedStatus 組合
使用 0 或 1 continent、subContinent

使用者活動 (依省分組)

這份報表提供美國各州和哥倫比亞特區的使用者活動統計資料。針對這份報表，您必須將 filters 參數值設為 country==US。

目錄
尺寸：
必填 province
選用 creatorContentType
指標：
使用 1 個以上 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 day、month
指標：
使用 1 個以上 觀看次數、estimatedMinutesWatched、averageViewDuration、averageViewPercentage
篩選器：
使用 1 影片、頻道、群組，或支援的 uploaderType 和 claimedStatus 組合
使用 0 或 1 country、province、continent、subContinent
排序選項： -views
-estimatedMinutesWatched

播放詳細資料

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

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

從技術層面來說，這些報表支援的播放詳細資料維度皆為選填。如果您未在要求中加入播放詳細資料維度，系統傳回的報表其實會類似於基本統計資料、時間或使用者地理區域報表。

注意：liveOrOnDemand 維度和篩選器無法與 averageViewPercentage 指標搭配使用。因此，下列各個子區段都會列出兩份報表。一個報表支援「liveOrOnDemand」liveOrOnDemand維度 (和篩選器)，另一個報表則支援「averageViewPercentage」averageViewPercentage指標。

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

這份報表會提供訂閱和未訂閱觀眾的使用者活動指標。統計資料可依時間範圍 (一天或一個月) 分組，報表也可以依國家/地區、大陸或subContinent進行篩選。

目錄
尺寸：
使用 0 或更多 creatorContentType、subscribedStatus
使用 0 或 1 day、month
指標：
使用 1 個以上 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 day、month
指標：
使用 1 個以上 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
篩選器：
使用 1 影片、頻道、群組，或支援的 uploaderType 和 claimedStatus 組合
必填 province
選用 subscribedStatus

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

這些報表的時間維度 (day 或 month) 為選用項目，因為無論如何，您都需要使用 startDate 和 endDate 要求參數，指定報表涵蓋的日期範圍。如果有這個維度，表示您希望報表中的資料依日、月等進行匯總。

播放詳細資料 (含選用時間維度和 liveOrOnDemand 統計資料)

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

目錄
尺寸：
使用 0 或更多 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
使用 0 或 1 day、month
指標：
使用 1 個以上 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 day、month
指標：
使用 1 個以上 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 個以上 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 個以上 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 個以上 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
篩選器：
使用 1 影片、頻道、群組，或支援的 uploaderType 和 claimedStatus 組合
必填 country==US
使用 0 或更多 liveOrOnDemand、subscribedStatus、youtubeProduct
按省份劃分的播放詳細資料，並顯示averageViewPercentage 指標

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

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

播放位置

影片播放位置報表

這份報表會提供與影片播放網頁或應用程式類型相關的統計資料。

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

播放位置詳細資料 (<= 25 個結果)

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

這份報表會指出哪些嵌入式影片播放器為內容擁有者產生最多觀看次數或觀看時間。擷取這份報表時，請務必將 insightPlaybackLocationType 篩選器設為 EMBEDDED。

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

流量來源

流量來源

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

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

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

流量來源詳細資料 (<= 25 個結果)

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

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

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

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

裝置類型和作業系統

裝置類型

這份報表會根據觀眾觀看內容時使用的裝置類型，匯總觀看統計資料。舉例來說，這項指標會指出在平板電腦或遊戲主機上發生的觀看次數。

目錄
尺寸：
必填 deviceType
使用 0 或更多 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標：
使用 1 個以上 觀看次數、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 個以上 觀看次數、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 個以上 觀看次數、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
注意：如果報表使用subscribedStatus維度，則會針對已訂閱的觀看次數傳回viewerPercentage資料，總和為 100%，針對未訂閱的觀看次數傳回viewerPercentage資料，總和為 100%。viewerPercentagesubscribedStatus

(報表中所有 viewerPercentage 欄位總值為 200 個百分比。)

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

互動和內容分享

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

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

觀眾續看率

這份報表可評估影片吸引觀眾續看的能力。elapsedVideoTimeRatio 維度會針對對應的指標值，計算影片播放的時間長度。audienceWatchRatio 和 relativeRetentionPerformance 指標提供兩項評估指標，顯示影片吸引觀眾續看的成效。第一項是絕對值，第二項則顯示影片相較於其他長度相近的 YouTube 影片的成效。

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

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

熱門影片

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

整體熱門影片 (依國家/地區、洲別或次大陸劃分) (<= 200 個結果)

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

目錄
尺寸：
必填 video
選用 creatorContentType
指標：
使用 1 個以上 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、estimatedRevenue*、estimatedAdRevenue*、grossRevenue*、estimatedRedPartnerRevenue*、monetizedPlaybacks*、playbackBasedCpm*、adImpressions*、cpm*
篩選器：
使用 1 channel，或支援的 uploaderType 和 claimedStatus 組合
使用 0 或 1 country、continent、subContinent
排序選項： -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

美國各州熱門影片總覽 (<= 200 個結果)

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

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

訂閱者或非訂閱者觀眾的熱門影片(<= 200 個結果)

這份報表會列出訂閱者或未訂閱者觀看次數最多的影片。你可以篩選報表，依國家/地區、洲別或subContinent列出熱門影片。前述報表可讓你擷取美國特定州的熱門影片，針對訂閱或未訂閱的觀眾進行比較，但支援的指標比這份報表少。

目錄
尺寸：
必填 video
選用 creatorContentType
指標：
使用 1 個以上 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 channel，或支援的 uploaderType 和 claimedStatus 組合
選用 subscribedStatus
使用 0 或 1 country、continent、subContinent
排序選項： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

YouTube 產品的熱門影片 (200 個結果以下)

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

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

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

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

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

播放清單報表

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

  • 每個部分的「建議」分頁會說明擷取對應報表的偏好 API 要求格式。建議的報表支援更多指標，包括匯總影片指標和播放清單內指標。這類要求格式不會使用 isCurated 維度。
  • 每個部分的「使用 isCurated」分頁說明舊版 API 要求格式，其中需要 isCurated 維度。這些報表僅支援播放清單內指標。請注意，isCurated 維度已不適用於所有報表。下方的警告附註說明瞭淘汰時間表。

下列警告說明會詳細說明這兩個報表版本之間的差異。

匯總影片指標

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

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

播放清單內指標

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

支援的播放清單指標

基本統計資料

這份報表提供與使用者與內容擁有者頻道播放清單中影片互動相關的統計資料。報表未提供任何必要維度。

使用 isCurated
目錄
尺寸：
[None]
指標：
使用 1 個以上 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
篩選器：
必填 isCurated==1
使用 0 或 1 頻道、播放清單、群組
使用 0 或 1 country、province、continent、subContinent
使用 0 或更多 subscribedStatus、youtubeProduct

根據時間

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

使用者地理位置

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

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

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

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

播放位置

這份報表會提供與播放清單播放位置 (網頁或應用程式) 相關的統計資料。

播放位置詳細資料 (<= 25 個結果)

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

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

建議
目錄
尺寸：
必填 insightPlaybackLocationDetail
指標：
使用 1 個以上 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
必填 insightPlaybackLocationType==EMBEDDED
使用 0 或 1* playlist、group

注意：如果報表要求提供 views、estimatedMinutesWatched 或 averageViewDuration 等指標，則必須指定其中一個篩選器。
選用 管道
排序選項： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

流量來源

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

建議
目錄
尺寸：
必填 insightTrafficSourceType
指標：
使用 1 個以上 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
使用 0 或 1* playlist、group

注意：如果報表要求提供 views、estimatedMinutesWatched 或 averageViewDuration 等指標，則必須指定其中一個篩選器。
選用 管道

流量來源詳細資料 (<= 25 個結果)

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

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

建議
目錄
尺寸：
必填 insightTrafficSourceDetail
指標：
使用 1 個以上 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
篩選器：
必填 insightTrafficSourceType
使用 0 或 1* playlist、group

注意：如果報表要求提供 views、estimatedMinutesWatched 或 averageViewDuration 等指標，則必須指定其中一個篩選器。
選用 管道
排序選項： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

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

裝置類型和作業系統

播放清單的裝置類型

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

播放清單的作業系統

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

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

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

觀眾客層

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

注意：這份報表中的 viewerPercentage 值並未針對不同的值或組合值進行標準化，這些值是指播放詳細資料維度 (subscribedStatus 和 youtubeProduct)。

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

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

觀看時間最長的播放清單

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

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

使用 isCurated
目錄
尺寸：
必填 playlist
指標：
使用 1 個以上 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
篩選器：
必填 isCurated==1
使用 0 或 1 播放清單、頻道
使用 0 或 1 country、province、continent、subContinent
使用 0 或更多 subscribedStatus、youtubeProduct
排序選項： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

廣告成效報表

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

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

以曝光為準的廣告成效指標如下：

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

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

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