Metrics

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

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

主要な指標

YouTube Reporting API は、利用規約で定義されている非推奨ポリシーの対象ですが、コア以外の指標（およびコア以外のディメンション）は対象外です。このページの定義では、コア指標である指標は明示的に識別されます。

次のリストに、API のコア指標を示します。YouTube アナリティクス API でも使用されているこれらの指標は、その API のコア指標でもあります。

詳しくは、非推奨ポリシーが適用される YouTube API のリストをご覧ください。

指標を表示

engaged_views （コア指標）
動画が 4 秒以上視聴された回数。
視聴回数 （コア指標）
動画が視聴された回数。再生リスト レポートでは、この指標は再生リストのコンテキストで動画が視聴された回数を示します。視聴回数の報告方法について詳しくは、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.

総再生時間に関する指標

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.
高評価数 （コア指標）
ユーザーが [低評価] ボタンを押して動画に低評価を付けた回数。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
終了画面要素のクリックスルー率。終了画面要素のクリック数と終了画面要素のインプレッション数の比率で計算されます。

視聴者維持に関する指標

audience_retention_percentage
動画の特定の時点で動画を視聴している視聴者の絶対数。この比率は、動画の一部が視聴された回数を動画の合計視聴回数で割って算出されます。elapsed_video_time_percentage ディメンションは、指標が対応する動画の部分を識別します。

なお、動画の一部は、1 回の動画再生で複数回視聴される場合もあれば、視聴されないこともあります。たとえば、ユーザーが動画の同じ部分を巻き戻して複数回視聴した場合、その部分の絶対比率は 1 を超える可能性があります。

次の例は、値の計算方法を示しています。
  • 1 分間の動画が 100 回視聴された場合、視聴者の半数が 15 秒後に視聴を停止し、残りの視聴者が動画全体を視聴します。どの視聴者も動画の一部を 2 回以上視聴していません。この場合、この指標の値は動画の最初の 25% の時間バケットでは 1 になり、動画の残りの部分では 0.50 になります。
  • 1 分間の動画が 100 回視聴された場合、すべての視聴者が動画全体を視聴しましたが、20 人の視聴者は動画の 45 秒目まで視聴してから、動画の 30 秒目まで戻って、残りの動画を視聴しました。この場合、動画の前半または最後の四半期の時間バケットでは、指標の値は 1 になります。ただし、動画の 3 分の 1 の時間バケットの値は 1.2 になります。このセグメントは視聴者の 100% が視聴しましたが、そのうちの 20% が 2 回視聴したためです。

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

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 回あたりの推定総収益額。