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 でサポートされている 2 種類の広告パフォーマンス指標について説明します。

レポートの取得

コンテンツ所有者レポートを取得するには、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 で表示、管理できます。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 を使用 日、月
指標:
1 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
0 または 1 を使用 country、province、continent、subContinent
0 または 1 を使用 動画、グループ
0 以上を使用してください subscribedStatus、youtubeProduct

このテーブルには、ディメンション用の行が 2 つ、指標用の行が 1 つ、フィルタ用の行が 3 つあります。ディメンションとフィルタの場合、組み合わせが表の使用ルールに従っている限り、各行の値を API リクエストで組み合わせることができます。たとえば、このレポートの有効な dimensions パラメータ値は次のとおりです。

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

ただし、パラメータ値 day,month は、2 つの時間ベースのディメンションを使用するため無効です。リクエストでは 0 または 1 のいずれかを使用する必要があります。

レポートの表の用語

表では、ディメンションが必須か省略可能かを次の用語で示します。

  • 次の用語は、値が必須であることを意味します。
    • 必須: 値を含める必要があります。
    • 1 つだけ使用: グループから 1 つの値を含める必要があります。
    • 1 つ以上を使用: グループ内の任意の値またはすべての値を含めることができますが、少なくとも 1 つは含める必要があります。
  • 次の用語は、値が省略可能であることを意味します。
    • 省略可: 値を含めることができます。
    • 0 または 1 を使用する: グループから 1 つの値を含めることができます。
    • 0 個以上を使用する: グループ内の任意の値またはすべての値を含めることができます。
重要: コンテンツ所有者の動画レポートを取得するすべての API リクエストでは、動画ディメンション、チャンネルディメンション、グループディメンション、または claimedStatus ディメンションと uploaderType ディメンションのサポートされている組み合わせを使用してデータをフィルタする必要があります。（一部のレポートでは、これらのオプションの一部がサポートされていません）。サポートされている組み合わせは、uploaderType ディメンションの定義にも記載されています。次のとおりです。
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

動画レポート

基本統計情報

基本統計情報（チャンネル登録者数など）

このレポートには、コンテンツ所有者のすべてのチャンネルでのユーザー アクションに関連する統計情報が表示されます。レポートをフィルタして、特定の動画または国のデータのみを返すことができます。また、申し立てを受けたコンテンツの統計情報のみを取得することもできます。これには、コンテンツ所有者、第三者、またはその両方によってアップロードされた申し立てを受けたコンテンツが含まれます。

目次
ディメンション:
[None]
指標:
1 つ以上使用 視聴回数、redViews、コメント、高評価、低評価、videosAddedToPlaylists、videosRemovedFromPlaylists、共有、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 つ以上使用 視聴回数、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 つ以上使用 視聴回数、redViews、コメント、高評価、低評価、videosAddedToPlaylists、videosRemovedFromPlaylists、共有、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

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

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

目次
ディメンション:
厳密に 1 つ使用 日、月
省略可 creatorContentType
指標:
1 つ以上使用 視聴回数、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 つ以上使用 視聴回数、redViews、コメント、高評価、低評価、videosAddedToPlaylists、videosRemovedFromPlaylists、共有、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 つ以上使用 視聴回数、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 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
厳密に 1 つ使用 動画、チャンネル、グループ、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用 country、province、continent、subContinent
並べ替えオプション： -視聴回数
-estimatedMinutesWatched

再生の詳細

再生の詳細レポートには、次の視聴属性に関連する統計情報が表示されます。

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

厳密には、これらのレポートでサポートされている再生の詳細ディメンションはすべて省略可能です。リクエストに再生の詳細ディメンションを含めない場合、返されるレポートは、基本統計情報、時間ベース、ユーザーの地域のいずれかのレポートに似たものになります。

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

定期購入ステータス別のユーザー アクティビティ

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

目次
ディメンション:
0 以上を使用してください creatorContentType、subscribedStatus
0 または 1 を使用 日、月
指標:
1 つ以上使用 視聴回数、redViews、高評価、低評価、videosAddedToPlaylists、videosRemovedFromPlaylists、共有、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 つ以上使用 視聴回数、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 つ以上使用 視聴回数、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 つ以上使用 視聴回数、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 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
厳密に 1 つ使用 動画、チャンネル、グループ、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用 continent、subContinent
0 以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
averageViewPercentage 指標を含む、国別の再生の詳細

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

目次
ディメンション:
省略可 country
0 以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
厳密に 1 つ使用 動画、チャンネル、グループ、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用 continent、subContinent
0 以上を使用してください subscribedStatus、youtubeProduct

都道府県別の再生の詳細

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

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

