本頁面由 Cloud Translation API 翻譯而成。

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 維度、isCurated 維度或支援的 claimedStatus 和 uploaderType 維度組合篩選資料。(支援的組合列於 uploaderType 維度的定義中)。

此表格用來說明支援的報表，指出可用於任何特定報表的篩選器。在說明中，括號中顯示的篩選器是選填項目。例如，如果報表將「video(,country)」列為篩選選項，您可以篩選報表只顯示特定影片的資料，或只納入特定國家/地區中特定影片的資料。

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

如需如何依據特定值或一組值篩選 API 結果的完整說明，請參閱 filters 參數定義。

瞭解報表表格

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

維度：

使用 0 以上的數字	creatorContentType、subscribedStatus、youtubeProduct
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

表格中會包含兩個維度列、一列指標資料，以及篩選器的三列。以維度和篩選器來說，只要組合符合表格中的使用規則，即可在 API 要求中合併每個資料列的值。因此，這份報表的有效 dimensions 參數值包括：

dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct

然而，參數值 day,month 無效，因為它使用兩個以時間為準的維度，但要求可使用 0 或 1。在此情況下，參數值 subscribedStatus,youtubeProduct 實際上確實會傳回報表，但不會依日期、週、月等項目匯總指標 (報表會單獨記錄在說明文件中)。

報表表格術語

表格使用下列術語，指明維度是必要或選用：

這些字詞代表必須提供值：
- 必要：必須包含值。
- 使用剛好 1：必須包含群組中的一個值。
- 使用 1 或多個：您可以加入群組中的任一或所有值，但必須加入至少一個值。
以下字詞代表值為選填：
- 選用：您可以選擇加入值。
- 使用 0 或 1：您可以選擇從群組中加入一個值。
- 使用 0 以上的值：您可以選擇加入群組中的任何值或所有值。

重要事項：所有用來擷取內容擁有者影片報表的 API 要求都必須使用「影片」維度、「頻道」維度、「群組」維度，或是支援的 claimedStatus 和 uploaderType 維度組合來篩選資料。(有些報表不支援上述所有選項)。支援的組合列於 uploaderType 維度定義中，包括：

uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty

影片報表

基本統計資料

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

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

維度：

[無]

指標：

使用 1 個以上

