Metrics

このドキュメントでは、YouTube Reporting API が取得する指標について説明します。この API は、チャンネルまたはコンテンツ所有者の YouTube アナリティクス データを含む一括データレポートを取得します。

指標は、ユーザー アクティビティ、広告のパフォーマンス、推定収益の個々の測定値です。ユーザー アクティビティの指標には、動画の視聴回数や評価（高評価と低評価）などがあります。

主要な指標

YouTube Reporting API は利用規約で定義されているサポート終了ポリシーの対象となりますが、主要でない指標（および主要でないディメンション）はポリシーの対象外です。このページの定義では、主要な指標は明示的にそのように示されています。

以下のリストは、API の主要な指標を示しています。 これらの指標のうち、YouTube Analytics API でも使用されているものは、その API でも主要な指標です。

詳しくは、サポート終了ポリシーの対象となる YouTube API のリストをご覧ください。

視聴に関する指標

engaged_views （主要な指標）
チャンネルの動画が最初のフレームを超えて視聴された回数、またはユーザーがクリック/タップして再生した回数。
views （主要な指標）
動画が視聴された回数。再生リスト レポートでは、再生リストのコンテキストで動画が視聴された回数を示します。視聴回数のレポート方法について詳しくは、 YouTube ヘルプセンター をご覧ください。 This is a core metric and is subject to the Deprecation Policy.
red_views
YouTube Premium（旧称: YouTube Red）メンバーが動画を視聴した回数。
views_percentage （主要な指標）
動画または再生リストを視聴したときにログインしていた視聴者の割合。This is a core metric and is subject to the Deprecation Policy.

リーチに関する指標

video_thumbnail_impressions
動画のサムネイルが視聴者に表示された回数。インプレッションがカウントされるのは、サムネイルの 50% 以上が 1 秒以上画面に表示された場合です。詳しくは YouTube ヘルプセンター をご覧ください。
video_thumbnail_impressions_ctr
動画を視聴するためのクリックにつながったインプレッションの割合。クリック数をインプレッション数で割って計算されます。

総再生時間に関する指標

watch_time_minutes （主要な指標）
指定したチャンネル、コンテンツ所有者、動画、再生リストの動画をユーザーが視聴した時間（分）。This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
YouTube Premium（旧称: YouTube Red）メンバーが動画を視聴した時間（分）。
average_view_duration_seconds （主要な指標）
動画再生の平均時間（秒）。2021 年 12 月 13 日より、この指標には ループ クリップ のトラフィックは含まれません。再生リスト レポートでは、再生リストのコンテキストで発生した動画再生の平均時間（秒）を示します。This is a core metric and is subject to the Deprecation Policy.
average_view_duration_percentage
動画再生中に視聴された動画の平均割合。2021 年 12 月 13 日より、この指標には ループ クリップのトラフィックは含まれません。

エンゲージメントに関する指標

コメント （主要な指標）
ユーザーが動画にコメントした回数。詳しくは YouTube ヘルプセンター をご覧ください。This is a core metric and is subject to the Deprecation Policy.
いいね （主要な指標）
視聴者が [高く評価] ボタンを押して動画に良い評価を付けた回数。This is a core metric and is subject to the Deprecation Policy.
dislikes （主要な指標）
視聴者が [低く評価] ボタンを押して動画に悪い評価を付けた回数。This is a core metric and is subject to the Deprecation Policy.
シェア （主要な指標）
[Share] ボタンでユーザーが動画を共有した回数。詳しくは YouTube ヘルプセンター をご覧ください。This is a core metric and is subject to the Deprecation Policy.
subscribers_gained （主要な指標）
ユーザーがチャンネル登録した回数。This is a core metric and is subject to the Deprecation Policy.

チャンネル登録者は、動画再生ページ、チャンネル ページ、YouTube ホームページに表示されるガイドなど、さまざまな場所で増減します。 動画再生ページからチャンネル登録しなかった新規チャンネル登録者の数を特定するには、基本的なユーザー アクティビティ レポートに video_id ディメンション値が指定されていない行を含めます。その行には subscribersLost 指標の値も指定されていますが、他の指標の値は指定されていません。
subscribers_lost （主要な指標）
ユーザーがチャンネル登録を解除した回数。This is a core metric and is subject to the Deprecation Policy.

