Metrics

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

指標は、ユーザーのアクション、広告のパフォーマンス、推定収益を個別に測定したものです。ユーザー アクティビティの指標には、動画の視聴回数や評価(高評価と低評価)などが含まれます。

主要な指標

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

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

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

指標を表示

engagedViews (コア指標)
チャンネルの動画が最初のフレームを超えて視聴された回数、またはユーザーがクリックまたはタップして再生した回数。
視聴回数(コア指標)
この指標は、レポートの種類によって異なる数値を表します。この指標には、複数のユーザーがテレビ画面で一緒に視聴した場合の共視聴が含まれます。 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.
dislikes (コア指標)
視聴者が [低評価] ボタンを押して動画に悪い評価を付けた回数。This is a core metric and is subject to the Deprecation Policy.
shares (コア指標)
ユーザーが 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 分間の動画が 100 回視聴された場合、視聴者の半数は 15 秒後に視聴を止め、残りの半数は動画を最後まで視聴しました。動画のどの部分も、2 回以上視聴した視聴者はいません。この場合、この指標の値は、動画の最初の 4 分の 1 の時間バケットでは 1 になり、動画の残りの部分では 0.50 になります。
  • 1 分間の動画が 100 回視聴された場合、すべての視聴者が動画を最後まで視聴しましたが、20 人の視聴者は動画の 45 秒の時点まで視聴した後、30 秒の時点まで戻ってから、動画の残りの部分を視聴しました。この場合、動画の前半または最後の 4 分の 1 の時間バケットでは、指標の値は 1 になります。ただし、動画の第 3 四半期の時間バケットの値は 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 分であるとします。このレポートでは、動画は 100 個の 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 回あたりの推定総収益。