このページでは、コンテンツ所有者が YouTube Reporting API を使用して取得できるレポートについて説明します。各レポートの id
(API の reportTypes.list
メソッドから返される値)は、レポート名の横に括弧付きで表示されます。
動画レポート
動画レポートには、チャンネルの動画またはコンテンツ所有者の動画に関連するすべてのユーザー アクティビティの統計情報が表示されます。たとえば、これらのレポートには動画の視聴回数が表示されます。
ユーザー アクティビティ
このレポートは、コンテンツ所有者のチャンネルとそのチャンネルの動画に関連したユーザー アクションの統計情報を提供します。このレポートの現在のバージョンの 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 回視聴されたとします。その日のアセット レポートには、動画が 20 回視聴されたと表示されますが、そのうち 10 回しか申し立て後に発生していません。連続するすべての日付の指標は、申し立てを受けた動画に関連するユーザー アクティビティを正確に反映している必要があります。
ユーザー アクティビティ
このレポートには、コンテンツ所有者のアセットにリンクされている動画に対するユーザーの操作に関する統計情報が表示されます。このレポートの 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_group, gender |
指標: | 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 指標を追加