このドキュメントでは、YouTube Reporting API で取得する指標を定義します。この API は、チャンネルまたはコンテンツ所有者の YouTube アナリティクス データを含む一括データ レポートを取得します。
指標は、ユーザー アクティビティ、広告のパフォーマンス、推定収益を個別に測定するものです。ユーザー アクティビティの指標には、動画再生回数、評価(高評価と低評価)が含まれます。
主要な指標
YouTube Reporting API には利用規約で定義されている非推奨ポリシーが適用されますが、コアサービス以外の指標(およびコアサービス以外のディメンション)にはポリシーは適用されません。このページの定義では、主要な指標であるものはすべてそのように明示的に識別されます。
API の主な指標を以下に示します。YouTube アナリティクス API でも使用されるこれらの指標はすべて、その API の主要な指標でもあります。
annotation_click_through_rate
annotation_close_rate
average_view_duration_seconds
comments
dislikes
estimated_partner_revenue
likes
shares
subscribers_gained
subscribers_lost
views_percentage
views
watch_time_minutes
詳しくは、非推奨ポリシーが適用される 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 の再生リストから動画が削除された回数。動画が動画所有者の再生リストや他のチャンネルの再生リストから削除されている可能性があります。
指標の値は、「後で見る」再生リストなど、デフォルトの再生リストから動画が削除された回数を含みます。
この指標は、ユーザーが動画を追加した場合に再度カウントされます。この指標のデータは、2014 年 10 月 1 日より前のデータについてはご利用いただけません。
再生リストの統計情報
- 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
- カードのクリック率。カードのインプレッション数に対するカードのクリック数の比率として計算されます。
- カード ティーザーが表示された回数。1 回の動画の視聴で複数のティーザーが生成されることもあります。
- カード ティーザーのクリック数。カードアイコンのクリックは、最後に表示されたティーザーに関連付けられます。
- カード ティーザーのクリック率。カード ティーザーの合計表示回数に対してカード ティーザーがクリックされた割合として計算されます。
終了画面に関する指標
終了画面は動画の最後の 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 分間の動画が 100 回視聴されました。視聴者の半数は 15 秒後に視聴を止め、残りの視聴者は動画を最後まで視聴しました。その動画のどの部分をも 2 回以上視聴している視聴者はいません。この場合、この指標の値は、動画の最初の 1/4 のタイムバケットでは
1
になり、残りの動画では0.50
になります。 - 1 分間の動画が 100 回視聴されました。すべての視聴者が動画を最後まで視聴したが、40 秒の時点まで 20 人の視聴者が最後まで視聴してから 30 秒の時点まで視聴してから、残りの動画を視聴している。この場合、指標の値は、動画の前半または前四半期のタイムバケットの場合、
1
になります。ただし、動画の第 3 四半期のタイムバケットでは、1.2
- 1 分間の動画が 100 回視聴されました。視聴者の半数は 15 秒後に視聴を止め、残りの視聴者は動画を最後まで視聴しました。その動画のどの部分をも 2 回以上視聴している視聴者はいません。この場合、この指標の値は、動画の最初の 1/4 のタイムバケットでは
推定収益の指標
注: 推定収益の指標は月末に調整されます。パートナーが販売した広告とパートナー提供の広告は含まれません。推定収益額について詳しくは、YouTube ヘルプセンターをご覧ください。
- 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 回あたりの推定総収益。
- 広告表示回数
- 配信された確認済みの広告インプレッション数。
- estimated_monetized_playbacks
- 視聴者が動画を再生し、広告インプレッションを 1 回以上表示した回数。視聴者に対して、プレロール広告が表示されたが、動画が始まる前に広告の視聴を止めてしまった場合も、収益化の対象となる再生にカウントされます。この値の推定誤差は ±2.0% と想定されています。
- estimated_playback_based_cpm
- 再生 1,000 回あたりの推定総収益。