YouTube Analytics API: Channel Reports

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

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

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

レポートの取得

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

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

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

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

承認

YouTube アナリティクス API へのリクエストはすべて承認を受ける必要があります。認可ガイドでは、OAuth 2.0 プロトコルを使用して認可トークンを取得する方法について説明しています。

YouTube アナリティクス 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 スコープではこれらのレポートの金銭データにアクセスできません。

フィルタ

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

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

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

レポートの表について

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

目次
ディメンション:	0 以上を使用します creatorContentType、subscribedStatus、youtubeProduct 0 または 1 を使用する 日、月
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 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 個以上を使用: グループから任意の値またはすべての値を含めることができます。

動画レポート

基本統計情報

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

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

目次
ディメンション:	[None]
指標:	1 つ以上使用する engagedViews*、playbackBasedCpm
フィルタ:	0 または 1 を使用する country、continent、subContinent 0 または 1 を使用する video、group

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

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

目次
ディメンション:	[None]
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
フィルタ:	必須 province 0 または 1 を使用する video、group

時間ベース

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

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

目次
ディメンション:	1 つだけ使用する 日、月 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews*、monetizedPlaybacks
フィルタ:	0 または 1 を使用する country、continent、subContinent 0 または 1 を使用する video、group

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

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

目次
ディメンション:	1 つだけ使用する 日、月 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
フィルタ:	必須 province 0 または 1 を使用する video、group

ユーザーの地域

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

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

目次
ディメンション:	必須 country 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews*、playbackBasedCpm
フィルタ:	0 または 1 を使用する continent、subContinent 0 または 1 を使用する video、group

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

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

目次
ディメンション:	必須 province 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
フィルタ:	必須 country==US 0 または 1 を使用する video、group

都市別のユーザー アクティビティ （250 件以下の結果）

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

このレポートは、都市別のユーザー アクティビティの統計情報を提供します。

目次
ディメンション:	必須 city 0 以上を使用します creatorContentType、country、province、subscribedStatus 注: [都道府県] ディメンションを含める場合は、country==US フィルタも使用する必要があります。 0 または 1 を使用する 日、月
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group
並べ替えオプション：	-views -estimatedMinutesWatched

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

このレポートは、指定市場圏（DMA）別のユーザー アクティビティの統計情報を提供します。このレポートでは、filters パラメータの値を country==US に設定するか、特定の州（米国の州）でフィルタする必要があります。

目次
ディメンション:	必須 dma 0 または 1 を使用する day month creatorContentType subscribedStatus
指標:	1 つ以上使用する engagedViews views estimatedMinutesWatched averageViewDuration averageViewPercentage
フィルタ:	0 または 1 を使用する country==US province 0 または 1 を使用する 動画 グループ
並べ替えオプション：	-views -estimatedMinutesWatched

再生の詳細

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

• ライブ動画の放送とオンデマンド動画のどちらを視聴しましたか？
• 視聴者は動画を所有するチャンネルに登録していましたか？
• 視聴が発生した YouTube サービス

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

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

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

目次
ディメンション:	0 以上を使用します creatorContentType、subscribedStatus 0 または 1 を使用する 日、月
指標:	1 つ以上使用する engagedViews、views、redViews、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
フィルタ:	0 または 1 を使用する country、continent、subContinent 0 または 1 を使用する video、group 省略可 subscribedStatus

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

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

目次
ディメンション:	0 以上を使用します creatorContentType、subscribedStatus 0 または 1 を使用する 日、月
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
フィルタ:	0 または 1 を使用する video、group 0 以上を使用します province、subscribedStatus

再生の詳細（時間ディメンションは省略可）

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

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

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

目次
ディメンション:	0 以上を使用します creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct 0 または 1 を使用する 日、月
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します liveOrOnDemand、subscribedStatus、youtubeProduct

再生の詳細（オプションの時間ディメンションと averageViewPercentage 指標を含む）

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

目次
ディメンション:	0 以上を使用します creatorContentType、subscribedStatus、youtubeProduct 0 または 1 を使用する 日、月
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します subscribedStatus、youtubeProduct

国別の再生の詳細

liveOrOnDemand 統計情報による国別の再生の詳細

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

目次
ディメンション:	必須 country 0 以上を使用します creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:	1 つ以上使用する engagedViews、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 つ以上使用する engagedViews、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 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:	必須 country==US 0 または 1 を使用する video、group 0 以上を使用します liveOrOnDemand、subscribedStatus、youtubeProduct

averageViewPercentage 指標による都道府県別の再生の詳細

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

目次
ディメンション:	必須 province 0 以上を使用します creatorContentType、subscribedStatus、youtubeProduct
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:	必須 country==US 0 または 1 を使用する video、group 0 以上を使用します subscribedStatus、youtubeProduct

再生場所

ビデオ再生場所レポート

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

