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 コンテンツ所有者にリンクされているチャンネルの指標が含まれます。指標とは、ユーザーの行動、広告のパフォーマンス、推定収益の個別の測定値のことです。

  • 動画レポートには、コンテンツ所有者のチャンネルの動画に関するユーザー アクティビティ、広告のパフォーマンス、推定収益の指標が含まれます。

  • 再生リストレポートには、再生リスト内で発生した動画再生回数に関連する統計情報が表示されます。再生リストレポートでは、動画レポートと同じディメンションとフィルタを多数使用します。

  • 広告のパフォーマンス レポートには、収益と広告のパフォーマンスに関連する指標が含まれます。動画再生中に表示された広告の種類に基づいて指標をグループ化するには、adTypeadType ディメンションを使用します。広告のパフォーマンス レポートのセクションでは、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 を使用してください 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 個以上の値を使用する: グループに含まれる値の一部またはすべてを含めることができます。
重要: コンテンツ所有者の動画レポートを取得するすべての API リクエストでは、video ディメンション、channel ディメンション、group ディメンション、または claimedStatus ディメンションと uploaderType ディメンションのサポートされている組み合わせのいずれかを使用してデータをフィルタする必要があります。（レポートによっては、これらすべてのオプションに対応していないものもあります）。サポートされている組み合わせは次のとおりです（uploaderType ディメンションの定義にも表示されます）。
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

動画レポート

基本統計情報

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

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

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

米国の各州の基本的な統計情報

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

目次
サイズ:
[None]
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
必須 province

時間ベース

特定の期間のアクティビティ

このレポートでは、特定の期間における、コンテンツ所有者のすべてのチャンネルにおけるユーザー アクションに関連する統計情報を確認できます。特定の動画または特定の国に関するデータのみが含まれるように、レポートをフィルタリングすることができます。

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

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

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

目次
サイズ:
1 つのみを使用 day、month
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
必須 province

ユーザーの地域

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

このレポートには、コンテンツ所有者のすべてのチャンネルのユーザー アクティビティに関する統計情報が国別に表示されます。特定の動画またはチャンネルのデータのみを返すように、レポートにフィルタを適用できます。

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

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

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

目次
サイズ:
必須 province
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
必須 country==US

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

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

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

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

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

再生の詳細

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

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

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

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

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

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

目次
サイズ:
0 個以上を使用してください creatorContentType、subscribedStatus
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views, redViews, likes, reduces, videosAddedToPlaylists, videosRemovedFromPlaylists, shares,estimatedMinutesWatched, estimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください country、Continent、subContinent
任意 subscribedStatus

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

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

目次
サイズ:
0 個以上を使用してください creatorContentType、subscribedStatus
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
必須 province
任意 subscribedStatus

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

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

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

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

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

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

目次
サイズ:
0 個以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
0 または 1 を使用してください day、month
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct

国別の再生詳細

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

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

目次
サイズ:
任意 country
0 個以上を使用してください creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください Continent、subContinent
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
averageViewPercentage 指標を含む国別の再生詳細

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

目次
サイズ:
任意 country
0 個以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct

地域別の再生詳細

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

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

目次
サイズ:
任意 province
0 個以上を使用してください creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
必須 country==US
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
州ごとの再生詳細（averageViewPercentage 指標）

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

目次
サイズ:
任意 province
0 個以上を使用してください creatorContentType、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
必須 country==US
0 個以上を使用してください subscribedStatus、youtubeProduct

再生場所

ビデオ再生場所レポート

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

目次
サイズ:
必須 insightPlaybackLocationType
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください liveOrOnDemand、subscribedStatus

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

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

このレポートでは、コンテンツ所有者のコンテンツについて、視聴回数または再生時間が最も多かった埋め込み動画プレーヤーが特定されます。このレポートを取得するときは、insightPlaybackLocationType フィルタを EMBEDDED に設定する必要があります。

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

トラフィック ソース

トラフィック ソース

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

目次
サイズ:
必須 insightTrafficSourceType
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください liveOrOnDemand、subscribedStatus

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

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

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

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

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

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

デバイスのタイプ

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

目次
サイズ:
必須 deviceType
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

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

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

目次
サイズ:
必須 operatingSystem
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください deviceType、liveOrOnDemand、subscribedStatus、youtubeProduct

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

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

目次
サイズ:
必須 operatingSystem,deviceType
0 個以上を使用してください creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct

視聴者のユーザー属性

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

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

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

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

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

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

目次
サイズ:
必須 sharingService
任意 creatorContentType、subscribedStatus
指標:
1 つ以上使用 共有
フィルタ:
1 つのみを使用 video、channel、group、または uploaderType と claimedStatus のサポートされている組み合わせ
0 または 1 を使用してください country、Continent、subContinent
任意 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 件以下）

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

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 viewbased, redViews, comments, likes, 認定試験 64 インプレッション}videosAddedToPlaylists, videosRemovedFromPlaylists,shares, estimatedMinutesWatched,estimatedRedMinutesWatched,averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
フィルタ:
1 つのみを使用 channel、またはサポートされている uploaderType と claimedStatus の組み合わせ。
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
フィルタ:
1 つのみを使用 channel、またはサポートされている uploaderType と claimedStatus の組み合わせ。
必須 province
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、likes、deprecations、videosAddedToPlaylists、videosRemovedFromPlaylists、共有、estimatedMinutesWatched、estimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
フィルタ:
1 つのみを使用 channel、またはサポートされている uploaderType と claimedStatus の組み合わせ。
任意 subscribedStatus
0 または 1 を使用してください country、Continent、subContinent
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
フィルタ:
1 つのみを使用 channel、またはサポートされている uploaderType と claimedStatus の組み合わせ。
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

