Metrics

このドキュメントでは、YouTube Analytics API を使用して取得できる指標を定義します。この API は、カスタム YouTube アナリティクス レポートを生成するリアルタイム クエリをサポートしています。

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

主要な指標

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

以下のリストは、API のコア指標を示しています。

注: 次の主要指標のサポートは完全に終了しました。
  • コア指標 earnings は 2016 年 8 月 4 日に非推奨となり、名前が estimatedRevenue に変更されました。利用規約で定義されている非推奨ポリシーに基づき、earnings 指標と estimatedRevenue 指標は 2017 年 8 月 10 日まで同時にサポートされていました。
  • favoritesAddedfavoritesRemoved の主な指標は 2015 年 3 月 31 日に非推奨となりました。これらの指標は YouTube Analytics API でのみ取得できます。

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

指標を表示

視聴回数 (コア指標)
この指標は、レポートのタイプによって異なる数値を表します。
  • 動画レポートの場合、この指標は動画が視聴された回数を示します。
  • isCurated ディメンションを使用しない再生リスト レポートでは、この指標は再生リスト内の動画の合計視聴回数を示します。これらの視聴回数が再生リスト内で発生したかどうかは関係ありません。指標の値には、チャンネル所有者の動画の視聴回数のみが含まれます。

    これらのレポートの playlistViews 指標は、再生リストの動画が特定の再生リストに関連して視聴された回数を示します。
  • isCurated ディメンションを使用する再生リストレポートの場合、この指標は、動画が特定の再生リストに関連して視聴された回数を示します。なお、playlistViews 指標はこれらのレポートではサポートされていません。
This is a core metric and is subject to the Deprecation Policy.
playlistViews
この指標は、再生リストの指標セクションで定義されています。
redViews
YouTube Premium(旧称 YouTube Red)メンバーが動画を視聴した回数。
(2016 年 9 月 27 日をもってサポート終了)
動画を視聴したユニーク視聴者の数。この計算はユニーク Cookie の数に基づいているため、複数のデバイスやブラウザを使用しているユーザーが重複してカウントされます。
uniques 指標は 2016 年 9 月 27 日をもって非推奨となりました。主要な指標ではなく、2016 年 10 月 31 日までサポートされます。
viewerPercentage (コア指標)
動画または再生リストの視聴中にログインした視聴者の割合。This is a core metric and is subject to the Deprecation Policy.

総再生時間に関する指標

estimatedMinutesWatched (コア指標)
指定したチャンネル、コンテンツ所有者、動画、または再生リストの動画をユーザーが視聴した時間(分)。This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
YouTube Premium(旧称 YouTube Red)メンバーが動画を視聴した時間(分)。
averageViewDuration (コア指標)
動画の平均再生時間(秒単位)。2021 年 12 月 13 日現在、この指標にはループ クリップのトラフィックは含まれません。再生リスト レポートの指標は、再生リスト内で発生した動画再生の平均時間(秒単位)を示します。This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
動画の再生中に視聴された動画の平均割合(%)。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.
subscribersGained (コア指標)
ユーザーがチャンネルに登録した回数。This is a core metric and is subject to the Deprecation Policy.

チャンネルの登録者数の増減は、動画再生ページ、チャンネル ページ、YouTube ホームページに表示されるガイドなど、さまざまな場所で発生します。 チャンネル レポートのこの指標には、これらすべての登録数が含まれます。ただし、video ディメンションまたは filter パラメータを使用して、特定の動画のデータのみが含まれるようにレスポンスを制限しているレポートでは、subscribersGained 指標に含まれるのは指定した動画再生ページの統計情報のみになります。
subscribersLost (コア指標)
ユーザーがチャンネル登録を解除した回数。This is a core metric and is subject to the Deprecation Policy.

この指標のデータは、subscribersGained 指標と同様にレポートされます。 チャンネル レポートのこの統計情報には、何らかの手段で解除されたチャンネル登録数が含まれます。ただし、video ディメンションまたは filter パラメータを使用して、特定の動画のデータのみが含まれるようにレスポンスを制限しているレポートの場合、この指標には、指定した動画の再生ページから登録を解除したユーザーのみが含まれます。
videosAddedToPlaylists
YouTube 再生リストに動画が追加された回数。動画は、動画の所有者の再生リストまたは他のチャンネルの再生リストに追加されている可能性があります。

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

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

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

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

サポートが終了したエンゲージメント指標

