HTML5ビデオイベント
HTML5ビデオイベントは、訪問者がページ上の埋め込まれたHTML5ビデオと対話するときにトラッキングデータを送信します。訪問者が再生、一時停止、特定の再生マイルストーンに到達する、またはビデオがバッファリングしているときにイベントトリガーを指定できます。
必要条件
- utag v4.38以降。
utag.js
テンプレートの更新についての詳細は、ナレッジベースの記事utag.jsの最新バージョンへの更新のベストプラクティスを参照してください。
動作方法
HTML5ビデオイベントは、訪問者がHTML5ビデオと対話するときにトラッキングします。訪問者がアクションを実行すると、トラッキングコールがトリガーされます。
イベントリスナーの追加方法についての詳細は、イベントの管理を参照してください。
イベントトリガー
イベントトリガーは、イベントリスナーがトラッキングする特定のアクションです。
HTML5ビデオイベントは、以下のイベントトリガーをトラッキングできます:
- 再生 – ビデオが再生されたときにイベントリスナーをトリガーします。
- 一時停止 – ビデオが一時停止したときにイベントリスナーをトリガーします。
- バッファリング – ビデオがバッファリングしているときにイベントリスナーをトリガーします。
- マイルストーン – ビデオの一部または特定の時間が再生されたときにイベントリスナーをトリガーします。
マイルストーンイベントトリガーでは、以下の閾値のいずれかを設定できます:
- 完了のパーセンテージ – イベントリスナーがトリガーする前に視聴者が視聴する必要があるビデオのパーセンテージ。複数の値をカンマで区切ったリストで入力します(例:
25, 50, 75
)。 - 視聴時間 – イベントリスナーをトリガーするために必要なビデオの合計視聴時間。
要素セレクタ
要素セレクタは、イベントリスナーをトリガーするページ上のどの要素を指定するかを指定します。詳細については、イベント要素セレクタを参照してください。
トリガー頻度
トリガー頻度は、イベントトリガーがトラッキングコールを結果とする回数を決定します。詳細については、イベントトリガーを参照してください。
イベントトリガー変数
イベントトリガー変数は、イベントリスナーがトラッキングコールと共に送信する値です。新しいイベント > イベント設定画面で、イベントトリガー変数テーブルに移動し、イベントのトリガー変数を表示または編集するためのトリガータイプをクリックします。
例えば、一時停止トリガーの変数を表示するには、一時停止タブをクリックします:
HTML5ビデオイベントには、以下のデフォルトのイベントトリガー変数があります:
変数 | 説明 | 例 | タイプ |
---|---|---|---|
tealium_event |
Tealiumのイベント名。 | video_play |
文字列 |
video_id |
プラットフォーム上のビデオID。 | xWlEk2i9r5Q |
文字列 |
video_name |
ビデオの名前。 | Tealiumでのビデオトラッキング方法 |
文字列 |
video_length |
ビデオの合計長さ(秒)。 | 300 |
数値 |
video_platform |
ビデオを提供するプラットフォームの名前。 | html5 |
文字列 |
video_playhead |
イベント時のビデオの再生位置(秒)。 | 151 |
数値 |
video_milestone |
ビデオの再生されたパーセンテージまたは時間。この変数はマイルストーントリガーと共に表示されます。 | 50 |
数値 |
milestone_type |
マイルストーンのタイプ、percent またはtime 。この変数はマイルストーントリガーと共に表示されます。 |
percent |
数値 |
iq_event_id |
イベントを送信したイベントリスナーのUID。 | html5_video_events_1 |
文字列 |
再生
識別子 | 説明 |
---|---|
tealium_event="video_play" |
訪問者がビデオを再生しました。 |
例
{
"tealium_event" : "video_play",
"video_id" : "xWlEk2i9r5Q",
"video_name" : "Tealiumでのビデオトラッキング方法",
"video_length" : "300",
"video_platform" : "html5",
"video_playhead" : "1",
"iq_event_id:" : "html5_video_events_1"
}
一時停止
識別子 | 説明 |
---|---|
tealium_event="video_pause" |
訪問者が再生中のビデオを一時停止しました。 |
例
{
"tealium_event" : "video_pause",
"video_id" : "xWlEk2i9r5Q",
"video_name" : "Tealiumでのビデオトラッキング方法",
"video_length" : "300",
"video_platform" : "html5",
"video_playhead" : "30",
"iq_event_id:" : "html5_video_events_2"
}
バッファリング
識別子 | 説明 |
---|---|
tealium_event="video_buffer" |
訪問者がビデオのバッファリングを経験しました。 |
例
{
"tealium_event" : "video_buffer",
"video_id" : "xWlEk2i9r5Q",
"video_name" : "Tealiumでのビデオトラッキング方法",
"video_length" : "300",
"video_platform" : "html5",
"video_playhead" : "50",
"iq_event_id:" : "html5_video_events_3"
}
マイルストーン
識別子 | 説明 |
---|---|
tealium_event="video_milestone" |
訪問者がビデオをパーセンテージまたは時間のマイルストーンまで再生しました。 |
例
{
"tealium_event" : "video_milestone",
"video_milestone" : "50",
"milestone_type" : "percent",
"video_id" : "xWlEk2i9r5Q",
"video_name" : "Tealiumでのビデオトラッキング方法",
"video_length" : "300",
"video_platform" : "html5",
"video_playhead" : "151",
"iq_event_id:" : "html5_video_events_4"
}
最終更新日 :: 2024年April月11日