Metrics

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

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

主要な指標

YouTube Reporting API には利用規約に定められているサポート終了ポリシーが適用されますが、主要指標以外の指標（およびコア以外のディメンション）にはこのポリシーは適用されません。このページの定義では、コア指標であるすべての指標が明確に示されています。

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

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

指標を表示

視聴回数 （コア指標）
動画が視聴された回数。再生リスト レポートの指標は、動画が再生リスト内で視聴された回数を示します。視聴回数のレポート方法に関する追加情報については、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
カード ティーザーが表示された回数。動画の視聴により、ティーザーのインプレッションが複数回発生することがあります。
card_teaser_clicks
カード ティーザーのクリック数。カードアイコンのクリックは、ユーザーに最後に表示されたティーザーに関連付けられます。
card_teaser_click_rate
カード ティーザーのクリック率。カード ティーザーの表示回数の合計に対する、カード ティーザーのクリック数の割合として計算されます。

終了画面の指標

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

注: 終了画面に関する指標のデータは、2016 年 5 月 1 日以降のものです。

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 秒後に視聴をやめ、残りの視聴者が動画を最後まで視聴した。どの視聴者にも、動画のどの部分も 1 回以上視聴していない。この場合、動画の最初の 4 分の 1 の時間バケットではこの指標の値は 1 になり、動画の残りの部分では値が 0.50 になります。
  • 1 分間の動画を 100 回視聴した場合。すべての視聴者が動画を最後まで視聴しますが、20 人の視聴者が動画の 45 秒のマークまで視聴し、その後 30 秒のマークまでスキップして動画の残りの部分を見ています。この場合、動画の最初の半分または最後の四半期のいずれかの時間バケットの指標の値は 1 になります。ただし、動画の第 3 四半期の時間バケットの値は 1.2 になります。これは、視聴者の 100% がそのセグメントを視聴したものの、20% の視聴者がセグメントを 2 回視聴しているためです。

推定収益の指標

注: 推定収益の指標は月末に調整される場合があります。パートナーが販売する広告とパートナーが配信する広告は含まれません。推定収益額に関する詳しい情報や注意事項については、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_sense_revenue （YouTube Reporting API でのみサポート）
選択した期間と地域でのオークションで販売された AdSense 広告からの合計推定収益額（純収益）。
estimated_partner_ad_reserved_revenue （YouTube Reporting API でのみサポート）
DoubleClick（DCLK）とその他の YouTube 経由販売の予約販売広告による推定収益額（純収益）。この指標は、以前は estimated_partner_double_click_revenue という名前でした。
estimated_partner_double_click_revenue （YouTube Reporting API でのみサポート）
DoubleClick（DCLK）およびその他の YouTube 販売ソースからの予約販売広告による合計推定収益額（純収益）。
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 回あたりの推定総収益。