YouTube Analytics API: Channel Reports

このページでは、チャンネルの所有者が YouTube Analytics API で取得できるレポートの一覧を示します。チャンネル レポートでは、指定したチャンネルのユーザー アクティビティの指標が表示され、動画の視聴回数、評価、チャンネル登録者数などが測定されます。

  • 動画レポートは、チャンネルの動画に関連するすべてのユーザー アクティビティの統計情報を提供します。
  • 再生リストレポートには、再生リスト内で発生した動画再生回数に関連する統計情報が表示されます。

  • 広告のパフォーマンス レポートには、収益と広告のパフォーマンスに関連する指標が含まれます。動画再生中に表示された広告の種類に基づいて指標をグループ化するには、adTypeadType ディメンションを使用します。広告のパフォーマンス レポートのセクションでは、API がサポートする 2 種類の広告のパフォーマンス指標について説明します。

レポートの取得

チャネル レポートを取得するには、API リクエストの ids パラメータ値を次のいずれかの値に設定する必要があります。

  • channel==MINE – API は、認証されたユーザーの YouTube チャンネルのデータを返します。

  • channel==CHANNEL_ID – CHANNEL_ID を、データを取得するチャンネルの一意のチャンネル ID に設定します。リクエストを承認するユーザーは、チャンネルの所有者である必要があります。

    チャンネル ID は現在のところ UC で始まる文字列ですが、形式は変更される可能性があります。（チャンネル ID は、YouTube チャンネルの [アカウントの詳細設定] ページで確認できます。また、YouTube Data API's channels.list メソッドを使ってプログラムによって取得することもできます）。

認可

すべての 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 の関連コンテンツの表示と管理。YouTube Analytics API では、コンテンツ所有者はこのスコープを使用して YouTube アナリティクスのグループとグループ アイテムを管理します。

注: 現在のところ、推定収益と広告のパフォーマンスに関する指標は、チャンネル レポートではサポートされていません。そのため、現在、https://www.googleapis.com/auth/yt-analytics-monetary.readonly スコープを使用しても、これらのレポートの金額データにはアクセスできません。

フィルタ

各レポートで使用できるフィルタは、サポートされるレポートを説明する表で示しています。この表の中でかっこで囲まれているフィルタはオプションです。たとえば、フィルタ オプション video(,country) の場合、動画フィルタは必須で、国フィルタは省略可能です。

API は、video フィルタと playlist フィルタに複数の値を指定する機能もサポートしています。これらのフィルタのいずれかに複数の値を指定する場合は、リクエストで指定したディメンションのリストにそのフィルタを追加することもできます。これは、特定のレポートでサポートされているディメンションとしてフィルタが表示されていない場合でも同じです。

API の結果を特定の値または値セットでフィルタリングする方法については、filters パラメータ定義をご覧ください。

レポートの表について

このセクションでは、API がサポートするレポートを定義するテーブルで使用される形式と用語について説明します。次の表は、時間ディメンションと averageViewPercentage 指標を使用する再生の詳細動画レポートでサポートされているディメンション、指標、フィルタを示しています。

目次
サイズ:
0 個以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください subscribedStatus、youtubeProduct

この表には、ディメンションが 2 行、指標が 1 行、フィルタが 3 行含まれています。ディメンションとフィルタの場合、表の使用ルールに即している場合に限り、各行の値を API リクエストにまとめることができます。たとえば、このレポートで有効な dimensions パラメータ値は次のようになります。

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

パラメータ値 day,month は 2 つの時間ベースのディメンションを使用しているため無効ですが、リクエストでは 0 または 1 のいずれかを使用できます。この場合、パラメータ値 subscribedStatus,youtubeProduct は実際にはレポートを返しますが、指標は日、週、月などで集計されません（このレポートについては、別途ドキュメントに記載されています）。

レポートの表の用語

表では、ディメンションが必須か任意かを示すために次の用語が使用されます。

  • 次の用語は、値が必要であることを示します。
    • 必須: 値を含める必要があります。
    • 1 つだけ使用: グループから 1 つの値を含める必要があります。
    • 1 つ以上使用: グループの値の一部またはすべてを含めることができますが、少なくとも 1 つを含める必要があります。
  • 以下の用語は、値は省略可能です。
    • 省略可: 値を指定することもできます。
    • 0 または 1 を使用する: グループから 1 つの値を含めることができます。
    • 0 個以上の値を使用する: グループに含まれる値の一部またはすべてを含めることができます。

