このページでは、YouTube Reporting API でコンテンツ所有者が取得できるレポートの一覧を示します。API の reportTypes.list
メソッドで返される各レポートの id
は、レポート名の横のかっこ内に表示されます。
動画レポート
動画レポートでは、チャンネルの動画やコンテンツ所有者の動画に関連するすべてのユーザー アクティビティについての統計情報を確認できます。たとえば、これらのレポートでは、動画が視聴された回数を確認できます。
ユーザー アクティビティ
このレポートでは、コンテンツ所有者のチャンネルとそのチャンネルの動画に関するユーザー アクティビティの統計情報を確認できます。このレポートの最新バージョンの id
は content_owner_basic_a3
です。
このレポートのこのバージョンの id
は content_owner_basic_a3
です。バージョン a2
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
注: content_owner_basic_a1
レポートは完全に廃止されました。
州別のユーザー アクティビティ
このレポートは、特定の米国の州またはコロンビア特別区のユーザー アクティビティに関する統計情報を提供します。このレポートの id
は content_owner_province_a2
です。
このレポートのこのバージョンの id
は content_owner_province_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
再生場所
このレポートでは、動画の再生が発生したページまたはアプリケーションの種類に関連する統計情報を確認できます。このレポートの id
は content_owner_playback_location_a2
です。
このレポートのこのバージョンの id
は content_owner_playback_location_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
トラフィック ソース
このレポートでは、視聴者がコンテンツ所有者のチャンネルで動画にアクセスした方法に基づいて、視聴統計情報が集計されます。
たとえば、Google 検索や関連動画へのリンクに由来する視聴回数を確認できます。このレポートの id
は content_owner_traffic_source_a2
です。
このレポートのこのバージョンの id
は content_owner_traffic_source_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
デバイスの種類とオペレーティング システム
このレポートでは、視聴者のオペレーティング システムとデバイスタイプに基づいて動画視聴の統計情報を集計します。たとえば、Android タブレットや Windows デスクトップ デバイスでの視聴回数を確認できます。このレポートの id
は content_owner_device_os_a2
です。
このレポートのこのバージョンの id
は content_owner_device_os_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
視聴者のユーザー属性
このレポートには、視聴者の年齢層と性別に基づく視聴統計情報が集計されます。
このレポートの id
は content_owner_demographics_a1
です。
目次 | |
---|---|
サイズ: | date、channel_id、video_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code、age_group、gender |
指標: | views_percentage |
プラットフォーム別のコンテンツ共有
このレポートには、コンテンツ所有者のチャンネルの動画がさまざまなソーシャル プラットフォームで共有された頻度を示す統計情報が表示されます。
このレポートの id
は content_owner_sharing_service_a1
です。
目次 | |
---|---|
サイズ: | date、channel_id、video_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code、sharing_service |
指標: | 共有数 |
アノテーション
このレポートでは、コンテンツ所有者のチャンネルの動画中にアノテーションが表示される統計情報を確認できます。
レポートデータは、動画ごとに個別のアノテーションのパフォーマンスを測定します。一方、ユーザー アクティビティ レポートには、動画のすべてのアノテーションの統計情報が集計されます。このレポートの id
は content_owner_annotations_a1
です。
カード
このレポートでは、コンテンツ所有者のチャンネルの動画中に表示されるカードのインプレッション数とクリックスルーの統計情報を確認できます。
レポートデータは、個々のカードのパフォーマンスを測定します。一方、ユーザー アクティビティ レポートには、動画内のすべてのカードの統計情報が集計されます。このレポートの id
は content_owner_cards_a1
です。
終了画面
このレポートでは、動画の再生が停止した後に表示される終了画面のインプレッションとクリックスルーの統計情報を確認できます。
このレポートには、コンテンツ所有者のチャンネルの動画に関する統計情報が含まれています。このレポートの id
は content_owner_end_screens_a1
です。
字幕
このレポートでは、動画視聴中に最も長く使われた字幕言語の統計情報を確認できます。字幕がほぼオフになっているビューは除外されます。このレポートの id
は content_owner_subtitles_a2
です。
このレポートのこのバージョンの id
は content_owner_subtitles_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
両方を合わせた値
このレポートでは、再生場所、トラフィック ソース、デバイス/OS レポートで使用されているディメンションを組み合わせて、詳細な動画統計情報を確認できます。このレポートの id
は content_owner_combined_a2
です。
このレポートのこのバージョンの id
は content_owner_combined_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
再生リストレポート
再生リストレポートでは、再生リスト内で発生した動画再生回数に関する統計情報を確認できます。
ユーザー アクティビティ
このレポートでは、コンテンツ所有者のチャンネルの再生リストに対するユーザー操作統計情報を確認できます。
このレポートの id
は content_owner_playlist_basic_a1
です。
州別のユーザー アクティビティ
このレポートでは、米国の州およびコロンビア特別区のユーザーを対象とした、コンテンツ所有者のチャンネルの再生リストにおけるユーザー操作に関する統計情報を確認できます。
つまり、country_code ディメンションの値が US
のデータのみが含まれるように、レポートがフィルタされます。このレポートの id
は content_owner_playlist_province_a1
です。
再生場所
このレポートは、再生リストが再生されたページまたはアプリケーションの種類に関連する統計情報を提供します。このレポートの id
は content_owner_playlist_playback_location_a1
です。
トラフィック ソース
このレポートでは、視聴者がコンテンツ所有者のチャンネルで再生リストの動画にリーチした方法に基づいて、視聴統計情報が集計されます。
たとえば、Google 検索や関連動画へのリンクに由来する視聴回数を確認できます。このレポートの id
は content_owner_playlist_traffic_source_a1
です。
デバイスの種類とオペレーティング システム
このレポートは、視聴者のオペレーティング システムとデバイスタイプに基づいて再生リストの視聴統計情報を集計します。たとえば、Android タブレットや Windows デスクトップ デバイスでの視聴回数を確認できます。このレポートの id
は content_owner_playlist_device_os_a1
です。
両方を合わせた値
このレポートは、再生場所、トラフィック ソース、デバイス / OS レポートで使用されるディメンションを組み合わせることで、詳細なプレイリストの統計情報を提供します。このレポートの id
は content_owner_playlist_combined_a1
です。
広告レートレポート
広告率レポートには、動画の再生中に配信された広告のインプレッション ベースの指標が表示されます。これらの指標は広告のインプレッションごとに考慮され、動画の再生ごとに複数のインプレッションが生成されます。
この API では、コンテンツ所有者の動画広告の広告指標を確認できる次の広告レポートをサポートしています。このレポートの最新バージョンの id
は content_owner_ad_rates_a1
です。
このレポートのこのバージョンの id
は content_owner_ad_rates_a1
です。完全にサポートが終了したこのレポートの以前のバージョンの ID は content_owner_ad_performance_a1
でした。
以前のバージョンとの唯一の違いは、このバージョンでは、performance
ではなく rates
という単語を使用するようにレポート名が更新されたことです。その結果、レポート自体のバージョン番号(a1
)は以前のバージョンと同じですが、report ID
が異なります。
目次 | |
---|---|
サイズ: | date、channel_id、video_id、claimed_status、uploader_type、country_code、ad_type |
指標: | estimated_youtube_ad_revenue、ad_impressions、estimated_cpm |
推定収益レポート
推定収益レポートには、Google が販売した広告ソースとそれ以外のソースからの動画の推定合計収益が表示されます。このレポートには、広告の掲載結果に関する指標も含まれています。
収益の指標では、特定の収益源と、それらの収益源から発生した合計収益額を確認できます。
動画の推定収益
このレポートでは、Google が販売した広告ソースと広告以外のソースから得たコンテンツ所有者の動画の合計収益を確認できます。広告のパフォーマンス指標も含まれています。このレポートの最新バージョンの id
は content_owner_estimated_revenue_a1
です。
このレポートのこのバージョンの id
は content_owner_estimated_revenue_a1
です。以前のバージョン(content_owner_estimated_earnings_a1
)とは次の点が異なります。
- estimated_partner_red_revenue の指標を追加
- estimated_partner_transaction_revenue 指標を追加します
- 指標の estimated_partner_ad_sense_revenue の名前を estimated_partner_ad_auction_revenue に変更しました
- 指標の estimated_partner_double_click_revenue の名前を estimated_partner_ad_reserved_revenue に変更しました
- レポート名を更新し、
earnings
という単語ではなくrevenue
という単語を使用するようにしました。その結果、レポート自体のバージョン番号(a1
)は以前のバージョンと同じですが、report ID
が異なります。
アセットの推定収益
このレポートでは、Google が販売した広告ソースと広告以外のソースから得たすべてのコンテンツ所有者のアセットの合計収益を確認できます。広告のパフォーマンス指標も含まれています。channel_id ディメンションでは、指標を提供する video_id をアップロードしたチャンネルを識別します。このレポートの最新バージョンの id
は content_owner_asset_estimated_revenue_a1
です。
このレポートのこのバージョンの id
は content_owner_asset_estimated_revenue_a1
です。以前のバージョン(content_owner_asset_estimated_earnings_a1
)とは次の点が異なります。
- estimated_partner_red_revenue の指標を追加
- estimated_partner_transaction_revenue 指標を追加します
- 指標の estimated_partner_ad_sense_revenue の名前を estimated_partner_ad_auction_revenue に変更しました
- 指標の estimated_partner_double_click_revenue の名前を estimated_partner_ad_reserved_revenue に変更しました
- レポート名を更新し、
earnings
という単語ではなくrevenue
という単語を使用するようにしました。その結果、レポート自体のバージョン番号(a1
)は以前のバージョンと同じですが、report ID
が異なります。
アセット レポート
アセット レポートでは、コンテンツ所有者のアセットにリンクされている動画に関連するユーザー アクティビティの指標を確認できます。コンテンツ所有者が、自分のコンテンツ所有者のアセットのいずれかに一致するとして申し立てを行った動画は、コンテンツ所有者のレポートに含まれます。その動画がコンテンツ所有者または別の YouTube ユーザーによってアップロードされたものである可能性があります。
アセット レポートの channel_id ディメンションは、指標が提供される video_id をアップロードしたチャンネルを示します。
たとえば、ある日に 10 回視聴され、その後申し立てが行われ、さらに 10 回視聴されたとします。この日についてのアセット レポートでは、申し立てが行われた後に動画が 10 回しか再生されなかった場合でも、動画の視聴回数は 20 回と表示されます。すべての連続した日の指標は、申し立て動画に関連するユーザー アクティビティを正確に反映している必要があります。
ユーザー アクティビティ
このレポートでは、コンテンツ所有者のアセットにリンクされた動画に対するユーザーの操作に関する統計情報を確認できます。このレポートの id
は content_owner_asset_basic_a2
です。
このレポートのこのバージョンの id
は content_owner_asset_basic_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
州別のユーザー アクティビティ
このレポートは、特定の米国の州またはコロンビア特別区のユーザー アクティビティに関する統計情報を提供します。つまり、country_code ディメンションの値が US
のデータのみが含まれるように、レポートがフィルタされます。このレポートの id
は content_owner_asset_province_a2
です。
このレポートのこのバージョンの id
は content_owner_asset_province_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
動画の再生場所
このレポートでは、動画の再生が発生したページまたはアプリケーションの種類に関連する統計情報を確認できます。このレポートの id
は content_owner_asset_playback_location_a2
です。
このレポートのこのバージョンの id
は content_owner_asset_playback_location_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
トラフィック ソース
このレポートでは、視聴者がコンテンツ所有者のアセットにリンクされた動画コンテンツにアクセスした方法に基づいて、視聴の統計情報を集計します。たとえば、Google 検索や関連動画へのリンクに由来する視聴回数を確認できます。このレポートの id
は content_owner_asset_traffic_source_a2
です。
このレポートのこのバージョンの id
は content_owner_asset_traffic_source_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
デバイスの種類とオペレーティング システム
このレポートでは、視聴者のオペレーティング システムとデバイスタイプに基づいて動画視聴の統計情報を集計します。たとえば、Android タブレットや Windows デスクトップ デバイスでの視聴回数を確認できます。このレポートの id
は content_owner_asset_device_os_a2
です。
このレポートのこのバージョンの id
は content_owner_asset_device_os_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加
視聴者のユーザー属性
このレポートには、視聴者の年齢層と性別に基づく視聴統計情報が集計されます。このレポートの id
は content_owner_asset_demographics_a1
です。
目次 | |
---|---|
サイズ: | date、channel_id、video_id、asset_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code、age、2 |
指標: | views_percentage |
プラットフォーム別のコンテンツ共有
このレポートでは、コンテンツ所有者のアセットにリンクされている動画が、さまざまなソーシャル プラットフォームで共有された頻度を確認できます。このレポートの id
は content_owner_asset_sharing_service_a1
です。
目次 | |
---|---|
サイズ: | date、channel_id、video_id、asset_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code、sharing_service |
指標: | 共有数 |
アノテーション
このレポートには、コンテンツ所有者のアセットにリンクされた動画の途中に表示されるアノテーションの統計情報が表示されます。レポートデータは、個々のアノテーションのパフォーマンスを測定します。一方、ユーザー アクティビティ レポートには、動画のすべてのアノテーションの統計情報が集計されます。このレポートの id
は content_owner_asset_annotations_a1
です。
カード
このレポートでは、コンテンツ所有者のアセットにリンクされた動画の中に表示されるカードのインプレッション数とクリックスルーの統計情報を確認できます。レポートデータは、個々のカードのパフォーマンスを測定します。一方、ユーザー アクティビティ レポートでは、アセットにリンクされている各動画に表示されるすべてのカードの統計情報が集計されます。このレポートの id
は content_owner_asset_cards_a1
です。
終了画面
このレポートでは、動画の再生が停止した後に表示される終了画面のインプレッションとクリックスルーの統計情報を確認できます。このレポートには、コンテンツ所有者のチャンネルの申し立てを行った動画の統計情報が含まれ、動画に関連付けられているアセットも識別されます。このレポートの id
は content_owner_asset_end_screens_a1
です。
両方を合わせた値
このレポートでは、再生場所、トラフィック ソース、デバイス / OS レポートで使用されているディメンションを組み合わせて、詳細な動画統計情報を確認できます。このレポートの id
は content_owner_asset_combined_a2
です。
このレポートのこのバージョンの id
は content_owner_asset_combined_a2
です。バージョン a1
との違いは次のとおりです。
- red_views 指標を追加
- red_watch_time_minutes 指標を追加