この指標のデータは、subscribers_gained 指標と同様にレポートされます。 チャンネル登録を解除したものの、動画再生ページで解除しなかったユーザーの数を特定するには、基本的なユーザー アクティビティ レポートに video_id ディメンション値が指定されていない行を含めます。その行には subscribers_gained 指標の値も指定されていますが、他の指標の値は指定されていません。
videos_added_to_playlists
動画が YouTube の再生リストに追加された回数。動画は、動画所有者の再生リストまたは他のチャンネルの再生リストに追加された可能性があります。

この指標の値には、[後で見る] 再生リストなどのデフォルトの再生リストに動画が追加された回数が含まれます。ただし、チャンネルのアップロード再生リストやユーザーの再生履歴など、動画が自動的に追加される再生リストはカウントされません。

この指標は絶対数を返します。つまり、ユーザーが動画を再生リストに追加して削除し、再度追加した場合、指標の値には動画が再生リストに 2 回追加されたことが反映されます。この指標のデータは、2014 年 10 月 1 日より前の日付ではご利用いただけません。
videos_removed_from_playlists
動画が YouTube の再生リストから削除された回数。動画は、動画所有者の再生リストまたは他のチャンネルの再生リストから削除された可能性があります。

この指標の値には、[後で見る] 再生リストなどのデフォルトの再生リストから動画が削除された回数が含まれます。

この指標は絶対数を返します。つまり、ユーザーが動画を再生リストに追加して削除し、再度追加して再度削除した場合、指標の値には動画が再生リストから 2 回削除されたことが反映されます。この指標のデータは、2014 年 10 月 1 日より前の日付ではご利用いただけません。

再生リストに関する指標

再生リスト レポートには、視聴者が再生リスト内の動画 をどのように操作したかを示す 2 種類の指標が含まれています。

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

    サポートされている集計された動画の指標の定義については、このドキュメントの視聴に関する指標と 総再生時間に関する指標のセクションをご覧ください。

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

次の指標のほとんどは再生リスト内の指標です。リスト内の残りの指標（ playlistSaves 指標など）は、再生リスト内の動画ではなく、再生リスト自体に対するユーザー操作に関するものです。そのため、これらの指標は、 集計された動画の指標または再生リスト内の指標のいずれにも分類されません。

playlist_starts
視聴者が再生リストの再生を開始した回数。この指標には、ウェブで発生した再生リストの視聴回数のみが含まれます。
playlist_saves_added （YouTube Reporting API でのみサポート）
ユーザーが再生リストを保存した回数。保存した再生リストについて詳しくは、YouTube ヘルプセンターをご覧ください。この指標は絶対数を返します。つまり、ユーザーが再生リストを保存して、保存した再生リストのリストから削除し、再度保存した場合、指標の値には 2 つの再生リストの保存が追加されたことが反映されます。
playlist_saves_removed （YouTube Reporting API でのみサポート）
ユーザーが保存した再生リストのリストから再生リストを削除した回数。この指標は絶対数を返します。つまり、ユーザーが再生リストを保存して、保存した再生リストのリストから削除し、再度保存して再度削除した場合、指標の値には 2 つの再生リストの保存が削除されたことが反映されます。

アノテーションに関する指標

annotation_impressions
アノテーションのインプレッションの合計数。
annotation_clickable_impressions
表示されてクリック可能だったアノテーションの数。
annotation_clicks
クリックされたアノテーションの数。
annotation_click_through_rate （主要な指標）
視聴者がクリックしたアノテーションの数と、クリック可能なアノテーションのインプレッションの合計数の比率。This is a core metric and is subject to the Deprecation Policy. アノテーションの作成とリンク アノテーションの使用について詳しくは、YouTube ヘルプセンターをご覧ください。
annotation_closable_impressions
表示されて閉じることができたアノテーションの数。
annotation_closes
閉じられたアノテーションの数。
annotation_close_rate （主要な指標）
視聴者が閉じたアノテーションの数と、アノテーションのインプレッションの合計数の比率。This is a core metric and is subject to the Deprecation Policy.

カードに関する指標

動画にカードを追加する方法と YouTube アナリティクスのカード レポートについて詳しくは、YouTube ヘルプセンターをご覧ください。