動画レポート

基本統計情報

基本的なユーザー アクティビティの統計情報

このレポートは、チャンネル上でのユーザー操作に関する統計情報を提供します。特定の動画または特定の国に関するデータのみが含まれるように、レポートをフィルタリングすることができます。

目次
サイズ:
[None]
指標:
1 つ以上使用 viewbased, redViews, comments, likes, 認定試験 64 インプレッションvideosAddedToPlaylists, videosRemovedFromPlaylists,shares, estimatedMinutesWatched,estimatedRedMinutesWatched,averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
フィルタ:
0 または 1 を使用してください country、Continent、subContinent
0 または 1 を使用してください video、group

米国各州の基本的なユーザー アクティビティ統計情報

このレポートは、特定の米国の州またはコロンビア特別区の統計情報を提供します。このレポートは、上で説明した特定の国のレポートで使用可能な指標のサブセットのみをサポートします。

目次
サイズ:
[None]
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
必須 province
0 または 1 を使用してください video、group

時間ベース

特定期間の国別ユーザー アクティビティ

このレポートは、特定の期間にわたるチャンネル上でのユーザー操作に関する統計情報を提供します。特定の動画または特定の国に関するデータのみが含まれるように、レポートをフィルタリングすることができます。

目次
サイズ:
1 つのみを使用 day、month
任意 creatorContentType
指標:
1 つ以上使用 views, redViews, comments, likes, 認定試験 64 インプレッション}videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched,estimatedRedMinutesWatched,averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
フィルタ:
0 または 1 を使用してください country、Continent、subContinent
0 または 1 を使用してください video、group

特定期間の米国各州におけるユーザー アクティビティ

このレポートは、特定の米国の州またはコロンビア特別区のユーザー アクティビティに関する統計情報を提供します。このレポートは、上で説明した特定の国のレポートで使用可能な指標のサブセットのみをサポートします。

目次
サイズ:
1 つのみを使用 day、month
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
必須 province
0 または 1 を使用してください video、group

ユーザーの地域

国別のユーザー アクティビティ

このレポートでは、チャンネルに対するユーザー アクティビティに関して、国ごとの統計を提供します。特定の動画のデータのみが含まれるように、レポートをフィルタリングすることができます。

目次
サイズ:
必須 country
任意 creatorContentType
指標:
1 つ以上使用 viewbased, redViews, comments, likes, 認定試験 64 インプレッションvideosAddedToPlaylists, videosRemovedFromPlaylists,shares, estimatedMinutesWatched,estimatedRedMinutesWatched,averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
フィルタ:
0 または 1 を使用してください Continent、subContinent
0 または 1 を使用してください video、group

州別のユーザー アクティビティ

このレポートは、特定の米国の州またはコロンビア特別区のユーザー アクティビティに関する統計情報を提供します。このレポートでは、filters パラメータ値を country==US に設定する必要があります。

目次
サイズ:
必須 province
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
必須 country==US
0 または 1 を使用してください video、group

都市別のユーザー アクション（結果 250 件以下）

注: このレポートを使用するには、maxResults パラメータを 250 以下の整数値に設定する必要があります。他のほとんどのレポートとは異なり、このレポートでは sort リクエスト パラメータの値も指定する必要があります。

このレポートでは、都市ごとのユーザー アクションの統計情報を確認できます。

目次
サイズ:
必須 city
0 個以上を使用してください creatorContentType、country、provision、subscribedStatus

注: provision ディメンションを含める場合は、country==US フィルタも使用する必要があります。
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
並べ替えオプション： -視聴回数
-estimatedMinutesWatched

再生の詳細

再生詳細レポートでは、次の視聴属性に関する統計情報を確認できます。

  • 視聴されたのはライブ動画配信ですか、それともオンデマンド動画ですか？
  • 視聴者は、動画を所有しているチャンネルに登録しましたか？
  • 視聴された YouTube サービス

注: liveOrOnDemand ディメンションとフィルタは、averageViewPercentage 指標と組み合わせて使用することはできません。そのため、以降の各サブセクションでは、2 つのレポートを示します。1 つのレポートは liveOrOnDemand ディメンション（およびフィルタ）をサポートし、もう 1 つは averageViewPercentage 指標をサポートしています。