目次
ディメンション:	必須 insightPlaybackLocationType 0 以上を使用します creatorContentType、day、liveOrOnDemand、subscribedStatus
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します liveOrOnDemand、subscribedStatus

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

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

このレポートでは、チャンネルの動画の視聴回数または視聴時間が最も多かった埋め込み動画プレーヤーを確認できます。

目次
ディメンション:	必須 insightPlaybackLocationDetail 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched
フィルタ:	必須 insightPlaybackLocationType==EMBEDDED 0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します liveOrOnDemand、subscribedStatus
並べ替えオプション：	-views -estimatedMinutesWatched

トラフィック ソース

トラフィック ソース

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

注: クエリされた動画の数 × 期間の日数 の積が 50,000 を超えると、このレポートはエラーを返します。たとえば、500 個の動画 ID のデータを取得するクエリでは、最大 100 日間のデータをリクエストできます。リクエストで返される行数を減らすには、指定する動画の数を減らすか、期間を短くする複数のクエリに分割します。

目次
ディメンション:	必須 insightTrafficSourceType 0 以上を使用します creatorContentType、day、liveOrOnDemand、subscribedStatus
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します liveOrOnDemand、subscribedStatus

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

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

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

目次
ディメンション:	必須 insightTrafficSourceDetail 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched
フィルタ:	必須 insightTrafficSourceType（下の表の注を参照） 0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します liveOrOnDemand、subscribedStatus
並べ替えオプション：	-views -estimatedMinutesWatched

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

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

デバイスの種類

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

目次
ディメンション:	必須 deviceType 0 以上を使用します creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

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

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

目次
ディメンション:	必須 operatingSystem 0 以上を使用します creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します deviceType、liveOrOnDemand、subscribedStatus、youtubeProduct

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

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

目次
ディメンション:	必須 deviceType、operatingSystem 0 以上を使用します creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します liveOrOnDemand、subscribedStatus、youtubeProduct

視聴者のユーザー属性

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

目次
ディメンション:	1 つ以上使用する ageGroup、gender 0 以上を使用します creatorContentType、liveOrOnDemand、subscribedStatus
指標:	1 つ以上使用する viewerPercentage
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 または 1 を使用する video、group 0 以上を使用します liveOrOnDemand、subscribedStatus

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

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

目次
ディメンション:	必須 sharingService 0 以上を使用します creatorContentType、subscribedStatus
指標:	1 つ以上使用する shares
フィルタ:	0 または 1 を使用する country、continent、subContinent 0 または 1 を使用する video、group 省略可 subscribedStatus

視聴者維持率

このレポートでは、動画の視聴者を維持する能力を測定し、動画の特定のパートが視聴された頻度も確認できます。elapsedVideoTimeRatio ディメンションは、対応する指標値の経過時間を測定します。指標は次の 2 つのカテゴリに分類できます。

• 視聴者維持率

  これらの指標は、動画が視聴者の注目をどの程度維持できているかを示します。

  • audienceWatchRatio は、動画の一部が視聴された回数と動画の合計視聴回数を比較した比率です。
  • relativeRetentionPerformance は、長さが同程度の他の YouTube 動画と比較した、動画の再生中の視聴者維持率を示します。

• きめ細かいスマートウォッチの統計情報

  これらの指標は、動画の特定の部分が視聴された頻度に関する情報を提供します。

  • startedWatching は、動画の特定のセグメントで視聴者が動画の視聴を開始した頻度を示します。
  • stoppedWatching は、動画の特定のセグメントで視聴者が動画の視聴を停止した頻度を示します。
  • totalSegmentImpressions は、動画の特定のセグメントが視聴された頻度を示します。

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

目次
ディメンション:	必須 elapsedVideoTimeRatio
指標:	1 つ以上使用する audienceWatchRatio relativeRetentionPerformance startedWatching stoppedWatching totalSegmentImpressions
フィルタ:	必須 動画 0 以上を使用します audienceType subscribedStatus youtubeProduct

同時視聴者数（ライブ配信の場合）

このレポートには、1 つのライブ配信動画の特定の時点における同時視聴者数が表示されます。フィルタは動画を指定します。通常、位置ディメンションは 1 分を表します。

目次
ディメンション:	0 または 1 を使用する livestreamPosition
指標:	1 つ以上使用する averageConcurrentViewers peakConcurrentViewers
フィルタ:	必須 動画

人気の動画

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

上位の動画（地域フィルタは省略可）（200 件以下の結果）

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

目次
ディメンション:	必須 動画 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews*、playbackBasedCpm
フィルタ:	0 または 1 を使用する country、continent、subContinent
並べ替えオプション：	-views -redViews -estimatedRevenue -estimatedRedPartnerRevenue -estimatedMinutesWatched -estimatedRedMinutesWatched -subscribersGained -subscribersLost

都道府県別の人気動画（200 件以下の結果）

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

目次
ディメンション:	必須 動画 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
フィルタ:	必須 province 省略可 subscribedStatus
並べ替えオプション：	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

