コンテンツ再生の追跡
コア再生トラッキングでは、メディアの読み込み、開始、一時停止、再開、完了、セッション終了をカバーしています。 必須ではありませんが、バッファリングとシークのトラッキングも、再生の実装を完了させるための中核となる要素です。
プレーヤーイベント
実装手順
- ユーザーが再生をトリガーするタイミングを特定 （ユーザーが「再生」または「自動再生」をクリックしたタイミング）。 コンテンツ名、ID、長さ、ストリームタイプ、メディアタイプを使用して、メディアオブジェクトを作成します。 フィールド定義については、 コンテンツ名、 コンテンツ ID、 コンテンツの長さ、 ストリームタイプ および コンテンツタイプ を参照してください。
- オプションでメタデータを添付 – 標準メタデータ（番組、季節、エピソードなど） データバリエーションを定義することができます。 標準メタデータキーの参照については、Show、Season、Episode、Genre、およびNetworkを参照してください。
- セッションのトラッキングを開始するには、 セッション開始に電話してください。 これにより、データとメタデータが読み込まれ、開始までの時間のQoS測定が開始されます。 SessionStartは、最初のフレームではなく、再生する インテント を追跡します。
- コンテンツの最初のフレームが画面に表示されたら、Playを呼び出します。
- プレーヤーが一時停止したときに一時停止の開始を呼び出します。 再生が再開されたときに、再度再生を呼び出します。 別の再開イベントはありません。
- 視聴者がコンテンツの終わりに達したら、呼び出し セッション完了。
- プレーヤーがアンロードされるか、ビューアが終了せずにコンテンツを放棄すると、 セッション終了に電話します。 SessionEndはすぐにセッションを閉じます。それ以降のイベントは追跡できません。
SessionEnd は、トラッキングセッションの終わりをマークします。 セッションが完了するまで正常に監視された場合は、SessionEndの前にSessionCompleteに電話してください。 新しいセッションのSessionStartを除き、SessionEndの後に他のトラッキング呼び出しは無視されます。コア再生
次の例は、セッションの開始からコンテンツの完了、セッションの終了に至るまで、セッションフロー全体を示しています。
プラットフォーム別の実装の詳細については、 セッション開始、再生、開始を一時停止、 セッション完了、および セッション終了を参照してください。
バッファリング
バッファー開始は、プレイヤーがデータを待っていることを示すシグナルです。 BufferStart （XDM ベースのAPI）の後にPlay イベントを送信すると、バッファーエンドが推測されます。 Mobile SDKでは、BufferCompleteも明示的に呼び出します。
実装の詳細については、 バッファー開始を参照してください。
シーク
視聴者がスクラブしていることを開始シグナルを求めます。 シーク終了の後に再生が続き、コンテンツの再生が再開されます。
実装の詳細については、開始を一時停止 （シーク開始）および再生 （シーク終了）を参照してください。
アプリの割り込みの処理
メディアアプリケーションの再生は、ユーザーが一時停止を押したり、アプリがバックグラウンドに移動したり、電話が到着したりするなど、さまざまな方法で中断する可能性があります。 原因に関係なく、トラッキング手順は同じです。
- アプリケーションが中断された場合（バックグラウンドに移動、メディアの一時停止など）、PauseStartを呼び出します。
- アプリケーションがフォアグラウンドに戻ったり、メディアの再生が再開されたりしたら、Playに電話してください。
一時停止したセッションはいつ終了しますか？ アプリケーションがバックグラウンド再生を許可しない場合は、PauseStartをすぐに呼び出し、バックグラウンドで約1分後にSessionEndを呼び出します。 アプリケーションはバックグラウンドから一時停止pingを送信し続けることはできず、セッションを無期限に開いたままにすると、エクスペリエンスが低下します。 アプリケーションがバックグラウンド再生（オーディオアプリ、ビデオポッドキャストアプリ）をサポートしている場合は、バックグラウンドでのpingの送信を続行します。
長いバックグラウンド期間の後に再起動： セッションの有効期限が切れるほどアプリがバックグラウンド化された場合（非アクティブな状態が30分）、SessionEndを呼び出して残っているセッションを完全に終了し、視聴者が戻ってきたときにSessionStartを呼び出して新しいセッションを開始します。
非アクティブなセッションの再開
10分間イベントを受信しなかった場合、または30分間プレイヘッドの移動がない場合、セッションは自動的に期限切れになります。 セッションの有効期限が切れた後にユーザーが戻った場合は、SessionStartをもう一度呼び出して新しいセッションを開きます。
デバイス間で再開（クロスデバイスのハンドオフ）:視聴者がデバイス間で再生を転送する場合（例えば、電話からテレビにキャストする場合）、再開フラグを使用して、Analytics レポートでセッションを結合します。
- ソースデバイスで、ビューアがキャストを開始したときにSessionEndを呼び出します。 SessionCompleteを呼び出さないでください。コンテンツは完了しません。
- 宛先デバイスで、再開フラグを
trueに設定してSessionStartを呼び出し、ソースデバイスから同じコンテンツメタデータと再生ヘッドの位置を渡します。
再開フラグを設定すると、Analyticsは、ハンドオフの2番目のレグに対して メディア開始ではなく コンテンツ再開を増分します。
以前に閉じられたセッションを手動で再開する： アプリケーションがユーザーデータを保存し、以前に閉じられたセッションを再開できる場合は、セッション開始時に再開フラグを設定します。 すべてのプラットフォームの実装の詳細については、 セッション開始を参照してください。