card_impressions
カードが表示された回数。カードパネルが開くと、動画のカードごとにカードのインプレッションが記録されます。
card_clicks
カードがクリックされた回数。
card_click_rate
カードのクリック率。カードのクリック数をカードのインプレッション数で割って計算されます。
card_teaser_impressions
カードのティーザーが表示された回数。動画の視聴 1 回で複数のティーザーのインプレッションが生成されることがあります。
card_teaser_clicks
カードのティーザーのクリック数。カードアイコンに対するクリックは、ユーザーに表示された最後のティーザーをクリックしたものとしてカウントされます。
card_teaser_click_rate
カードのティーザーのクリック率。カードのティーザーのクリック数をカードのティーザーのインプレッションの合計数で割って計算されます。

終了画面に関する指標

終了画面は、動画の最後の 5 ～ 20 秒間に表示され、コンテンツ、チャンネル、ウェブサイトを宣伝する要素です。動画に終了画面を追加する方法とYouTube アナリティクスの終了画面レポートについて詳しくは、YouTube ヘルプセンターをご覧ください。

end_screen_element_impressions
表示された終了画面要素の数。表示される終了画面要素ごとに 1 回のインプレッションが記録されます。
end_screen_element_clicks
終了画面要素がクリックされた回数。
end_screen_element_click_rate
終了画面要素のクリック率。終了画面要素のクリック数を終了画面要素のインプレッション数で割って計算されます。

メンバーシップの解約に関する指標

membershipsCancellationSurveyResponses
レポート対象期間中に、 指定したチャンネルのチャンネル メンバーシップを解約した YouTube ユーザーが回答したアンケートの数。

推定収益に関する指標

注: 推定収益に関する指標は月末に調整されます。また、パートナーが販売または配信した広告は含まれません。推定収益額について詳しくは、YouTube ヘルプセンターをご覧ください。

YouTube Reporting API は、すべての推定収益額と収益額を米ドルでレポートします。
estimated_partner_revenue （主要な指標）
選択した期間と地域における、Google が販売したすべての広告ソースと広告以外のソースからの推定純収益の合計。
estimated_partner_ad_revenue
選択した期間と地域における、Google が販売したすべての広告ソースからの推定純収益の合計。

推定収益に関する指標は月末に調整されます。また、パートナーが販売または配信した広告は含まれません。
estimated_partner_ad_auction_revenue （YouTube Reporting API でのみサポート）
選択した期間と地域における、AdSense を通じてオークション販売された広告からの推定収益（純収益）の合計。この指標は、以前は estimated_partner_ad_sense_revenue という名前でした。
estimated_partner_ad_reserved_revenue （YouTube Reporting API でのみサポート）
DoubleClick（DCLK）やその他の YouTube の販売ソースを通じて予約販売された広告からの推定収益（純収益）の合計。この指標は、以前は estimated_partner_double_click_revenue という名前でした。
estimated_partner_red_revenue （YouTube Reporting API でのみサポート）
YouTube Premium（旧称: YouTube Red）のチャンネル登録からの推定総収益（純収益）の合計。
estimated_partner_transaction_revenue （YouTube Reporting API でのみサポート）
有料コンテンツやファン ファンディングなどのトランザクションからの推定収益の合計から、パートナーに請求された払い戻しを差し引いた金額。

広告のパフォーマンスに関する指標

estimated_youtube_ad_revenue
選択した期間と地域における、Google が販売した広告または DoubleClick パートナーが販売した広告からの推定総収益（米ドル）。総収益は月末に調整されます。また、パートナーが配信した広告は含まれません。総収益は、所有権の割合と収益分配契約を考慮した推定収益または純収益と混同しないでください。
estimated_cpm
広告の表示回数 1,000 回あたりの推定総収益。
ad_impressions
配信された確認済みの広告インプレッションの数。
estimated_monetized_playbacks
視聴者が動画を再生し、少なくとも 1 つの広告インプレッションが表示された回数。視聴者に対して、プレロール広告が表示されたが、動画が始まる前に広告の視聴を止めてしまった場合も、収益化の対象となる再生にカウントされます。この値の推定誤差は ±2.0% と想定されています。
estimated_playback_based_cpm
再生回数 1,000 回あたりの推定総収益。