チャンネル登録者または未登録者の上位の動画（200 件以下の結果）

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

目次
ディメンション:	必須 動画 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews、views、redViews、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
フィルタ:	省略可 subscribedStatus 0 または 1 を使用する country、continent、subContinent
並べ替えオプション：	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

YouTube サービス別の人気動画 （200 件以下の結果）

このレポートには、チャンネルの上位の動画が表示され、再生の詳細と地域別のフィルタがサポートされています。このレポートは上のレポートと似ていますが、サポートされる指標が少なく、youtubeProduct フィルタがサポートされています。

目次
ディメンション:	必須 動画 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 以上を使用します subscribedStatus、youtubeProduct
並べ替えオプション：	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

再生の詳細フィルタを使用した上位の動画 （200 件以下の結果）

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

目次
ディメンション:	必須 動画 省略可 creatorContentType
指標:	1 つ以上使用する engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:	0 または 1 を使用する country、province、continent、subContinent 0 以上を使用します liveOrOnDemand、subscribedStatus、youtubeProduct
並べ替えオプション：	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

再生リストレポート

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

集計された動画指標

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

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

再生リスト内の指標

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

サポートされているプレイリストの指標

目次
集計された動画指標	engagedViews、views、estimatedMinutesWatched、averageViewDuration
再生リスト内の指標	playlistViews、playlistEstimatedMinutesWatched、playlistAverageViewDuration、playlistSaves、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

基本統計情報

このレポートは、チャンネルの再生リスト内の動画に対するユーザーの操作に関する統計情報を提供します。レポートをフィルタして、特定の再生リストのデータのみを返すことができます。

目次
ディメンション:	[None]
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	1 つだけ使用する playlist、group

時間ベース

このレポートは、チャンネルの再生リスト内の動画に対するユーザーの操作に関する統計情報を提供します。レポートをフィルタして、特定の再生リストのデータのみを返すことができます。

目次
ディメンション:	1 つだけ使用する 日、月
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	1 つだけ使用する playlist、group

ユーザーの地域

国別のプレイリスト アクティビティ

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

目次
ディメンション:	必須 country
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration
フィルタ:	1 つだけ使用する playlist、group 0 または 1 を使用する continent、subContinent

都道府県別のプレイリスト アクティビティ

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

目次
ディメンション:	必須 province
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration
フィルタ:	必須 country==US 1 つだけ使用する playlist、group

再生場所

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

目次
ディメンション:	必須 insightPlaybackLocationType
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	1 つだけ使用する playlist、group

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

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

このレポートでは、チャンネルの再生リスト内の動画の視聴回数または視聴時間が特に多かった埋め込み動画プレーヤーを確認できます。

目次
ディメンション:	必須 insightPlaybackLocationDetail
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	必須 insightPlaybackLocationType==EMBEDDED 1 つだけ使用する playlist、group
並べ替えオプション：	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

トラフィック ソース

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

目次
ディメンション:	必須 insightTrafficSourceType
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	1 つだけ使用する playlist、group

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

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

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

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

目次
ディメンション:	必須 insightTrafficSourceDetail
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	必須 insightTrafficSourceType==ADVERTISING（またはサポートされている別の値） 1 つだけ使用する playlist、group
並べ替えオプション：	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

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

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

デバイスの種類

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

目次
ディメンション:	必須 deviceType
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	1 つだけ使用する playlist、group

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

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

目次
ディメンション:	必須 operatingSystem
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	1 つだけ使用する playlist、group

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

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

目次
ディメンション:	必須 deviceType、operatingSystem
指標:	1 つ以上使用する engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:	1 つだけ使用する playlist、group

視聴者のユーザー属性

目次
ディメンション:	1 つ以上使用する ageGroup、gender
指標:	必須 viewerPercentage
フィルタ:	1 つだけ使用する playlist、group

上位の再生リスト

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

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

目次
ディメンション:	必須 プレイリスト
指標:	1 つ以上使用する averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
並べ替えオプション：	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

メンバーシップ レポート

メンバーシップの解約

このレポートでは、ユーザーがチャンネル メンバーシップを解約した理由を示す統計情報を確認できます。

目次
ディメンション:	0 または 1 を使用する membershipsCancellationSurveyReason
指標:	必須 membershipsCancellationSurveyResponses

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

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

広告のパフォーマンス レポートには、動画の再生中に表示された広告のインプレッションに基づく指標が表示されます。これらの指標では、広告のインプレッションごとにカウントされ、1 回の動画再生で複数のインプレッションが発生する可能性があります。

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

• grossRevenue
• adImpressions
• cpm

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

• playbackBasedCpm
• monetizedPlaybacks

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

目次
ディメンション:	必須 adType 省略可 日
指標:	1 つ以上使用する grossRevenue、adImpressions、cpm
フィルタ:	0 または 1 を使用する video、group 0 または 1 を使用する country、continent、subContinent