目次
ディメンション:
省略可 province
0 以上を使用してください creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
厳密に 1 つ使用 動画、チャンネル、グループ、または uploaderType と claimedStatus のサポートされている組み合わせ
必須 country==US
0 以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
都道府県別の再生の詳細（averageViewPercentage指標を含む）

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

目次
ディメンション:
省略可 province
0 以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 視聴回数、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
並べ替えオプション： -視聴回数
-estimatedMinutesWatched

トラフィック ソース

トラフィック ソース

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

注: このレポートでは、クエリ対象の動画数 × 期間内の日数の積が 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 リクエスト パラメータの値も指定する必要があります。

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

目次
ディメンション:
必須 insightTrafficSourceDetail
省略可 creatorContentType
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched
フィルタ:
厳密に 1 つ使用 動画、チャンネル、グループ、または uploaderType と claimedStatus のサポートされている組み合わせ
必須 insightTrafficSourceType（表の下の注を参照）
0 または 1 を使用 country、province、continent、subContinent
0 以上を使用してください liveOrOnDemand、subscribedStatus
並べ替えオプション： -視聴回数
-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
注: このレポートの [viewerPercentage] の値は、再生の詳細ディメンションの [subscribedStatus] の値が異なる場合でも正規化されません。

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

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

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

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

目次
ディメンション:
必須 sharingService
省略可 creatorContentType、subscribedStatus
指標:
1 つ以上使用 株
フィルタ:
厳密に 1 つ使用 動画、チャンネル、グループ、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用 country、continent、subContinent
省略可 subscribedStatus

視聴者維持率

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

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

目次
ディメンション:
必須 elapsedVideoTimeRatio
省略可 creatorContentType
指標:
1 つ以上使用 audienceWatchRatio、relativeRetentionPerformance
フィルタ:
必須 video
0 以上を使用してください audienceType、subscribedStatus、youtubeProduct

人気の動画

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

総合、国、大陸、サブ大陸の人気動画（200 件以下）

このレポートには、指定したフィルタ条件と並べ替え条件に基づいて、コンテンツ所有者の上位動画が一覧表示されます。

目次
ディメンション:
必須 video
省略可 creatorContentType
指標:
1 つ以上使用 視聴回数、redViews、コメント、高評価、低評価、videosAddedToPlaylists、videosRemovedFromPlaylists、共有、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 つ以上使用 視聴回数、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 つ以上使用 視聴回数、redViews、高評価、低評価、videosAddedToPlaylists、videosRemovedFromPlaylists、共有、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 つ以上使用 視聴回数、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）の 1 つ以上でフィルタされて表示されます。このレポートでは、リージョン別のフィルタリングもサポートされています。

目次
ディメンション:
必須 video
省略可 creatorContentType
指標:
1 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
厳密に 1 つ使用 channel または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用 country、province、continent、subContinent
0 以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

再生リストレポート

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

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

次の警告メモでは、2 つのレポート バージョンの変更点について詳しく説明します。

集計された動画指標

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

YouTube でサポートされている動画の集計指標の一覧については、サポートされているプレイリスト指標をご覧ください。

再生リスト内の指標

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

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

基本統計情報

このレポートには、コンテンツ所有者のチャンネルの再生リスト内の動画に対するユーザーの操作に関する統計情報が表示されます。レポートに必須のディメンションが含まれていません。

推奨
目次
ディメンション:
[None]
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel
isCurated の使用
目次
ディメンション:
[None]
指標:
1 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用 チャンネル、再生リスト、グループ
0 または 1 を使用 country、province、continent、subContinent
0 以上を使用してください subscribedStatus、youtubeProduct

時間ベース

このレポートには、コンテンツ所有者のチャンネルの再生リスト内の動画に対するユーザーの操作に関する統計情報が、特定の期間にわたって表示されます。レポートをフィルタして、特定の再生リストまたはチャンネルのデータをのみ返すようにすることができます。

推奨
目次
ディメンション:
厳密に 1 つ使用 日、月
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel
isCurated の使用
目次
ディメンション:
厳密に 1 つ使用 日、月
0 以上を使用してください subscribedStatus、youtubeProduct
指標:
1 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用 チャンネル、再生リスト、グループ
0 または 1 を使用 country、province、continent、subContinent
0 以上を使用してください subscribedStatus、youtubeProduct

ユーザーの地域

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

このレポートには、再生リストの統計情報が国別に表示されます。

推奨
目次
ディメンション:
必須 country
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration
フィルタ:
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
0 または 1 を使用 continent、subContinent
省略可 channel
isCurated の使用
目次
ディメンション:
必須 country
0 以上を使用してください subscribedStatus、youtubeProduct
指標:
1 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用 continent、subContinent
0 または 1 を使用 再生リスト、チャンネル、グループ
0 以上を使用してください subscribedStatus、youtubeProduct

都道府県別の再生リストのアクティビティ