次の指標はいずれも、2015 年 3 月 31 日にサポートが終了した主要指標です。

favoritesAdded (コア指標)2015 年 3 月 31 日に非推奨)
ユーザーが動画をお気に入りに追加した回数。詳しくは、YouTube ヘルプセンターをご覧ください。This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (コア指標)2015 年 3 月 31 日に非推奨)
ユーザーがお気に入りの動画リストから動画を削除した回数。詳しくは、YouTube ヘルプセンターをご覧ください。This is a core metric and is subject to the Deprecation Policy.

再生リストの統計情報

再生リストレポートには、再生リスト内の動画に対する視聴者の反応を示す 2 種類の指標が含まれます。

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

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

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

以下に示す指標のほとんどは再生リスト内の指標です。リスト内の残りの指標(playlistSaves 指標など)は、再生リスト内の動画に対するユーザー インタラクションではなく、再生リスト自体に対するユーザー インタラクションに関するものです。したがって、これらの指標は、集約された動画に関する指標や再生リスト内の指標のいずれにもなりません。

averageTimeInPlaylist
再生リストが開始された後に視聴者が再生リスト内の動画を視聴したと推定される平均時間(分単位)。この指標には、ウェブで発生した再生リストの視聴回数のみが含まれます。
playlistAverageViewDuration
再生リストの 1 回の視聴あたりの推定平均再生時間(秒単位)。なお、この指標は再生リスト内の個々の動画の平均視聴時間を表します。これに対して averageTimeInPlaylist 指標は、各視聴者が再生リスト全体を視聴した平均時間を表します。この指標には、他のチャンネルが所有する再生リスト動画のデータも含まれます。
playlistEstimatedMinutesWatched
ユーザーが再生リストのコンテンツを再生リストの一部として視聴した時間(分)。それ以外のコンテキストでの総再生時間(視聴者が他の再生リストの一部として同じ動画を視聴しているときに発生した視聴による総再生時間など)はカウントされません。この指標には、他のチャンネルが所有する再生リスト動画のデータも含まれます。
playlistSaves
ユーザーが再生リストを保存した正味の回数。保存した再生リストについて詳しくは、YouTube ヘルプセンターをご覧ください。この指標は正味の変更番号を返します。つまり、ユーザーが再生リストを保存し、その再生リストを保存済み再生リストのリストから削除して再度保存した場合、指標値には 1 つの再生リストの保存が追加されたことが反映されます。
playlistStarts
視聴者が再生リストの再生を開始した回数。この指標には、ウェブで発生した再生リストの視聴回数のみが含まれます。
playlistViews
再生リスト内の動画が、その再生リストのコンテキストで視聴された回数。 この指標には、他のチャンネルが所有する再生リスト動画のデータも含まれます。
viewsPerPlaylistStart
再生リストが再生されるたびに発生した動画の平均視聴回数。この指標に含まれるのは、ウェブで発生した再生リストの視聴回数のみです。

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

注: YouTube Analytics API レポートは、2012 年 6 月 10 日時点での annotationClickThroughRate 指標と annotationCloseRate 指標のデータのみを返します。また、YouTube Analytics API レポートでは、2013 年 7 月 16 日時点での残りのアノテーション指標のデータのみが返されます。

annotationImpressions
アノテーションの合計インプレッション数。
annotationClickableImpressions
表示されたアノテーションのうち、クリック可能だったものの数。
annotationClicks
クリックされたアノテーションの数。
annotationClickThroughRate (コア指標)
クリック可能なアノテーションの合計インプレッション数のうち、視聴者がクリックしたアノテーションの割合。This is a core metric and is subject to the Deprecation Policy.アノテーションの作成リンク アノテーションの使用について詳しくは、YouTube ヘルプセンターをご覧ください。
annotationClosableImpressions
表示され、閉じることができるアノテーションの数。
annotationCloses
閉じたアノテーションの数。
annotationCloseRate (コア指標)
アノテーションの合計インプレッション数のうち、視聴者が閉じたアノテーションの割合。This is a core metric and is subject to the Deprecation Policy.

カードの指標

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

cardImpressions
カードが表示された回数。カードパネルが開かれると、動画のカードごとにカードの表示回数が記録されます。
cardClicks
カードがクリックされた回数。
cardClickRate
カードのクリック率。カードの表示回数に対するカードのクリック数の割合として計算されます。
cardTeaserImpressions
カード ティーザーが表示された回数。動画の視聴により、ティーザーのインプレッションが複数回発生することがあります。
cardTeaserClicks
カード ティーザーのクリック数。カードアイコンのクリックは、ユーザーに最後に表示されたティーザーに関連付けられます。
cardTeaserClickRate
カード ティーザーのクリック率。カード ティーザーの表示回数の合計に対する、カード ティーザーのクリック数の割合として計算されます。