登録済みステータス別のユーザー アクティビティ

このレポートでは、チャンネル登録者とチャンネル登録していない視聴者のユーザー アクティビティの指標を確認できます。統計情報は期間（日または月）でグループ化でき、国、大陸、subContinentでフィルタすることもできます。

目次
サイズ:
0 個以上を使用してください creatorContentType、subscribedStatus
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views, redViews, likes, favorites, videosAddedToPlaylists, videosRemovedFromPlaylists, shares,estimatedMinutesWatched,estimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
0 または 1 を使用してください country、Continent、subContinent
0 または 1 を使用してください video、group
任意 subscribedStatus

州ごとの登録済みステータス別のユーザー アクティビティ

このレポートでは、米国の州またはコロンビア特別区におけるチャンネル登録者と未登録者のユーザー アクティビティ指標を確認できます。このレポートでサポートされる指標の数は、前のレポートよりも少なくなります。

目次
サイズ:
0 個以上を使用してください creatorContentType、subscribedStatus
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
0 または 1 を使用してください video、group
0 個以上を使用してください region、subscribedStatus

再生の詳細（オプションの時間ディメンションあり）

これらのレポートでは、時間ディメンション（日または月）は省略可能です。レポートの対象期間を指定するには、リクエスト パラメータ startDate と endDate を使用する必要があるためです。このディメンションが存在する場合は、レポートのデータを日や月などで集計したいことを示します。

再生の詳細（オプションの時間ディメンションと liveOrOnDemand 統計情報を含む）

このレポートには、特定の時間間隔の再生の詳細に関する統計情報が表示されます。liveOrOnDemand ディメンション（およびフィルタ）をサポートしています。

目次
サイズ:
0 個以上を使用してください creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
再生の詳細（オプションの時間ディメンションと averageViewPercentage 指標付き）

このレポートには、特定の時間間隔の再生の詳細に関する統計情報が表示されます。averageViewPercentage 指標がサポートされています。

目次
サイズ:
0 個以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください subscribedStatus、youtubeProduct

国別の再生詳細

liveOrOnDemand の統計情報を含む国別の再生詳細

このレポートでは、国ごとの再生の詳細の統計情報を提供します。liveOrOnDemand ディメンション（およびフィルタ）をサポートしています。

目次
サイズ:
必須 country
0 個以上を使用してください creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
0 または 1 を使用してください Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
averageViewPercentage 指標を含む国別の再生詳細

次のレポートは、前のレポートに似ています。averageViewPercentage 指標のサポートを追加しますが、liveOrOnDemand はディメンションまたはフィルタとしてサポートしません。

目次
サイズ:
必須 country
0 個以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
0 または 1 を使用してください Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください subscribedStatus、youtubeProduct

地域別の再生詳細

州ごとの再生詳細（liveOrOnDemand の統計情報）

このレポートでは、米国の州とコロンビア特別区における再生の詳細に関する統計情報を提供します。liveOrOnDemand ディメンション（およびフィルタ）をサポートしています。

目次
サイズ:
必須 province
0 個以上を使用してください creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
必須 country==US
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
州ごとの再生詳細（averageViewPercentage 指標）

次のレポートは、前のレポートに似ています。averageViewPercentage 指標のサポートを追加しますが、liveOrOnDemand はディメンションまたはフィルタとしてサポートしません。

目次
サイズ:
必須 province
0 個以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
必須 country==US
0 または 1 を使用してください video、group
0 個以上を使用してください subscribedStatus、youtubeProduct

再生場所

ビデオ再生場所レポート

このレポートは、動画再生が発生したページまたはアプリケーションのタイプに関する統計情報を提供します。.

目次
サイズ:
必須 insightPlaybackLocationType
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus

再生場所の詳細（25 件以下）

注: このレポートを使用するには、maxResults パラメータを 25 以下の整数値に設定する必要があります。他のほとんどのレポートとは異なり、このレポートでは sort リクエスト パラメータの値も指定する必要があります。

このレポートでは、チャンネルの動画について、視聴回数または再生時間が最も多かった埋め込み動画プレーヤーが特定されます。