このレポートには、米国の各州とコロンビア特別区の再生リストのアクティビティの統計情報が表示されます。このレポートでは、filters パラメータ値に country==US を含めます。

isCurated の使用
目次
ディメンション:
必須 province
0 以上を使用してください subscribedStatus、youtubeProduct
指標:
1 つ以上使用 視聴回数、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1;country==US
0 または 1 を使用 チャンネル、再生リスト、グループ
0 以上を使用してください subscribedStatus、youtubeProduct

再生場所

このレポートには、プレイリストの再生が発生したページまたはアプリの種類に関する統計情報が表示されます。

推奨
目次
ディメンション:
必須 insightPlaybackLocationType
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel

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

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

このレポートでは、コンテンツ所有者の再生リストで最も多くの視聴回数または総再生時間を獲得した埋め込み動画プレーヤーを特定できます。

推奨
目次
ディメンション:
必須 insightPlaybackLocationDetail
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
必須 insightPlaybackLocationType==EMBEDDED
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel
並べ替えオプション： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
isCurated の使用
目次
ディメンション:
必須 insightPlaybackLocationDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1;insightPlaybackLocationType==EMBEDDED
0 または 1 を使用 country、province、continent、subContinent
0 または 1 を使用 再生リスト、チャンネル、グループ
省略可 subscribedStatus
並べ替えオプション： -views
-estimatedMinutesWatched
-playlistStarts

トラフィック ソース

このレポートでは、視聴者が再生リストのコンテンツにアクセスした方法に基づいて視聴統計情報が集計されます。たとえば、Google 検索やチャンネル ページから発生した視聴回数を特定できます。

推奨
目次
ディメンション:
必須 insightTrafficSourceType
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel

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

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

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

推奨
目次
ディメンション:
必須 insightTrafficSourceDetail
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
必須 insightTrafficSourceType
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel
並べ替えオプション： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
isCurated の使用
目次
ディメンション:
必須 insightTrafficSourceDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1;insightTrafficSourceType
0 または 1 を使用 country、province、continent、subContinent
0 または 1 を使用 再生リスト、チャンネル、グループ
省略可 subscribedStatus
並べ替えオプション： -views
-estimatedMinutesWatched
-playlistStarts

注： このレポートは、特定のトラフィック ソースでのみサポートされます。サポートされていないトラフィック ソースには、VIDEO_REMIXES、NOTIFICATION、END_SCREEN、CAMPAIGN_CARD、VIDEO_REMIXES、NO_LINK_EMBEDDED などがあります。

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

再生リストのデバイスタイプ

このレポートでは、視聴者が再生リストのコンテンツの視聴に使用したデバイスの種類に基づいて視聴統計情報が集計されます。たとえば、モバイル デバイスやゲーム機で発生した視聴回数を特定できます。

推奨
目次
ディメンション:
必須 deviceType
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel
isCurated の使用
目次
ディメンション:
必須 deviceType
0 以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用 country、province、continent、subContinent
0 または 1 を使用 再生リスト、チャンネル、グループ
0 以上を使用してください operatingSystem、subscribedStatus、youtubeProduct

再生リストのオペレーティング システム

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

推奨
目次
ディメンション:
必須 operatingSystem
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel
isCurated の使用
目次
ディメンション:
必須 operatingSystem
0 以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用 country、province、continent、subContinent
0 または 1 を使用 再生リスト、チャンネル、グループ
0 以上を使用してください deviceType、subscribedStatus、youtubeProduct

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

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

推奨
目次
ディメンション:
必須 deviceType、operatingSystem
指標:
1 つ以上使用 視聴回数、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用* 再生リスト、グループ

注: レポートで視聴回数、estimatedMinutesWatched、averageViewDurationのいずれかの指標をリクエストする場合は、これらのフィルタのいずれかを 1 つ指定する必要があります。
省略可 channel
isCurated の使用
目次
ディメンション:
必須 deviceType、operatingSystem
0 以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用 country、province、continent、subContinent
0 または 1 を使用 再生リスト、チャンネル、グループ
0 以上を使用してください subscribedStatus、youtubeProduct

視聴者のユーザー属性

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

注: このレポートの [viewerPercentage] の値は、再生の詳細ディメンション（subscribedStatus と youtubeProduct）の値の違いや値の組み合わせに対して正規化されていません。

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

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

上位の再生リスト

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

このレポートには、指定したフィルタ条件と並べ替え条件に基づいて、コンテンツ所有者の上位再生リストが表示されます。

isCurated の使用
目次
ディメンション:
必須 再生リスト
指標:
1 つ以上使用 視聴回数、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
省略可 日
指標:
1 つ以上使用 grossRevenue、adImpressions、cpm
フィルタ:
厳密に 1 つ使用 video、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用 country、continent、subContinent