Metrics

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

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

主要な指標

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

次のリストに、API のコア指標を示します。

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

指標を表示

engagedViews （コア指標）
動画が 4 秒以上視聴された回数。
視聴回数 （コア指標）
この指標は、レポートの種類によって異なる数値を表します。 This is a core metric and is subject to the Deprecation Policy.
playlistViews
この指標は、再生リストの指標セクションで定義されています。
redViews
YouTube Premium（旧称: YouTube Red）メンバーが動画を視聴した回数。
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 日より前の日付ではご利用いただけません。

再生リストの統計情報

再生リスト レポートには、視聴者が再生リスト内の動画をどのように操作しているかを示す 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
カード ティーザーが表示された回数。1 回の動画視聴で複数のティーザーのインプレッションが発生することがあります。
cardTeaserClicks
カード ティーザーのクリック数。カードアイコンに対するクリックは、ユーザーに最後に表示されたティーザーをクリックしたものとしてカウントされます。
cardTeaserClickRate
カード ティーザーのクリック率。カード ティーザーのクリック数をカード ティーザーの合計インプレッション数で割った値です。

ライブ配信の指標（同時視聴者数）

averageConcurrentViewers
特定の動画の平均同時視聴者数。レポートに livestreamPosition ディメンションが指定されている場合、averageConcurrentViewers 値には特定のセグメントでの同時視聴者数の平均数を指定します
peakConcurrentViewers
特定の動画のピーク時の同時視聴者数。レポートに livestreamPosition ディメンションが指定されている場合、peakConcurrentViewers 値には動画の特定のセグメントでの最大同時視聴者数を指定します。

視聴者維持に関する指標

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

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

次の例は、値の計算方法を示しています。
  • 1 分間の動画が 100 回視聴された場合、視聴者の半数が 15 秒後に視聴を停止し、残りの半数が動画全体を視聴します。どの視聴者も動画の一部を 2 回以上視聴していません。この場合、この指標の値は動画の最初の 25% の時間バケットでは 1 になり、動画の残りの部分では 0.50 になります。
  • 1 分間の動画が 100 回視聴された場合、すべての視聴者が動画全体を視聴しましたが、20 人の視聴者は動画の 45 秒目まで視聴してから、動画の 30 秒目まで戻って、残りの動画を視聴しました。この場合、動画の前半または最後の四半期の時間バケットでは、指標の値は 1 になります。ただし、動画の 3 分の 1 の時間バケットの値は 1.2 になります。このセグメントは視聴者の 100% が視聴しましたが、そのうちの 20% が 2 回視聴したためです。
relativeRetentionPerformance
長さが同程度の他の YouTube 動画と比較して、動画の再生中に視聴者の注目をどれだけ維持できたかを示す指標です。この指標の値は 0～1 の範囲で、動画の特定の時点での動画の相対的な維持率のパフォーマンスを示します。動画内のポイントは elapsedVideoTimeRatio ディメンションで指定します。

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

次の架空の例は、値がレポートにどのように表示されるかを示しています。平均して、10 分間の動画を視聴した視聴者の 90% は 3 分後も視聴を継続し、70% は 8 分後も視聴を継続しています。一方、特定の 10 分間の動画では、3 分後に視聴を継続している視聴者は 80% のみですが、8 分後に視聴を継続している視聴者は全員です。
  • 動画の 3 分目のポイントに対応する elapsedVideoTimeRatio 値では、relativeRetentionPerformance 指標の値は 0.5 未満になります。この時点では、動画のパフォーマンスは平均的な動画よりも低いためです。
  • 動画の 8 分目に対応する elapsedVideoTimeRatio 値では、relativeRetentionPerformance 指標の値は 0.5 よりも高くなります。これは、その時点で動画のパフォーマンスが、同程度の長さの他の動画よりも優れているためです。
startedWatching
動画の特定のセグメントが動画再生中に最初に視聴された回数。

たとえば、動画 X の長さが 5 分であるとします。このレポートでは、動画は 3 秒のセグメントに分割され、elapsedVideoTimeRatio ディメンションで識別されます。視聴者が YouTube にアクセスし、動画の最初の 1 分 10 秒（動画の最初の 24 セグメントの一部またはすべてを含む）を視聴します。視聴者が YouTube に再度アクセスしたときに、動画の残りの部分を視聴し、セグメント 24 で再生を再開してセグメント 100 まで視聴します。

この例では、次のウォッチ指標値が生成されます。
  • startedWatching 指標の値は、セグメント 1 と 24 では 1 になり、他のすべてのセグメントでは 0 になります。
  • stoppedWatching 指標の値は、セグメント 24 と 100 では 1 になり、他のすべてのセグメントでは 0 になります。
  • totalSegmentImpressions 指標の値は、セグメント 24 では 2 で、他のすべてのセグメントでは 1 です。
stoppedWatching
動画の特定のセグメントが動画再生中に最後に視聴された回数。この指標値の計算方法の例については、startedWatching 指標の定義をご覧ください。
totalSegmentImpressions
動画の特定のセグメントが視聴された回数。この指標値の計算方法の例については、startedWatching 指標の定義をご覧ください。視聴者は、同じ再生中に動画の同じセグメントを複数回視聴できます。

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

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

推定収益指標

注: 推定収益の指標は月末に調整され、パートナーが販売または配信した広告は含まれません。推定収益額について詳しくは、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 回あたりの推定総収益額。