view1, redViews, 留言, 喜歡次數 65, <預估成效>1,560,60%, <預估成效>}{6,500,600,600,600,60 得{預估收益{統計}收益, {預估觀看次數{/211,600,600,600 次{/11,60}實際觀看次數{預估觀看次數 1,600,600,60 萬次,videosAddedToPlaylists 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

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、Europe、subContinent

美國各州的基本統計資料

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

維度：

[無]

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
必要	province

根據時間

一段時間內的活動

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

維度：

只使用 1 個	day、month
選用	creatorContentType

指標：

使用 1 個以上

views, redViews, 留言, 喜歡次數 65, <預估成效>1,560%, <預估成效>}{15,60%{<數字>平均觀看時間 6,51,600,600,600,000,610,600{/11,6 更千次平均觀看次數{/211,600,600 次上的觀看次數{/211,60}實際觀看次數{/161,601,60}實際觀看次數{/11 videosAddedToPlaylists 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

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、Europe、subContinent

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

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

維度：

只使用 1 個	day、month
選用	creatorContentType

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
必要	province

使用者地理位置

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

這份報表針對某位內容擁有者頻道，提供各國家/地區使用者活動的相關統計資料。你可以篩選報表，只傳回特定影片或頻道的資料。

維度：

必要	country
選用	creatorContentType

指標：

使用 1 個以上

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	land、subContinent

使用者活動 (依省分組)

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

維度：

必要	province
選用	creatorContentType

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
必要	country==美國

使用者活動 (按城市劃分) (<= 250 筆結果)

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

此報表按城市列出使用者活動統計資料。

維度：

必要	city
使用 0 以上的數字	creatorContentType、country、province、subscribedStatus 注意：如果加入「州/省」維度，也必須使用 `country==US` 篩選器。
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent

排序選項： -觀看次數
-estimatedMinutesWatched

播放詳細資料

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

觀看的是即時影像或隨選影片嗎？
觀眾是否已訂閱擁有影片的頻道？
這發生在哪項 YouTube 產品上？

嚴格來說，這些報表支援的播放詳情維度都是選用。如果您的要求中不包含播放詳細資料維度，系統實際上會傳回類似基本統計資料、時間型或使用者地理位置報表。

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

使用者活動 (依訂閱狀態區分)

這份報表會針對已訂閱和未訂閱的觀眾提供使用者活動指標。統計資料可以按時間範圍 (日或月) 分類，而且也可以按國家/地區、洲或subContinent來篩選。

維度：

使用 0 以上的數字	creatorContentType、subscribedStatus
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、按讚、不喜歡的次數、videosAddedToPlaylists、videosRemovedFromPlaylists、分享、estimatedMinutesWatched averageViewPercentage annotationCloseRate annotationImpressions annotationClickableImpressions annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、Europe、subContinent
選用	subscribedStatus

使用者活動 (依州/省的訂閱狀態劃分)

這份報表會針對美國各州或哥倫比亞特區，顯示訂閱/未訂閱觀眾的使用者活動指標。這份報表支援的指標少於先前的報表。

維度：

使用 0 以上的數字	creatorContentType、subscribedStatus
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
必要	province
選用	subscribedStatus

含有選用時間維度的播放詳細資料

這些報表不一定要使用時間維度 (「日」或「月」)，因為無論如何，您必須使用 startDate 和 endDate 請求參數來指定報表涵蓋的日期範圍。這個維度 (如果有的話) 表示您希望報表中的資料按日期、月份等方式匯總。

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

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

維度：

使用 0 以上的數字	creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	liveOrOnDemand、subscribedStatus、youtubeProduct

含有選用時間維度和 averageViewPercentage 指標的播放詳細資料

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

維度：

使用 0 以上的數字	creatorContentType、subscribedStatus、youtubeProduct
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	subscribedStatus、youtubeProduct

各國家/地區的播放詳細資料

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

這份報表提供各國家/地區的播放詳情。支援 liveOrOnDemand 維度 (和篩選器)。

維度：

選用	country
使用 0 以上的數字	creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	land、subContinent
使用 0 以上的數字	liveOrOnDemand、subscribedStatus、youtubeProduct

依國家/地區顯示 averageViewPercentage 指標

以下報表與上一個報表類似。新增對 averageViewPercentage 指標的支援，但不支援 liveOrOnDemand 維度或篩選器。

維度：

選用	country
使用 0 以上的數字	creatorContentType、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	land、subContinent
使用 0 以上的數字	subscribedStatus、youtubeProduct

各州/省的播放詳細資料

使用 liveOrOnDemand 統計資料的各州/省播放詳細資料

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

維度：

選用	province
使用 0 以上的數字	creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
必要	國家/地區`==US`
使用 0 以上的數字	liveOrOnDemand、subscribedStatus、youtubeProduct

使用 averageViewPercentage 指標各州的播放詳細資料

以下報表與上一個報表類似。新增對 averageViewPercentage 指標的支援，但不支援 liveOrOnDemand 維度或篩選器。

維度：

選用	province
使用 0 以上的數字	creatorContentType、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
必要	國家/地區`==US`
使用 0 以上的數字	subscribedStatus、youtubeProduct

播放位置

影片播放位置報表

這份報表會針對發生影片播放的頁面或應用程式類型，提供相關的統計資料。

維度：

必要	insightPlaybackLocationType
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

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

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

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

維度：

必要	insightPlaybackLocationDetail
選用	creatorContentType

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
必要	insightPlaybackLocationType==EMBEDDED
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

排序選項：

-觀看次數
-estimatedMinutesWatched

流量來源

此報告會依據觀眾找到您的影片內容的方式，彙整觀看統計資料。例如，此功能可識別出自 Google 搜尋結果或相關影片連結帶來的觀看次數。

維度：

必要	insightTrafficSourceType
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

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

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

本報告會根據為內容擁有者的內容產生最多觀看次數的推薦連結來源，彙整檢視統計資料。「參照網址」是按流量來源類型分類，而 insightTrafficSourceDetail 維度的定義可以看出報表提供的流量來源。舉例來說，如果您將 insightTrafficSourceType 篩選器設為 ADVERTISING，報表會列出為內容擁有者的內容帶來最多觀看次數或觀看時間的廣告類型。

維度：

必要	insightTrafficSourceDetail
選用	creatorContentType

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
必要	insightTrafficSourceType (請見下表的附註)
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

排序選項：

-觀看次數
-estimatedMinutesWatched

注意：這份報表僅適用於特定流量來源。舉例來說，NO_LINK_EMBEDDED 流量來源無法提供額外的詳細資料，因此不支援這份報表。如要進一步瞭解哪些流量來源支援這份報表，請參閱 insightTrafficSourceType 定義。

裝置類型和作業系統

裝置類型

此報表會根據觀眾觀看你內容時使用的裝置類型，彙整檢視統計資料。舉例來說，可用來識別平板電腦或遊戲主機上的觀看次數。

維度：

必要	deviceType
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

作業系統

此報表根據觀眾的作業系統彙整檢視統計資料。例如，可識別 Android 裝置或 PlayStation 上產生的觀看次數。

維度：

必要	operatingSystem
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	deviceType、liveOrOnDemand、subscribedStatus、youtubeProduct

作業系統和裝置類型

這份報表會依據觀眾的作業系統和裝置類型，彙整查看統計資料。舉例來說，您可以識別 Android 平板電腦或 Windows 電腦裝置上的觀看次數。

維度：

必要	operatingSystem,deviceType
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	liveOrOnDemand、subscribedStatus、youtubeProduct

觀眾客層

此報告會根據觀眾的年齡層和性別，匯總檢視統計資料。

維度：

使用 1 個以上	ageGroup、gender
使用 0 以上的數字	creatorContentType、liveOrOnDemand、subscribedStatus

指標：

使用 1 個以上

viewerPercentage

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

注意：這份報表中的 viewerPercentage 值並未針對 subscribedStatus 播放詳細資料維度的不同值進行正規化。

舉例來說，如果報表使用「subscribedStatus」subscribedStatus維度，系統會傳回 viewerPercentage 資料值和 viewerPercentage 1010 數據的加總值。(報表中所有 viewerPercentage 欄位的總值為 200%)。

您可以使用篩選器，確保報表僅包含「subscribedStatus」subscribedStatus維度的一個 viewerPercentage 欄位資料。

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

維度：

必要	sharingService
選用	creatorContentType、subscribedStatus

指標：

使用 1 個以上

篩選器：

只使用 1 個	video、channel、group 或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、Europe、subContinent
選用	subscribedStatus

觀眾續看率

這份報表會評估影片留住觀眾的能力。「elapsedVideoTimeRatio」維度會測量對應指標值經過的影片量。audienceWatchRatio 和 relativeRetentionPerformance 指標提供兩項評估結果，說明影片留住觀眾的成效。第一個是絕對值，第二項代表影片與其他長度相近的 YouTube 影片相比，成效如何。

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

維度：

必要	elapsedVideoTimeRatio
選用	creatorContentType

指標：

使用 1 個以上

audienceWatchRatio、relativeRetentionPerformance

篩選器：

必要	影片
使用 0 以上的數字	audienceType、subscribedStatus、youtubeProduct

播放清單報表

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

各節的「建議做法」分頁會說明用來擷取對應報表的建議 API 要求格式。建議的報表支援一組更多指標，同時提供匯總影片指標和播放清單內指標。這個要求格式不使用 isCurated 維度。
各節的「使用 isCurated」分頁說明瞭需要 isCurated 維度的舊版 API 要求格式。這些報表僅支援播放清單內指標。請注意，所有報表的 isCurated 維度已淘汰。以下警告附註說明淘汰時間表。

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

重要事項：請在 2024 年 6 月 30 日前更新頻道的播放清單報表，並於 2024 年 12 月 31 日前更新內容擁有者的播放清單報表。請注意下列異動：

淘汰了 isCurated 維度。
- 如果是管道報表，自 2024 年 6 月 30 日起，系統將不再支援這項維度。
- 內容擁有者報表：2024 年 12 月 31 日當天或之後不再支援這項維度。
從擷取播放清單報表的要求中移除 isCurated 維度後，views 指標的行為就會改變：
- 如果要求包含 isCurated 維度，views 指標代表影片在播放清單中的觀看次數。
- 如果要求不包含 isCurated 維度，views 指標會指定影片的觀看總次數，playlistViews 指標則代表影片在播放清單中的觀看次數。

因此，為了在移除 isCurated 維度時保留回溯相容性，您必須一併更新程式碼以擷取 playlistViews 指標，而非僅適用於播放清單報表的 views 指標。由於播放清單報表仍支援 views 指標，儘管指標不同，但如果您未更新指標名稱，API 仍會傳回資料。當然，您可以修改應用程式，以擷取及顯示 views 和 playlistViews。

詳情請參閱修訂版本記錄。

匯總影片指標

這些指標提供使用者活動和曝光指標，而這些指標是匯總播放清單中所有影片 (屬於播放清單擁有者) 的影片。匯總結果不會計算其他頻道擁有的影片相關指標。所以如果頻道建立的播放清單只包含其他頻道擁有的影片，那麼這些播放清單的報表將不會顯示這些指標的值。

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

播放清單中的指標

這些指標反映了播放清單頁面中的使用者活動和參與度。無論影片擁有者屬於哪個頻道，這些指標都會計入播放清單中所有影片的觀看次數，但只會計入播放清單內容的觀看次數。

支援的播放清單指標

重要事項：如下表所示，views 指標會在每份播放清單報表的兩個可用版本中，提供不同類型的資料。

在建議報表格式中，views 是匯總影片指標。
在使用 isCurated 維度擷取的報表中，views 是播放清單中的指標。

建議

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

使用 isCurated

目錄
匯總影片指標	不支援
播放清單中的指標	views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage、redViews、estimatedRedMinutesWatched

基本統計資料

這份報表會針對內容擁有者頻道中播放清單的影片，提供相關的統計資料。報表沒有任何必要維度。

建議

維度：

[無]

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

「isCurated」維度已淘汰，自 2024 年 12 月 31 日起，內容擁有者報表亦不再支援這項維度。播放清單報表遷移指南說明與此次淘汰相關的其他變更。

維度：

[無]

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	channel、playlist、group
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	subscribedStatus、youtubeProduct

根據時間

這份報表針對內容擁有者的頻道中，使用者與播放清單中影片的互動情形提供相關統計資料。你可以篩選報表，只傳回特定播放清單或頻道的資料。

建議

維度：

只使用 1 個

day、month

指標：

使用 1 個以上

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

維度：

只使用 1 個	day、month
使用 0 以上的數字	subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	channel、playlist、group
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	subscribedStatus、youtubeProduct

使用者地理位置

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

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

建議

維度：

必要

country

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
請使用 0 或 1	land、subContinent
選用	頻道

使用 isCurated

維度：

必要	country
使用 0 以上的數字	subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	land、subContinent
請使用 0 或 1	playlist、channel、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

播放清單活動 (按州/省劃分)

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

建議

維度：

必要

province

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration

篩選器：

必要	國家/地區`==US`
請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

維度：

必要	province
使用 0 以上的數字	subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1;國家/地區`==US`
請使用 0 或 1	channel、playlist、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

播放位置

這份報表會針對播放播放清單的頁面或應用程式類型，提供相關的統計資料。

建議

維度：

必要	insightPlaybackLocationType

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

維度：

必要	insightPlaybackLocationType
使用 0 以上的數字	day、subscribedStatus

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	playlist、channel、group
選用	subscribedStatus

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

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

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

建議

維度：

必要	insightPlaybackLocationDetail

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

必要	insightPlaybackLocationType`==EMBEDDED`
請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

排序選項： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

使用 isCurated

維度：

必要	insightPlaybackLocationDetail

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1;insightPlaybackLocationType`==EMBEDDED`
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	playlist、channel、group
選用	subscribedStatus

排序選項： -views
-estimatedMinutesWatched
-playlistStarts

流量來源

這份報表會依據觀眾找到播放清單內容的方式，彙整觀看統計資料。例如，這個分頁可識別來自 Google 搜尋或頻道頁面的觀看次數。

建議

維度：

必要	insightTrafficSourceType

指標：

使用 1 個以上

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

維度：

必要	insightTrafficSourceType
使用 0 以上的數字	day、subscribedStatus

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	playlist、channel、group
選用	subscribedStatus

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

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

這份報表會依據為內容擁有者的播放清單產生最多觀看次數的參照網址，匯總檢視統計資料。「參照網址」是按流量來源類型分類，而 insightTrafficSourceDetail 維度的定義可以看出報表提供的流量來源。舉例來說，如果您將 insightTrafficSourceType 篩選器設為 ADVERTISING，報表會列出為內容擁有者的播放清單帶來最多觀看次數或觀看時間的廣告類型。

建議

維度：

必要	insightTrafficSourceDetail

指標：

使用 1 個以上

篩選器：

必要	insightTrafficSourceType
請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

排序選項：

-playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

使用 isCurated

維度：

必要	insightTrafficSourceDetail

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1;insightTrafficSourceType
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	playlist、channel、group
選用	subscribedStatus

排序選項：

-views
-estimatedMinutesWatched
-playlistStarts

裝置類型和作業系統

播放清單的裝置類型

這份報表會依據觀眾觀看播放清單內容的裝置類型，彙整觀看統計資料。舉例來說，可用來找出行動裝置或遊戲主機上的觀看次數。

建議

維度：

必要	deviceType

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

維度：

必要	deviceType
使用 0 以上的數字	day、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	playlist、channel、group
使用 0 以上的數字	operatingSystem、subscribedStatus、youtubeProduct

播放清單的作業系統

此報表根據觀眾的作業系統彙整檢視統計資料。例如，可用來識別來自 Android 裝置或 PlayStations 的播放清單觀看次數。

建議

維度：

必要	operatingSystem

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

維度：

必要	operatingSystem
使用 0 以上的數字	day、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	playlist、channel、group
使用 0 以上的數字	deviceType、subscribedStatus、youtubeProduct

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

這份報表會依據觀眾的作業系統和裝置類型，彙整查看統計資料。例如，可用來識別來自 Android 平板電腦或 Windows 電腦裝置的播放清單觀看次數。

建議

維度：

必要	deviceType、operatingSystem

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

維度：

必要	deviceType、operatingSystem
使用 0 以上的數字	day、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	playlist、channel、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

觀眾客層

此報告會根據觀眾的年齡層和性別，匯總檢視統計資料。

建議

維度：

使用 1 個以上

ageGroup、gender

指標：

必要	viewerPercentage

篩選器：

請使用 0 或 1^*	playlist、group 注意：如果報表中要求提供任何資料檢視、estimatedMinutesWatched 或 averageViewDuration，就必須指定其中一個篩選條件。
選用	頻道

使用 isCurated

維度：

使用 1 個以上	ageGroup、gender
使用 0 以上的數字	subscribedStatus

指標：

必要	viewerPercentage

篩選器：

必要	isCurated==1
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	playlist、channel、group
選用	subscribedStatus

注意：這份報表中的 viewerPercentage 值是以不同的值或播放詳細資料維度 (subscribedStatus 和 youtubeProduct) 的組合值標準化。

舉例來說，採用 subscribedStatus 維度的報表會傳回 viewerPercentage 資料，加總後 65% 的 viewerPercentage(報表中所有 viewerPercentage 欄位的總值是 200%)。

您可以使用篩選器，確保報表只納入某個播放詳情維度的「viewerPercentage」viewerPercentage資料值 (或值組合)。

廣告成效報表

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

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

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

此外，部分影片報表支援下列播放次數型廣告成效指標。但這些指標不會納入廣告成效報表中。

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

維度：

必要	adType
選用	天

指標：

使用 1 個以上

grossRevenue、adImpressions、cpm

篩選器：

只使用 1 個	video 和 group，或支援的 uploaderType 和 claimedStatus 組合
請使用 0 或 1	country、Europe、subContinent

YouTube Analytics API: Content Owner Reports

擷取報表

授權

濾鏡

瞭解報表表格

報表表格術語

影片報表

基本統計資料

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

美國各州的基本統計資料

根據時間

一段時間內的活動

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

使用者地理位置

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

使用者活動 (依省分組)

使用者活動 (按城市劃分) (<= 250 筆結果)

播放詳細資料

使用者活動 (依訂閱狀態區分)

使用者活動 (依州/省的訂閱狀態劃分)

含有選用時間維度的播放詳細資料

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

含有選用時間維度和 averageViewPercentage 指標的播放詳細資料

各國家/地區的播放詳細資料

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

依國家/地區顯示 averageViewPercentage 指標

各州/省的播放詳細資料

使用 liveOrOnDemand 統計資料的各州/省播放詳細資料

使用 averageViewPercentage 指標各州的播放詳細資料

播放位置

影片播放位置報表

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

流量來源

流量來源

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

裝置類型和作業系統

裝置類型

作業系統

作業系統和裝置類型

觀眾客層

參與度和內容分享

觀眾續看率

熱門影片

整體、國家/地區、洲別或子洲別的熱門影片 (<= 200 筆結果)

美國各州整體熱門影片 (<= 200 筆結果)

訂閱頻道或未訂閱觀眾的熱門影片 (<= 200 筆結果)

YouTube 產品的熱門影片 (<= 200 筆結果)

顯示播放詳細資料篩選器的熱門影片 (<= 200 筆結果)

播放清單報表

匯總影片指標

播放清單中的指標

支援的播放清單指標

基本統計資料

根據時間

使用者地理位置

播放清單活動 (按州/省劃分)

播放位置

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

流量來源

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

裝置類型和作業系統

播放清單的裝置類型

播放清單的作業系統

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

觀眾客層

熱門播放清單

廣告成效報表

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