このレポートには、コンテンツ所有者の上位の動画がリストされ、1 つ以上の再生情報ディメンション（liveOrOnDemand、subscribedStatus、youtubeProduct）でフィルタリングされています。このレポートでは、地域でのフィルタリングもサポートされています。

目次
サイズ:
必須 動画
任意 creatorContentType
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
フィルタ:
1 つのみを使用 channel、またはサポートされている uploaderType と claimedStatus の組み合わせ。
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください liveOrOnDemand、subscribedStatus、youtubeProduct
並べ替えオプション： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

再生リストレポート

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

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

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

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

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

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

再生リスト内の指標

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

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

基本統計情報

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

推奨
目次
サイズ:
[None]
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel
isCurated の使用
目次
サイズ:
[None]
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください channel、playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct

時間ベース

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

推奨
目次
サイズ:
1 つのみを使用 day、month
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel
isCurated の使用
目次
サイズ:
1 つのみを使用 day、month
0 個以上を使用してください subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください channel、playlist、group
0 または 1 を使用してください country、regional、Continent、subContinent
0 個以上を使用してください subscribedStatus、youtubeProduct

ユーザーの地域

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

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

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

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

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

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

再生場所

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

推奨
目次
サイズ:
必須 insightPlaybackLocationType
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel

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

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

このレポートでは、コンテンツ所有者の再生リストについて、最も多くの視聴回数または視聴時間を生み出した埋め込み動画プレーヤーが特定されます。

推奨
目次
サイズ:
必須 insightPlaybackLocationDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
必須 insightPlaybackLocationType==EMBEDDED
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel
並べ替えオプション： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
isCurated の使用
目次
サイズ:
必須 insightPlaybackLocationDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1;insightPlaybackLocationType==EMBEDDED
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください playlist、channel、group
任意 subscribedStatus
並べ替えオプション： -views
-estimatedMinutesWatched
-playlistStarts

トラフィック ソース

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

推奨
目次
サイズ:
必須 insightTrafficSourceType
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel

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

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

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

推奨
目次
サイズ:
必須 insightTrafficSourceDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
必須 insightTrafficSourceType
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel
並べ替えオプション： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
isCurated の使用
目次
サイズ:
必須 insightTrafficSourceDetail
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1;insightTrafficSourceType
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください playlist、channel、group
任意 subscribedStatus
並べ替えオプション： -views
-estimatedMinutesWatched
-playlistStarts

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

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

プレイリストのデバイスタイプ

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

推奨
目次
サイズ:
必須 deviceType
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel
isCurated の使用
目次
サイズ:
必須 deviceType
0 個以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください playlist、channel、group
0 個以上を使用してください operatingSystem、subscribedStatus、youtubeProduct

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

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

推奨
目次
サイズ:
必須 operatingSystem
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel
isCurated の使用
目次
サイズ:
必須 operatingSystem
0 個以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください playlist、channel、group
0 個以上を使用してください deviceType、subscribedStatus、youtubeProduct

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

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

推奨
目次
サイズ:
必須 deviceType、operatingSystem
指標:
1 つ以上使用 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
フィルタ:
0 または 1 を使用してください* playlist、group

注: views、estimatedMinutesWatched、averageViewDuration のいずれかの指標がレポートでリクエストされている場合は、これらのフィルタのいずれかを指定する必要があります。
任意 channel
isCurated の使用
目次
サイズ:
必須 deviceType、operatingSystem
0 個以上を使用してください day、subscribedStatus、youtubeProduct
指標:
1 つ以上使用 views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください country、regional、Continent、subContinent
0 または 1 を使用してください playlist、channel、group
0 個以上を使用してください subscribedStatus、youtubeProduct

視聴者のユーザー属性

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

注: このレポートの viewerPercentage 値は、再生の詳細ディメンション（subscribedStatus と youtubeProduct）のさまざまな値や値の組み合わせに対して正規化されていません。
たとえば、subscribedStatus ディメンションを使用するレポートでは、viewerPercentage のデータが、チャンネル登録数の場合は最大 100% になり、未配信の視聴率の場合は 0 になります。
viewerPercentage（レポート内のすべての viewerPercentage フィールドの合計値は 200% になります）。

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

上位の再生リスト

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

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

isCurated の使用
目次
サイズ:
必須 プレイリスト
指標:
1 つ以上使用 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
フィルタ:
必須 isCurated==1
0 または 1 を使用してください 再生リスト、チャンネル
0 または 1 を使用してください country、regional、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