目次
サイズ:
必須 insightPlaybackLocationDetail
任意 creatorContentType
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
必須 insightPlaybackLocationType==EMBEDDED
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus
並べ替えオプション： -視聴回数
-estimatedMinutesWatched

トラフィック ソース

トラフィック ソース

このレポートは、視聴者がどのようにして動画コンテンツにアクセスしたかに基づいて、再生の統計情報を集計します。たとえば、Google 検索、または関連動画へのリンクから生み出された再生回数を特定できます。

目次
サイズ:
必須 insightTrafficSourceType
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus

トラフィック ソースの詳細（25 件以下）

注: このレポートを使用するには、maxResults パラメータを 25 以下の整数値に設定する必要があります。他のほとんどのレポートとは異なり、このレポートでは sort リクエスト パラメータの値も指定する必要があります。

このレポートは、チャンネルのコンテンツに関して最も多くの再生回数を生み出した参照 URL に基づいて、再生の統計情報を集計します。参照 URL は、トラフィック ソースの種類によって分類されます。レポートを取得するトラフィック ソースは、insightTrafficSourceDetail ディメンションの定義によって特定されます。たとえば、insightTrafficSourceType フィルタを ADVERTISING に設定すると、レポートにはチャンネルのコンテンツの視聴回数または視聴時間が最も多い広告の種類が一覧表示されます。

目次
サイズ:
必須 insightTrafficSourceDetail
任意 creatorContentType
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
必須 insightTrafficSourceType（下の表の注記を参照）
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus
並べ替えオプション： -視聴回数
-estimatedMinutesWatched

注： このレポートは、特定のトラフィック ソースでのみサポートされます。たとえば、NO_LINK_EMBEDDED トラフィック ソースには追加の詳細情報がないため、このレポートはサポートされていません。このレポートをサポートするトラフィック ソースの詳細については、insightTrafficSourceType の定義をご覧ください。

デバイスの種類とオペレーティング システム

デバイスのタイプ

このレポートは、視聴者がどのようにして動画コンテンツにアクセスしたかに基づいて、再生の統計情報を集計します。たとえば、モバイル デバイスやゲーム機で発生した視聴回数を特定できます。

目次
サイズ:
必須 deviceType
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

オペレーティング システム

このレポートは、視聴者のオペレーティング システムに基づいて、表示回数の統計情報を集計します。たとえば、Android 端末あるいは PlayStation での表示回数を特定します。

目次
サイズ:
必須 operatingSystem
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください deviceType、liveOrOnDemand、subscribedStatus、youtubeProduct

オペレーティング·システムと端末のタイプ

このレポートは、視聴者のオペレーティング システムと端末のタイプに基づいて、表示回数の統計情報を集計します。たとえば、Android タブレットあるいは Windows デスクトップ デバイスでの表示回数を特定します。

目次
サイズ:
必須 deviceType、operatingSystem
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct

視聴者のユーザー属性

このレポートは、視聴者の年齢層や性別に基づいて表示回数の統計情報を集計します。

目次
サイズ:
1 つ以上使用 ageGroup、gender
0 個以上を使用してください creatorContentType、liveOrOnDemand、subscribedStatus
指標:
1 つ以上使用 viewerPercentage
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください video、group
0 個以上を使用してください liveOrOnDemand、subscribedStatus
注: このレポートの viewerPercentage 値は、再生の詳細ディメンション（subscribedStatus、liveOrOnDemand、youtubeProduct）のさまざまな値や値の組み合わせに対して正規化されていません。