視聴者維持に関する指標

audienceWatchRatio
動画内の任意の時点で動画を見ている視聴者の絶対比率。この比率は、動画の一部が視聴された回数と、動画の合計視聴回数を比較して算出されます。elapsedVideoTimeRatio ディメンションは、指標が対応する動画の部分を示します。

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

次の例は、値の計算方法を示しています。
  • 1 分間の動画を 100 回視聴した場合。視聴者の半数が 15 秒後に視聴をやめ、残りの視聴者が動画を最後まで視聴した。どの視聴者にも、動画のどの部分も 1 回以上視聴していない。この場合、動画の最初の 4 分の 1 の時間バケットではこの指標の値は 1 になり、動画の残りの部分では値が 0.50 になります。
  • 1 分間の動画を 100 回視聴した場合。すべての視聴者が動画を最後まで視聴しますが、20 人の視聴者が動画の 45 秒のマークまで視聴し、その後 30 秒のマークまでスキップして動画の残りの部分を見ています。この場合、動画の最初の半分または最後の四半期のいずれかの時間バケットの指標の値は 1 になります。ただし、動画の第 3 四半期の時間バケットの値は 1.2 になります。これは、視聴者の 100% がそのセグメントを視聴したものの、20% の視聴者がセグメントを 2 回視聴しているためです。
relativeRetentionPerformance
長さが同程度の他の YouTube 動画と比べ、動画の再生中に視聴者をどの程度維持できているかを示す指標。この指標の値は 01 で、動画内の任意の時点における相対的な維持率を示します。動画内のポイントは elapsedVideoTimeRatio ディメンションで指定されます。

値が 0 の場合、その動画の視聴者維持率は同程度の他の動画よりも低いことを示し、1 の値は、長さが同程度の他の動画よりも視聴者維持率が高いことを示します。中央値が 0.5 の場合、長さが同程度の動画の半分は視聴者の維持率が高く、残りの半分の動画の維持率が低いことを示しています。

次の架空の例は、レポートに値がどのように表示されるかを示しています。平均すると、10 分の長さの動画を視聴した視聴者の 90% は 3 分後もまだ視聴しており、70% は 8 分後もまだ視聴しています。しかし、ある 10 分間の動画の場合、3 分経っても視聴を続けている視聴者は 80% にとどまっていますが、8 分経過した後も視聴を続けている視聴者の割合は 80% に上ります。
  • 動画から 3 分経過した時点に対応する elapsedVideoTimeRatio 値では、relativeRetentionPerformance 指標の値は 0.5 未満になります。これは、その時点で動画のパフォーマンスが平均的な動画よりも低いためです。
  • 動画から 8 分経過した時点に対応する elapsedVideoTimeRatio 値では、relativeRetentionPerformance 指標は 0.5 よりも大きくなります。これは、その時点で動画のパフォーマンスが同程度の他の動画よりも優れているためです。

推定収益の指標

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

デフォルトでは、すべての推定収益は米ドルで表示されます。ただし、YouTube Analytics API では、一部の推定収益と広告パフォーマンスの指標で currency パラメータがサポートされているため、他の通貨で推定収益データを取得できます。
estimatedRevenue (コア指標) (旧称 earnings
選択した期間と地域における、すべての Google 広告ソースと広告以外のソースからの推定純収益の合計。 This is a core metric and is subject to the Deprecation Policy.

推定収益の指標は月末に調整される可能性があります。また、パートナーが販売する広告とパートナーが配信する広告は含まれません。
estimatedAdRevenue (旧 adEarnings
選択した期間と地域におけるすべての Google 広告ソースからの推定純収益の合計。

推定収益の指標は月末に調整される可能性があり、パートナーが販売する広告とパートナーが配信する広告は含まれません。
estimatedRedPartnerRevenue(旧 redPartnerRevenue
選択したレポートのディメンションで YouTube Premium(旧称 YouTube Red)の定期購入から得られる推定収益の合計額。指標の値は音楽コンテンツと音楽以外のコンテンツの両方からの収益を反映しており、月末に調整される場合があります。

広告の掲載結果に関する指標

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