FAQ: Analytics モジュール
全般
1. Analytics モジュールとは何ですか？
Analytics モジュールは、動画およびプレーヤーに関するほぼリアルタイムの分析情報を表示できるユーザーインターフェースです。Analytics プラットフォームは最新のビッグデータ技術を活用して大規模なスケールに対応するよう設計されており、高速かつほぼリアルタイムで分析データにアクセス可能です。また、Video Cloud Studio に含まれるレポートに加えて、開発者が独自の分析ソリューションやレポートを作成できる強力なオープン API も備えています。
2. Analytics モジュールからレポートデータをエクスポートできますか？
はい。Analytics レポートには、レポートデータを .csv および .xlsx ファイルとしてダウンロードできるリンクがあります。
3. Analytics モジュールのデータはどのくらいの頻度で更新されますか？
通常、ほぼリアルタイムのデータには約 3〜4 時間の遅延があります。ただし、これは現在データ収集システムが処理しているデータ量によって変動する場合があります。
Analytics システムは複数のソースからデータを収集しており、ほぼリアルタイムのデータはこれまでに収集された情報に基づく推定値です。レポートごとに数値が異なる場合があるため、正確な数値というよりも傾向として見ることを推奨します。
4. Analytics モジュールで提供される標準レポートをカスタマイズできますか？
パフォーマンスおよびエンゲージメントレポートに表示されるデータはカスタマイズできません。ただし、Analytics モジュールでは表示するデータを選択できるカスタムレポートの作成が可能です。また、分析データにプログラム的にアクセスするための Analytics API も提供されています。
利用可能なデータ
5. 社内の動画IDをレポートや API に含める方法はありますか？
動画プロパティとして利用可能な参照 ID フィールドを使用して、社内IDを Video Cloud 上の動画と関連付けることができます。この参照 ID フィールドはカスタムレポート作成時に表示可能です。カスタムレポートについての詳細は、Analytics モジュールでのカスタム分析レポートの作成をご覧ください。
6. 特定の動画の視聴維持率や離脱率をレポートできますか？
この情報はエンゲージメント レポートで確認できます。エンゲージメント レポートを選択し、ディメンションとして「動画」を選ぶと、アカウント全体の視聴維持率を示すグラフが表示されます。特定の動画を選択すると、その動画の視聴維持率の推移が表示されます。
7. URL単位でのパフォーマンス比較は可能ですか？例えば、同じ動画が Page A と Page B でホストされている場合に比較できますか？
はい。パフォーマンスレポートでは、表示ドメイン別に動画分析を見ることができます。
8. アカウントのユニーク視聴者数を表示するレポートはありますか？
ユニーク視聴者数は、パフォーマンスレポートで確認できます。
9. 削除された動画の分析データは含まれますか？
Analytics レポートには、アカウントから削除された動画の分析データも含まれます。ただし、削除済み動画を Analytics モジュール内で検索してレポートを確認することはできません。削除された動画のレポートを取得するには、該当動画の動画ID を把握しておく必要があり、そのIDを使用して Analytics API からレポートを生成します。なお、レポートデータをエクスポートした場合、削除された動画の一部メタデータが欠けていることがあります。
10. 分析データの最も古い取得可能日はいつですか？
分析データの取得可能な最も古い日付は、2010年12月28日です。ただし、すべてのデータ項目がこの日付から収集されているわけではないため、表示可能な最も古い日付は、確認するデータの種類によって異なります。動画再生回数については、2010年12月28日から取得可能です。カレンダー コントロールを使用して日付を遡る場合は2013年1月までですが、それ以前の日付も手動入力で指定できます。
11. ライブイベント配信のプレーヤーも分析の対象になりますか？
Analytics では、パフォーマンス レポートの一部として視聴された分数をトラッキングします。ライブ再生の秒数は、カスタムレポート作成時や請求モジュールで表示できます。ただし、ライブイベントの帯域幅は表示されません。
データのフィルタリング
12. IPアドレスの範囲を分析対象から除外することは可能ですか？
現在のところ、IPアドレス範囲を除外する機能は提供されていません。
13. 従業員による視聴を分析から除外できますか？
これを簡単に行う方法はありません。また、トラフィックの多い動画の場合、従業員の視聴はごく一部に過ぎないため、分析への影響はごくわずかです。ただし、トラフィックが少なく除外が重要と考える場合は、実運用用のプレーヤーを複製し、従業員には複製版で視聴・テストを行わせるのが最も簡単な方法です。そのうえで、Analytics モジュールのカスタム レポート機能や Analytics API を使い、本番プレーヤーのデータのみを対象とするレポートを作成することが可能です。
検索
14. Analytics モジュールで特定の動画情報を検索するには？
検索機能を使用して特定の動画を検索できます。動画名、短い説明、長い説明、タグ、動画ID、参照ID、およびカスタムテキストフィールドが検索対象になります。検索結果をクリックすると、その動画のパフォーマンスまたはエンゲージメント情報が表示されます。カスタム レポートを作成して、特定の動画ID の分析データを表示することもできます。
15. Analytics モジュールで参照ID を使って動画を検索できますか？
はい。検索機能を使用して、参照ID フィールドを基に動画を検索できます。動画名、短い説明、長い説明、タグ、動画ID、およびカスタムテキストフィールドも検索対象になります。
データの理解
16. 動画の前にプレロール広告が表示され、視聴者が数秒間広告を視聴して離脱した場合、メインコンテンツを視聴していないと動画再生としてカウントされますか？
いいえ。動画再生としてカウントされるのは、メイン コンテンツが再生された後です。
17. 動画がループ再生されている場合、1回の再生としてカウントされますか？それとも再生のたびに複数回カウントされますか？
動画再生数は、1つの視聴セッションにつき1回のみカウントされます。ただし、エンゲージメントレポートの x%時点の視聴数 と、パフォーマンスレポートの 動画再生数 は同じではありません。動画再生数は最初に動画が再生された時点でカウントされ、1% 時点の視聴数は最初の1%が視聴された際に記録されます。動画が自動リプレイ設定されている場合など、1% が複数回視聴された場合はカウントが増加しますが、動画再生数は最初の再生時のみカウントされ、再生ページを再読み込みしたり、別の動画を視聴した場合を除き、リプレイではカウントされません。
18. なぜ一部のエンゲージメントスコアが 100 を超えるほど高いのですか？
エンゲージメントスコアが 100 を超えることもあります。スクラブや再視聴は新たな video_view イベントを発生させませんが、video_engagement は追跡されます。以下のような事例で、エンゲージメントが大きく変化する可能性があります：
- まだ再生されていない。エンゲージメントスコア：0。
- 視聴者がページを読み込み、動画を最後まで視聴。スコア：100（100％ 再生／1再生）。
- 同じ視聴者が巻き戻して再び最後まで視聴（ブラウザは再読み込みされていない）。スコア：200（200％ 再生／1再生）。
- 別の視聴者がページを読み込み、最後まで視聴。スコア：150（300％ 再生／2再生）。
エンゲージメントスコアの算出方法については、トレーニング動画 動画エンゲージメントの計算 をご覧ください。
19. なぜ 25% 時点の視聴数が 1% 時点の視聴数より多いのですか？
この 2 つの数値に差が出る理由はいくつかあります：
- 1% 時点と x% 時点の視聴数は異なる指標です。1% 時点の視聴数は各視聴セッションごとにユニークであり、巻き戻しやリプレイは含まれません。視聴者が動画を巻き戻したり再生し直した場合、%時点のカウントは増えますが、動画再生数には反映されません。
- %時点の視聴数およびエンゲージメントカーブは UTC 時間で日次単位で保存されているため、UTC とレポートのタイムゾーンが重なると、特定の日付に 2日分のデータが含まれる場合があります。
20. なぜ同じ日の動画再生数が時間と共に変わることがあるのですか？
Analytics システムは、毎時収集された暫定的な指標を提供し、日次レベルで報告される実データと自動的に照合します。この処理は通常 3〜5 日以内に行われます。毎時データは照合されませんが、パブリッシャーが毎時データを重視するため、32 日間は暫定データが利用可能です。照合の詳細は以下の通りです：
- プレーヤーがデータを Data Collection API に送信
- Data Collection API はリアルタイム データベースへの書き込みを試みつつ、イベントをログに保存
- CDN やその他のソースからの追加データを収集し、分析データを更新（これが照合作業）
- 毎晩、バッチ処理でログイベントから履歴データを構築
- 履歴データは履歴データベースにロードされ、API 呼び出し時に
reconciledパラメータを使って照合済みのみ、または両方のデータを選択可能。詳しくはAnalytics API 概要をご覧ください。 - すべての履歴データは照合済みですが、32日以内のリアルタイムデータは照合済みでない場合があります。取得対象期間が 32日以上前であれば、照合済みデータのみを使用してください。
21. 一部の指標が null または空になるのはなぜですか？
リクエストした期間に該当の指標が存在しない場合、この現象が起こります。一部の指標は 2〜3日の遅延があるため、直近 30日間（今日を含む）でリクエストした場合、まだ集計されていない日が含まれる可能性があります。この問題を避けるには、遅延期間を除いた範囲でデータをリクエストしてください。
また、時間の経過とともに新しい指標やディメンションの組み合わせが追加されています。たとえば、複数年にわたるレポートでは、追跡が開始される前の期間に該当する指標が空または部分的である可能性があります。有効な日付とディメンションの組み合わせについては、Analytics API 概要をご覧ください。
22. なぜ 2013 年の配信先ドメインデータが他のパフォーマンスデータと一致しないのですか？
配信先ドメイン機能は 2014年 1月 まで有効化されていませんでした。2013年3月〜2014年1月 のデータは一部のみ補完されており、この期間のデータは一部のみ利用可能です。2014年1月 以降のデータは完全です。
23. なぜエンゲージメント値が小数で表示されることがあるのですか？
エンゲージメントは正規化された値であるため、小数点以下で表示されることがあります。これは「video_percent_viewed * (video_engagement_25 / video_engagement_sum)」の比率で計算されており、リクエストした期間によっては割り切れず、小数になる場合があります。
24. なぜ一部のレポートには動画ID だけが表示される、または動画が全く表示されないのですか？
該当期間中に再生がなかった動画については、レポートには詳細情報が表示されません（例：動画ID のみ）。データ（画像など）自体が取得されていない場合、その動画はレポートに表示されません。
25. 同一期間で、Analytics モジュールと Analytics API のデータは一致しますか？
はい。ただし、比較対象のデータが比較的新しい場合や、Studio と API で取得したタイミングが異なる場合は差異が生じることがあります：
- データが 3日未満の場合：この期間のデータは暫定値であり、変更される可能性があります。
- 32日未満のデータと 32日を超えたデータを比較した場合：32日を過ぎるとデータは履歴用ストレージに移行され、一部の詳細データ（特にエンゲージメントデータ）が削除されます。これにより、エンゲージメントスコアなどの計算結果が若干変化することがあります。
26. なぜ Analytics モジュールでの動画再生数が、Campaign モジュールでの再生数より多いのですか？
Analytics モジュールと Campaign モジュールは別システムであり、それぞれ異なる用途に基づいてデータを収集しているため、再生イベントの数が一致しないことがあります。
Campaign のリードフォームは video_view イベントが発生しないと表示されません。このイベントはユーザーが「再生」ボタンを手動でクリックした際に発生するため、実際に動画が再生されていないように見えても、Analytics モジュールには video_view が記録される場合があります。
Analytics モジュールでの再生数が Campaign モジュールより多い場合、リードフォームは表示されたがユーザーが入力せず再生が継続されなかった可能性があります。
27. 変速再生を使用した場合、video_seconds_viewed はどのように収集・計算されますか？
video_seconds_viewed は再生位置に基づいており、変速再生は反映されません。例えば、動画を倍速で 30秒間再生した場合、video_seconds_viewed は 30 として記録されます。
28. なぜ Analytics トラフィックレポートで iframe タグのトラフィックが「Direct」として報告されるのですか？
トラフィックソースは HTTP リファラーヘッダーに基づいて判断されます。iframe タグを使用した場合、HTTP リファラーは "players.brightcove.net/..." となり、Analytics モジュールでは「Direct（直接）」として分類されます。
正確なトラフィックソースを取得するには、Videoタグをご使用ください。