ストリーミングメディアイベント

ストリーミングメディアトラッキングは、一連のイベント呼び出しをAdobe データコレクションエンドポイントに送信することで機能します。各エンドポイントは、プレーヤーのステートの遷移を表します。 すべてのイベントは、​ セッション開始呼び出しによって開かれたアクティブなセッションに属します。 セッションは、有効期限を過ぎると自動的に閉じるか、​ セッション終了呼び出しですぐに閉じることができます。

イベントは6つのカテゴリー（セッション、再生、広告、チャプター、プレイヤーの状態、品質）に分類され、それぞれメディア体験の明確な側面をカバーします。

セッションイベント

セッションイベントは、ビデオオンデマンド、ライブストリーム、ポッドキャスト、オーディオブックなど、あらゆるタイプのメディアトラッキングに適用されます。 トラッキングセッション自体の境界を定義します。 最も重要なセッションイベントは​ セッション開始です。他のほぼすべてのイベントタイプは、生成されるセッション IDに依存しています。 ユーザーがセッションを開始する際の最初のイベントとして送信します。例えば、再生を押した場合や、プレーヤーが自動再生を開始した場合などです。

セッションを開いたら、​ セッション完了または​ セッション終了を使用して、視聴エクスペリエンスがどのように終了したかを示します。 視聴者がコンテンツの自然な終わりに到達すると、セッションが完了します。ビデオが終了するか、ポッドキャストのエピソードが終了するか、オーディオブックの最終章が終了します。 セッション完了はセッションを閉じません。セッションが自然に期限切れになるまで開いたままなので、最後のpingなどの後続イベントは引き続きキャプチャされます。

ビューアが終了する前に離脱した場合は、​ セッション終了を送信して、セッションをすぐに閉じます。 追加のイベントが続かない場合（プレーヤーが破壊されたり、ページがアンロードされたりなど）にのみセッション終了を送信します。 セッション終了はハードクローズです。送信されると、セッションは終了し、それ以降のイベントは追跡できません。 ほとんどの場合、セッションの有効期限が自然に切れるようにした方が安全です。 例えば、ビューアが無期限に一時停止したり、アプリがバックグラウンドに移動したり、コンテンツの読み込みに失敗したりします。

10分間イベントを受信しなかった場合、または再生ヘッドの動きが30分間検出されなかった場合、セッションは自動的に期限切れになります。 いずれかの条件が満たされ、ビューアがコンテンツに戻った場合は、セッション開始を再度呼び出して新しいセッションを開いてから、イベントを送信する必要があります。

再生イベント

再生イベントは、セッション全体を通してメディアプレーヤーの状態の遷移を追跡します。 イベントストリームの中心を形成し、あらゆるコンテンツタイプに適用されます。

主な再生イベントはPlayです。 Session startを呼び出した後、Playはコンテンツの再生が開始されたことを示します。つまり、最初の開始、自動再生、または再生トリガーへの復帰です。 開始を一時停止すると、ユーザーが再生を一時停止したことを示します。 専用の再開イベントはありません。ビューアが再開したら、再度再生を送信します。 バッファリングが停止した後も、再生は同じように機能します。プレーヤーがデータ待ちで停止した場合は​ バッファリング開始を送信し、バッファリングが解決した場合は「再生」を実行します。

メインコンテンツの再生中は10秒ごとにPingを送信し、広告の再生中は1秒ごとに送信します。 Pingはセッションを維持し、再生ヘッドの動きを記録します。 Mobile SDKでは、pingは自動的に送信されます。他のすべてのプラットフォームでは、pingは手動で送信する必要があります。

プレーヤーのアダプティブビットレートアルゴリズムが異なる品質レベルに切り替わるたびに​ ビットレート変更を送信します。 QoE データに新しいビットレート値を含めると、平均ビットレートのレポートが可能になります。

広告イベント

広告イベントは、メディアセッション内の広告を追跡します。 一般的なシナリオには、動画の開始前にプリロール広告、長編の動画またはライブストリーム中に間隔を置いて挿入されるミッドロール広告、コンテンツの終了後にポストロール広告などがあります。 1つの広告ブレークには、1つまたは複数の個別の広告を含めることができます。

どの広告枠も同じ構造になります。 Ad break startがブレークを開き、Ad break completeがブレークを閉じます。 これらの2つのイベントは、個々の広告イベントをすべてラップするブックエンドの役割を果たします。 休憩時間内に、個々の広告の再生が開始されたときにAd startを送信します。 広告が完全な長さで再生される場合はAd completeで、視聴者がスキップボタンを選択した場合はAd skipでフォローします。 いずれかのブックエンドを省略すると、ブレーク内のすべての広告イベントが無視され、広告期間がメインコンテンツに誤って関連付けられます。

次の例は、3つの広告を含む1つの広告ブレークの正しいイベントシーケンスを示しています。視聴者は3つ目をスキップしました。

チャプターイベント

チャプターイベントはオプションであり、セッション内の名前付きコンテンツセグメントを追跡します。 それらは自然に別々の部分に分割されたコンテンツに適しています。 一般的な例としては、オーディオブックの章、ドキュメンタリーの演技、動画コースのレッスン、ポッドキャストのエピソードのセグメントなどがあります。 オーディエンスがスキップする傾向がある章を特定するなど、セグメントレベルで視聴者のエンゲージメントを把握したい場合は、章イベントを使用します。

章が始まると、章の開始を送信します。 ビューアが章の最後まで視聴する場合は、章の完了を送信します。 視聴者がチャプター境界を見ずに終了を求める場合は、代わりに​ チャプターをスキップ ​します。 新しい章を開く前に、章を完了または章をスキップして章を閉じる必要があります。章を重ねることはできません。

プレイヤーの状態イベント

プレーヤーの状態イベント セッション全体を通じて、視聴者がプレーヤーのコントロールとどのようにインタラクションするかを追跡します。 ビューアがクローズドキャプションやミュートを有効にする頻度など、アクセシビリティ機能の使用状況を把握するのに役立ちます。 また、フルスクリーンやインライン表示、ピクチャーインピクチャーのマルチタスク処理など、視聴行動パターンも明らかになります。

追跡可能な5つの状態：fullscreen、mute、closedCaptioning、pictureInPicture、およびinFocus。 プレーヤーがこれらの状態のいずれかを入力すると状態の開始を送信し、終了すると状態の終了を送信します。 複数のステートを同時にアクティブにできます。ビューアはフルスクリーンで同時にミュートでき、複数のステートを同じイベント呼び出しで終了できます。

エラーイベント

Error イベントは、セッション中の再生エラー（失敗したストリームリクエスト、コーデックエラー、または外部配信エラー）を記録します。 意味のあるエラーが発生するたびに送信します。 エラーイベントはセッションを閉じません。再生は続行でき、後続のイベントは同じセッションで追跡されます。 エラーが復元不可能な場合は、セッション終了でエラーに従い、セッションを明示的に閉じます。