たとえば、subscribedStatus ディメンションを使用するレポートでは、viewerPercentage の視聴回数が {100% と 100% を合計 viewerPercentage の 100% を合計した viewerPercentage のデータが返されます。viewerPercentage（レポート内のすべての viewerPercentage フィールドの合計値は 200% になります）。

フィルタを使用すると、再生詳細ディメンションの 1 つの値（または値の組み合わせ）に対する viewerPercentage データのみがレポートに含まれるようにできます。

エンゲージメントとコンテンツの共有

このレポートは、各種ソーシャル プラットフォームにおけるチャンネルの動画の共有頻度を示す統計情報を提供します。

目次
サイズ:
必須 sharingService
0 個以上を使用してください creatorContentType、subscribedStatus
指標:
1 つ以上使用 共有
フィルタ:
0 または 1 を使用してください country、Continent、subContinent
0 または 1 を使用してください video、group
任意 subscribedStatus

視聴者維持率

このレポートでは、動画の視聴者維持率を測定できます。elapsedVideoTimeRatio ディメンションは、対応する指標値ごとに動画の経過時間を測定します。audienceWatchRatio 指標と relativeRetentionPerformance 指標から、動画が視聴者をどの程度維持できているかを示す 2 つの指標が得られます。1 つ目は絶対値で、2 つ目は、長さが同程度の他の YouTube 動画と比較したパフォーマンスです。

注: 視聴者維持率レポートでは、video フィルタに値のカンマ区切りのリストを指定することはできません。値には単一の動画 ID を指定する必要があります。

目次
サイズ:
必須 elapsedVideoTimeRatio
任意 creatorContentType
指標:
1 つ以上使用 audienceWatchRatio、relativeRetentionPerformance
フィルタ:
必須 動画
0 個以上を使用してください audienceType、subscribedStatus、youtubeProduct

人気の動画

注: これらのレポートでは、maxResults パラメータを 200 以下の整数値に設定する必要があります。2013 年 1 月 1 日までは、上位 10 本の動画のデータのみ利用できます。他のほとんどのレポートとは異なり、これらのレポートでは sort リクエスト パラメータの値も指定する必要があります。

オプションの地域フィルタが適用された上位の動画（200 件以下）

このレポートには、チャンネルで人気の動画が一覧表示されます。このレポートをフィルタして、国、大陸、またはsubContinent別に上位の動画を表示できます。

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 viewbased, redViews, comments, likes, 認定試験 64 インプレッションvideosAddedToPlaylists, videosRemovedFromPlaylists,shares, estimatedMinutesWatched,estimatedRedMinutesWatched,averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
フィルタ:
0 または 1 を使用してください country、Continent、subContinent
並べ替えオプション： -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

州別の上位の動画（検索結果 200 件以下）

このレポートでは、特定の米国の州またはコロンビア特別区で最も人気のあるチャンネル動画が一覧表示されます。このレポートは、上で説明した特定の国のレポートで使用可能な指標のサブセットのみをサポートします。

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
必須 province
任意 subscribedStatus
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

チャンネル登録者または未登録の視聴者向けの上位の動画（200 件以下）

このレポートには、登録チャンネルまたは未登録の視聴者向けにチャンネルで人気の動画が一覧表示されます。このレポートをフィルタして、国、大陸、またはsubContinent別に上位の動画を表示できます。以前のレポートでは、チャンネル登録者または未登録の視聴者について、米国の特定の州で上位の動画を取得できましたが、サポートされる指標はこのレポートよりも少なくなります。

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 views, redViews, likes, favorites, videosAddedToPlaylists, videosRemovedFromPlaylists, shares,estimatedMinutesWatched,estimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
任意 subscribedStatus
0 または 1 を使用してください country、Continent、subContinent
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

YouTube サービス別の上位の動画（200 件以下）

このレポートには、チャンネルで人気の動画の一覧が表示され、再生の詳細と地域に関するフィルタを利用できます。このレポートは前のレポートに似ていますが、サポートされる指標が少なく、youtubeProduct フィルタのサポートが追加されています。

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

再生詳細フィルタがある上位の動画（検索結果 200 件以下）

このレポートには、チャンネルで人気の動画が一覧表示され、再生の詳細ディメンション（liveOrOnDemand、subscribedStatus、youtubeProduct）のいずれかまたはすべてでフィルタされます。前のレポートとは異なり、このレポートでは liveOrOnDemand フィルタをサポートしていますが、averageViewPercentage 指標をサポートしていません。

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

再生リストレポート

再生リストレポートには、チャンネル所有者の再生リスト内の動画に関連するユーザー アクティビティに関連する指標が含まれます。レポートには 2 つのバージョンがあります。以下のセクションでは、各バージョンについて説明します。

  • 各セクションの [推奨] タブには、対応するレポートの取得に推奨される API リクエストの形式が記載されています。推奨レポートでは、動画の集計指標と再生リスト内の指標の両方を含む拡張された一連の指標がサポートされています。このリクエスト形式では、isCurated ディメンションを使用しません。
  • 各セクションの [isCurated の使用] タブでは、isCurated ディメンションが必要な以前の API リクエスト形式について説明しています。これらのレポートは、再生リスト内の指標のみをサポートします。なお、isCurated ディメンションは、すべてのレポートでサポートが終了しています。以下の警告の注記では、サポート終了スケジュールについて説明しています。

以下の警告では、2 つのレポート バージョンの違いについて詳しく説明します。

集計された動画に関する指標

これらの指標は、再生リストを所有するチャンネルが所有している再生リスト内のすべての動画について集計されたユーザー アクティビティとインプレッションの指標です。他のチャンネルが所有する動画の指標は、集計では計算されません。そのため、あるチャンネルが他のチャンネルが所有する動画のみを含む再生リストを作成した場合、その再生リストのレポートではこれらの指標の値は提供されません。

YouTube がサポートする動画に関する集計指標のリストについては、サポートされている再生リストの指標をご覧ください。

再生リスト内の指標

これらの指標は、再生リストのページでのユーザーの行動とエンゲージメントを反映しています。これらの指標には、動画を所有するチャンネルに関係なく、再生リスト内のすべての動画の視聴回数が含まれますが、再生リスト内で発生した視聴回数のみがカウントされます。

サポートされている再生リストの指標

基本統計情報

このレポートには、チャンネルの再生リスト内の動画に対するユーザーの操作に関連する統計情報が表示されます。特定の再生リストのデータのみを返すように、レポートにフィルタを適用できます。

isCurated の使用
目次
サイズ:
[None]
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct

時間ベース

このレポートには、チャンネルの再生リスト内の動画に対するユーザーの操作に関連する統計情報が表示されます。特定の再生リストのデータのみを返すように、レポートにフィルタを適用できます。

isCurated の使用
目次
サイズ:
1 つのみを使用 day、month
0 個以上を使用してください subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct

ユーザーの地域

国別の再生リストのアクティビティ

このレポートには、特定の国のユーザーがチャンネルの再生リスト内の動画に対して行った操作に関する統計情報が表示されます。

isCurated の使用
目次
サイズ:
必須 country
0 個以上を使用してください subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください playlist、group
0 または 1 を使用してください Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct

地域別の再生リスト アクティビティ

このレポートでは、米国の州とコロンビア特別区の再生リストのアクティビティの統計情報を提供します。 このレポートの場合、米国のデータのみを返すように結果をフィルタする必要があります。

再生場所

このレポートには、再生リストの動画の再生が発生したページまたはアプリケーションのタイプに関連する統計情報が表示されます。

再生場所の詳細（25 件以下）

注: このレポートを使用するには、maxResults パラメータを 25 以下の整数値に設定する必要があります。他のほとんどのレポートとは異なり、このレポートでは sort リクエスト パラメータの値も指定する必要があります。

このレポートでは、チャンネルの再生リスト内の動画について、視聴回数または再生時間が最も多かった埋め込み動画プレーヤーが特定されます。

isCurated の使用
目次
サイズ:
必須 insightPlaybackLocationDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1;insightPlaybackLocationType==EMBEDDED
0 または 1 を使用してください playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
任意 subscribedStatus
並べ替えオプション： -views
-estimatedMinutesWatched
-playlistStarts

トラフィック ソース

このレポートでは、視聴者が再生リストのコンテンツに到達した方法に基づいて、視聴の統計情報が集計されます。 たとえば、Google 検索で発生した視聴回数を把握できます。

トラフィック ソースの詳細（25 件以下）

注: このレポートでは、maxResults パラメータを 25 以下の整数値に設定する必要があります。他のほとんどのレポートとは異なり、このレポートでは sort リクエスト パラメータの値も指定する必要があります。

このレポートでは、チャンネルの再生リスト内の動画の視聴回数を最も多く獲得した参照 URL に基づいて、視聴の統計情報が集計されます。参照 URL はトラフィック ソースのタイプ別に分類され、insightTrafficSourceDetail ディメンションの定義は、レポートを利用できるトラフィック ソースを識別します。

たとえば、insightTrafficSourceType フィルタを ADVERTISING に設定すると、レポートには、チャンネルの再生リストの視聴回数または視聴時間が最も多い広告の種類が一覧表示されます。

推奨
目次
サイズ:
必須 insightTrafficSourceDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
必須 insightTrafficSourceType==ADVERTISING（またはサポートされている別の値）
1 つのみを使用 playlist、group
並べ替えオプション： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
isCurated の使用
目次
サイズ:
必須 insightTrafficSourceDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1;insightTrafficSourceType==ADVERTISING（またはサポートされている別の値）
0 または 1 を使用してください playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
任意 subscribedStatus
並べ替えオプション： -views
-estimatedMinutesWatched
-playlistStarts

注： このレポートは、特定のトラフィック ソースでのみサポートされます。たとえば、NO_LINK_EMBEDDED トラフィック ソースには追加の詳細情報がないため、このレポートはサポートされていません。このレポートをサポートするトラフィック ソースの詳細については、insightTrafficSourceType の定義をご覧ください。

デバイスの種類とオペレーティング システム

デバイスのタイプ

このレポートでは、視聴者が再生リストの動画にアクセスした方法に基づいて視聴の統計情報が集計されます。たとえば、モバイル デバイスやゲーム機で発生した視聴回数を識別します。

isCurated の使用
目次
サイズ:
必須 deviceType
0 個以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください operatingSystem、subscribedStatus、youtubeProduct

オペレーティング システム

このレポートは、視聴者のオペレーティング システムに基づいて、表示回数の統計情報を集計します。たとえば、Android デバイスや PlayStation で発生した視聴回数を識別します。

isCurated の使用
目次
サイズ:
必須 operatingSystem
0 個以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください deviceType、subscribedStatus、youtubeProduct

オペレーティング·システムと端末のタイプ

このレポートでは、視聴者のオペレーティング システムやデバイスの種類に基づいて視聴の統計情報が集計されます。 たとえば、Android タブレットや Windows デスクトップ デバイスで発生した視聴回数などを特定します。

isCurated の使用
目次
サイズ:
必須 deviceType、operatingSystem
0 個以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct

視聴者のユーザー属性

isCurated の使用
目次
サイズ:
1 つ以上使用 ageGroup、gender
0 個以上を使用してください subscribedStatus
指標:
必須 viewerPercentage
フィルタ:
必須 isCurated==1
0 または 1 を使用してください playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
任意 subscribedStatus
注: このレポートの viewerPercentage 値は、subscribedStatus 再生詳細ディメンションの異なる値に対して正規化されません。

たとえば、subscribedStatus ディメンションを使用するレポートでは、チャンネル登録数の合計が viewerPercentage のデータとして 100% になり、viewerPercentage のデータが 100% になります。（レポート内のすべての viewerPercentage フィールドの合計値は 200% になります）。

フィルタを使用すると、subscribedStatus ディメンションの 1 つの値に対する viewerPercentage データのみがレポートに含まれるようにできます。

上位の再生リスト

注: これらのレポートでは、maxResults パラメータを 200 以下の整数値に設定する必要があります。2013 年 1 月 1 日より前のデータは、上位 10 件の再生リストについてのみ表示されます。他のほとんどのレポートとは異なり、これらのレポートでは sort リクエスト パラメータの値も指定する必要があります。

このレポートには、指定したフィルタ条件と並べ替え条件に基づいて、チャンネルで人気の再生リストが表示されます。

isCurated の使用
目次
サイズ:
必須 プレイリスト
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください playlist、subscribedStatus、youtubeProduct
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

広告のパフォーマンス レポート

注: 広告のパフォーマンス レポートには、https://www.googleapis.com/auth/yt-analytics-monetary.readonly スコープへのアクセス権を付与する認証トークンが必要です。

広告のパフォーマンス レポートでは、動画再生中に配信された広告について、インプレッション ベースの指標を確認できます。これらの指標では各広告のインプレッションが考慮されており、動画の再生ごとに複数のインプレッションが発生する可能性があります。

インプレッション数に基づく広告のパフォーマンス指標は次のとおりです。

また、一部の動画レポートでは、次の再生回数に基づく広告のパフォーマンス指標がサポートされています。ただし、これらの指標は広告のパフォーマンス レポートには含まれません。

広告タイプ別の広告のパフォーマンス

目次
サイズ:
必須 adType
任意 日
指標:
1 つ以上使用 grossRevenue、adImpressions、cpm
フィルタ:
0 または 1 を使用してください video、group
0 または 1 を使用してください country、Continent、subContinent