このページでは、コンテンツ所有者が YouTube Reporting API で取得できるレポートの一覧を示します。各レポートの id
は、API の reportTypes.list
メソッドから返されるもので、レポート名の横の括弧内に表示されます。
動画レポート
動画レポートには、チャンネルの動画またはコンテンツ所有者の動画に関連するすべてのユーザー アクティビティの統計情報が表示されます。たとえば、これらのレポートには動画が視聴された回数が含まれます。
ユーザー アクティビティ
このレポートは、コンテンツ所有者のチャンネルとそのチャンネルの動画に関連したユーザー アクションの統計情報を提供します。
このレポートの id
は content_owner_basic_a4
です。
州別のユーザー アクティビティ
このレポートは、米国の州とコロンビア特別区のユーザー アクティビティの統計情報を提供します。
このレポートの id
は content_owner_province_a3
です。
再生場所
このレポートは、動画再生が発生したページまたはアプリケーションのタイプに関する統計情報を提供します。.
このレポートの id
は content_owner_playback_location_a3
です。
トラフィック ソース
このレポートでは、コンテンツ所有者のチャンネルで視聴者が動画にアクセスした方法に基づいて視聴統計情報が集計されます。たとえば、Google 検索から発生した視聴回数や、関連動画へのリンクから発生した視聴回数を特定できます。
このレポートの id
は content_owner_traffic_source_a3
です。
デバイスの種類とオペレーティング システム
このレポートでは、視聴者のオペレーティング システムとデバイスの種類に基づいて動画視聴の統計情報が集計されます。たとえば、Android タブレットあるいは Windows デスクトップ デバイスでの表示回数を特定します。
このレポートの id
は content_owner_device_os_a3
です。
視聴者のユーザー属性
このレポートは、視聴者の年齢層や性別に基づいて表示回数の統計情報を集計します。
このレポートの 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 |
指標: | shares |
アノテーション
このレポートは、コンテンツ所有者のチャンネルの動画に表示されるアノテーションの統計情報を提供します。
レポートデータには、各動画の個々のアノテーションのパフォーマンスが測定されます。一方、ユーザー アクティビティ レポートでは、動画のすべてのアノテーションの統計情報が集計されます。
このレポートの id
は content_owner_annotations_a1
です。
カード
このレポートには、コンテンツ所有者のチャンネルの動画に表示されるカードの表示回数とクリック率の統計情報が表示されます。
レポートデータは、個々のカードのパフォーマンスを測定します。一方、ユーザー アクティビティ レポートでは、動画のすべてのカードの統計情報が集計されます。
このレポートの id
は content_owner_cards_a1
です。
終了画面
このレポートでは、動画の再生終了後に表示される終了画面のインプレッション数とクリック率の統計情報を確認できます。
このレポートには、コンテンツ所有者のチャンネルの動画の統計情報が含まれています。
このレポートの id
は content_owner_end_screens_a1
です。
字幕
このレポートでは、動画の視聴中に最も長く使用されたクローズド キャプションの言語に関する統計情報が表示されます。字幕がほとんどオフになっている視聴回数は除外されます。
このレポートの id
は content_owner_subtitles_a3
です。
組み合わせ
このレポートでは、再生場所、トラフィック ソース、デバイス/OS の各レポートで使用されているディメンションを組み合わせて、動画の詳細な統計情報を確認できます。
このレポートの id
は content_owner_combined_a3
です。
再生リストレポート
再生リスト レポートには、再生リストのコンテキストで発生した動画の視聴回数に特に関連する統計情報が表示されます。
ユーザー アクティビティ
このレポートは、コンテンツ所有者のチャンネルの再生リストに対するユーザーの操作に関する統計情報を提供します。
このレポートの id
は content_owner_playlist_basic_a2
です。
州別のユーザー アクティビティ
このレポートは、米国の州とコロンビア特別区のユーザーがコンテンツ所有者のチャンネルの再生リストを操作した際のユーザー アクティビティの統計情報を提供します。レポートは、country_code ディメンションの値が US
の場合にのみデータが含まれるようにフィルタされます。
このレポートの id
は content_owner_playlist_province_a2
です。
再生場所
このレポートには、プレイリストの再生が行われたページまたはアプリの種類に関する統計情報が表示されます。
このレポートの id
は content_owner_playlist_playback_location_a2
です。
トラフィック ソース
このレポートでは、コンテンツ所有者のチャンネルで視聴者が再生リストの動画にアクセスした方法に基づいて、視聴統計情報が集計されます。たとえば、このレポートでは、Google 検索や関連動画へのリンクから発生した視聴回数を特定できます。
このレポートの id
は content_owner_playlist_traffic_source_a2
です。
デバイスの種類とオペレーティング システム
このレポートでは、視聴者のオペレーティング システムとデバイスの種類に基づいて、再生リストの視聴統計情報が集計されます。たとえば、Android タブレットあるいは Windows デスクトップ デバイスでの表示回数を特定します。
このレポートの id
は content_owner_playlist_device_os_a2
です。
組み合わせ
このレポートでは、再生場所、トラフィック ソース、デバイス/OS の各レポートで使用されているディメンションを組み合わせて、詳細な再生リストの統計情報を確認できます。
このレポートの id
は content_owner_playlist_combined_a2
です。
広告レートレポート
広告レート レポートには、動画再生中に配信された広告のインプレッション ベースの指標が表示されます。これらの指標では、広告のインプレッションごとにカウントされ、1 回の動画再生で複数のインプレッションが発生する可能性があります。
この API は、コンテンツ所有者の動画の広告単価指標を提供する次の広告単価レポートをサポートしています。
このレポートの 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_a2
です。
アセットの推定収益
このレポートには、Google 広告配信元と広告以外の配信元からのコンテンツ所有者のすべてのアセットの合計収益が表示されます。また、広告のパフォーマンス指標も含まれています。channel_id ディメンションは、指標が提供されている video_id をアップロードしたチャンネルを識別します。
このレポートの id
は content_owner_asset_estimated_revenue_a2
です。
- 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
は異なります。
アセット レポート
アセット レポートには、コンテンツ所有者のアセットにリンクされている動画に関連するユーザー アクティビティ指標が表示されます。コンテンツ所有者が動画を所有するアセットの 1 つと一致するとして申し立てた場合、その動画はコンテンツ所有者のレポートに含まれます。動画は、コンテンツ所有者または別の YouTube ユーザーによってアップロードされた可能性があります。
アセット レポートでは、channel_id ディメンションは、指標が提供されている video_id をアップロードしたチャンネルを識別します。
たとえば、ある日に動画が 10 回視聴された後、申し立てが行われ、その後さらに 10 回視聴されたとします。この場合、申し立てが行われた後に発生した視聴回数は 10 回のみですが、その日のアセット レポートには動画の視聴回数が 20 回と表示されます。連続するすべての日の指標は、申し立てられた動画に関連するユーザー アクティビティを正確に反映している必要があります。
ユーザー アクティビティ
このレポートは、コンテンツ所有者のアセットにリンクされている動画に対するユーザーのアクションに関する統計情報を提供します。
このバージョンのレポートの id
は content_owner_asset_basic_a3
です。
州別のユーザー アクティビティ
このレポートは、米国の州とコロンビア特別区のユーザー アクティビティの統計情報を提供します。つまり、country_code ディメンションの値が US
の場合にのみデータが含まれるように、レポートがフィルタされます。このレポートの id
は content_owner_asset_province_a3
です。
このバージョンのレポートの id
は content_owner_asset_province_a3
です。
動画の再生場所
このレポートは、動画再生が発生したページまたはアプリケーションのタイプに関する統計情報を提供します。.
このバージョンのレポートの id
は content_owner_asset_playback_location_a3
です。
トラフィック ソース
このレポートでは、コンテンツ所有者のアセットにリンクされた動画コンテンツに視聴者がアクセスした方法に基づいて、視聴統計情報が集計されます。たとえば、Google 検索から発生した視聴回数や、関連動画へのリンクから発生した視聴回数を特定できます。
このバージョンのレポートの id
は content_owner_asset_traffic_source_a3
です。
デバイスの種類とオペレーティング システム
このレポートでは、視聴者のオペレーティング システムとデバイスの種類に基づいて動画視聴の統計情報が集計されます。たとえば、Android タブレットあるいは Windows デスクトップ デバイスでの表示回数を特定します。
このバージョンのレポートの id
は content_owner_asset_device_os_a3
です。
視聴者のユーザー属性
このレポートでは、視聴者の年齢層と性別に基づいて視聴統計情報が集計されます。このレポートの 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 |
指標: | shares |
アノテーション
このレポートには、コンテンツ所有者のアセットにリンクされた動画の再生中に表示されるアノテーションの統計情報が表示されます。レポートデータには、個々のアノテーションのパフォーマンスが測定されます。一方、ユーザー アクティビティ レポートでは、動画のすべてのアノテーションの統計情報が集計されます。このレポートの 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_a3
です。