メディアトラッキング

メディアトラッキングは、アプリ内でのストリーミングメディアイベント（ビデオまたはオーディオ）を追跡する機能です。ストリーミングメディアイベントには、セッション、チャプター、広告（広告）、再生、シーク、一時停止などのプレーヤーイベントが含まれます。このトラッキング機能をiOSまたはAndroidアプリに追加するには、Mediaモジュールをインストールしてメディアトラッキングメソッドを実装します。

動作原理

Mediaモジュールは、ユーザーのストリーミングメディア体験全体を追跡します。これには、セッションの開始と終了、広告ブレイクの開始と終了、再生、一時停止、シークなどのメディアプレーヤーとのすべてのインタラクションが含まれます。

Mediaモジュールは、次の要素の階層構造でトラッキングを行います。

メディアセッション
メディアセッションは、他のすべての要素のコンテナであり、ストリーミング体験に関する一般的な情報を定義します。メディアセッションは、トラッキングに必要な要素です。

チャプター
チャプターは、セッション内のブレイク（オーディオブックのチャプターや映画のシーンなど）を区切るオプションのセグメントです。

広告ブレイク
広告ブレイクは、1つ以上の広告のコンテナです。広告ブレイクは、セッションの開始、中間、または終了時に一般的に配置されます。

広告
広告は、広告ブレイク内で発生するオプションの要素です。

メディアセッションの例の構造：

└── メディアセッション
    ├── 広告ブレイク1
    │   ├── 広告1
    │   └── 広告2
    ├── チャプター1
    ├── 広告ブレイク2
    │   ├── 広告3
    │   └── 広告4
    └── チャプター2

インストール

開始するには、サポートされているプラットフォームのMediaモジュールをインストールします。

• Android（Kotlin）
• iOS（Swift v2.x）

初期化

Mediaモジュールをインストールした後、MediaContentオブジェクトを初期化します。

val mediaContent: MediaContent = MediaContent(
  name = "Tealium Customer Data Hubとは？",
  trackingType = TrackingType.MILESTONE,
  streamType = StreamType.DVOD,
  mediaType = MediaType.VIDEO,
  qoe = QoE(1500),
  duration = 130
)

let media = MediaContent(
  name: "Tealium Customer Data Hubとは？",
  trackingType: .milestone,
  streamType: .vod,
  mediaType: .video,
  qoe: QoE(bitrate: 1500),
  duration: 130
)

TrackingType

トラッキングタイプは、Tealiumイベントとしてトラッキングするメディアイベントを決定します（トラッキングタイプの概要を参照）。

TrackingTypeを構成するために、次の定数のいずれかを使用します。

StreamType

StreamTypeを構成するために、次の定数のいずれかを使用します。

MediaType

次のは、MediaTypeの定数です。

State

プレーヤーの状態トラッキングは、再生中のビデオプレーヤーのモード（フルスクリーンモード、クローズドキャプション、ミュートボリュームなど）をキャプチャします。プレーヤーの状態は、データレイヤー変数media_player_stateに構成されます。

プレーヤーの状態の変更をトラッキングする例：

tealium?.media?.updatePlayerState(STATE_CONSTANT_VALUE)

mediaSession.playerState = STATE_CONSTANT_VALUE

Stateを構成するために、次の定数のいずれかを使用します。

エクスペリエンスの品質

メディアセッションのエクスペリエンスの品質は、秒単位のビットレートで構成されます。メディア再生中に現在のビットレート値が利用可能な場合は、qoe変数としてMediaContentオブジェクトの初期化時に提供します。品質の構成は、media_bitrate_change tealiumイベントをトリガーします。

エクスペリエンスの品質をトラッキングする例：

tealium?.media?.updateQOE(BITRATE_VALUE)

mediaSession.bitrate = BITRATE_VALUE

メタデータ

メタデータは、オブジェクトに関する追加情報を構成するパラメータです。メタデータをオブジェクトに渡すと、それらのキーと値のペアがデータレイヤーにも構成されます。次のオブジェクトはメタデータを受け入れます：MediaContent、Chapter、QoE。

メタデータは複数のオブジェクトに構成できるため、データレイヤーの競合するメタデータキーを解決するために、複数のオブジェクトからのメタデータがオブジェクトの階層構造を使用してデータレイヤーにマージされます：MediaContent > Chapter > QoE。

たとえば、MediaContentとChapterの両方でfeed_typeを構成した場合、最終的なデータレイヤーでは、Chapterのメタデータの値がMediaContentのメタデータの値を上書きします。

メタデータを構成する例：

val mediaContent: MediaContent = MediaContent(
    // ...
    metadata = mutableMapOf("episode" to "2", "network" to "YouTube")
)

let media = MediaContent(
    // ...
    metadata: ["episode": "2", "network": "YouTube"]
)

ビデオメタデータキー

次は、一般的なビデオメタデータキーの例です。

オーディオメタデータキー

次は、一般的なオーディオメタデータキーの例です。

トラッキングタイプの概要

トラッキングタイプは、トリガーされるTealiumイベントを決定します。トラッキングしたいイベントのレベルに基づいてトラッキングタイプを選択します。

たとえば、すべてのトラッキングメソッドを実装し、サマリートラッキングを使用する場合、media_session_endイベントのみがトリガーされます。

フル再生イベント

フル再生トラッキングを使用して、インターバルイベントを除くすべてのメディアイベントをトラッキングします。

トラッキングされるイベントは次のとおりです。

• セッションイベント：
  • media_session_start
  • media_session_resume
  • media_session_end
• 広告ブレイクイベント：
  • media_adbreak_start
  • media_adbreak_end
• 広告イベント：
  • media_ad_start
  • media_ad_end
  • media_ad_click
  • media_ad_skip
• チャプターイベント：
  • media_chapter_start
  • media_chapter_skip
  • media_chapter_end
• バッファイベント：
  • media_buffer_start
  • media_buffer_end
• プレーヤーイベント：
  • media_play
  • media_pause
  • media_seek_start
  • media_seek_end
• その他のイベント
  • media_bitrate_change

インターバルイベント

インターバルトラッキングを使用して、メディアプレーヤーの状態を定期的にトラッキングします。このタイプを使用すると、ping()メソッドが10秒ごとに呼び出され、コンテンツが再生されているかどうかを確認し、データレイヤーのtealium_eventをmedia_intervalに構成します。

トラッキングされるイベントは次のとおりです。

• セッションイベント：
  • media_session_start
  • media_session_resume
  • media_session_end
• プレーヤーイベント：
  • media_play
  • media_pause
• インターバルイベント：
  • media_interval

マイルストーンイベント

マイルストーントラッキングを使用して、コンテンツの再生率が達成されたときにトラッキングします。各マイルストーンのパーセンテージが達成されるたびに、sendMilestone()メソッドが自動的に呼び出され、データレイヤーのtealium_eventがmedia_milestoneに構成されます。

トラッキングされるイベントは次のとおりです。

• マイルストーンイベント：
  • media_milesetone
• セッションイベント：
  • media_session_start
  • media_session_resume
  • media_session_end
• プレーヤーイベント：
  • media_play
  • media_pause
  • media_seek_start
  • media_seek_end
• 広告ブレイクイベント：
  • media_adbreak_start
  • media_adbreak_end

インターバルマイルストーンイベント

インターバルマイルストーントラッキングを使用して、インターバルイベントとマイルストーンイベントの両方をトラッキングします。

サマリーイベント

サマリートラッキングを使用して、セッションが終了したときに単一のサマリーイベントをデータレイヤーに送信します。セッションのサマリーイベントには、再生されたコンテンツや広告の再生時間の計算が含まれます。

サマリーイベントは次のとおりです。

• セッションイベント：
  • media_session_start
  • media_session_end

トラッキングされるすべてのメディアサマリー変数のリストを参照してください。

比較チャート

利用可能なすべてのメディアイベントの完全なリストについては、トラックセクションを参照してください。

トラック

MediaContentオブジェクトを初期化した後、次のメソッドを使用してメディアのインタラクションをトラッキングします。

メディアセッション

メディアセッションは、チャプター、広告ブレイク、広告、メディアプレーヤーイベントを含むメディアコンテンツ全体です。

メディアセッションのトラッキングを開始するには、startSession()メソッドをMediaContentオブジェクトとともに呼び出します。メディアセッションのトラッキングを停止するには、endSession()メソッドを呼び出します。

セッションの開始はplay()イベントを意味しません。

チャプターをトラッキングする例：

tealium?.media?.startSession(mediaContentObject)
//...
tealium?.media?.endSession()

let mediaSessionObject = tealium?.media?.createSession(
      from: mediaContentObject)                                
mediaSessionObject.startSession()
// ...
mediaSessionObject.end()