マイルストーンの概要 milestone-overview

ビデオ指標

変数の種類

説明

コンテンツ

eVar
デフォルトの有効期限：訪問

（必須）実装での指定に従って、ビデオの名前を収集します。

コンテンツタイプ

eVar
デフォルトの有効期限：ページビュー

訪問者によって閲覧されたコンテンツのタイプに関するデータを収集します。ビデオ測定によって送信されるヒットには、コンテンツタイプ video. が割り当てられます。
この変数は、ビデオ追跡専用に予約する必要はありません。同じ変数を使用する他のコンテンツレポートコンテンツタイプを使用することにより、異なるコンテンツのタイプでの訪問者の分布を分析できます。例えば、この変数を使用する article や product page などの値を使用して、他のコンテンツタイプにタグを付けることができます。
ビデオ測定の見地からすると、コンテンツタイプ ​を使用することによってビデオ訪問者を識別でき、その結果、ビデオのコンバージョン率を計算できます。

コンテンツ視聴時間

イベント
タイプ：カウンター

前回のデータ収集プロセス（イメージリクエスト）以降のビデオ視聴秒数をカウントします。

ビデオ開始

イベント
タイプ：カウンター

訪問者がビデオの一部を視聴したことを示します。ただし、訪問者がビデオを視聴した時間や視聴した部分に関する情報は提供されません。

ビデオ完了

イベント
タイプ：カウンター

ユーザーがビデオを最後まで視聴したことを示します。デフォルトでは、完了イベントはビデオが終了する 1 秒前に測定されます。
導入時に、表示完了と見なすビデオの終わりからの秒数を指定できます。終わりが定義されないライブビデオやその他のストリーミングの場合は、完了を測定するためのカスタムポイントを指定できます。例えば、表示開始から特定の時間が経過したポイントなどです。

変数

説明

構文：

s.Media.trackUsingContextData = true;
このオプションは、統合ビデオトラッキングを有効にします。true に設定すると、メディアモジュールは、従来の pev3 ではなく、メディアトラッキングのコンテキストデータを生成します。
Media.contextDataMapping を使用して、選択した eVar および event にコンテキストデータをマッピングします。
デフォルト値：false

構文：

s.Media.contextDataMapping = {
     "a.media.name":"eVar2, prop2",
     "a.media.segment":"eVar3",
     "a.contentType":"eVar1",
     "a.media.timePlayed":"event3",
     "a.media.view":"event1",
     "a.media.segmentView":"event2",
     "a.media.complete":"event7",
     "a.media.milestones":{
         25:"event4",
         50:"event5",
         75:"event6"
     }
};

ビデオ測定に使用する eVar および event への変数マッピングを定義するオブジェクトです。オブジェクトでは、次のフィールドをマッピングする必要があります。

a.media.name：（必須）変数にビデオ名を入力します。ビデオ名の格納先として選択した eVar と、ビデオパス用に使用するカスタム Insight ビデオ変数（s.prop）を指定します。値はコンマ区切りリストで指定します。

a.media.segment：（任意）メディアセグメント名の格納先の eVar です。a.contentType：（任意）ビデオ値の格納先の eVar。これには、ビデオの訪問回数および訪問者数のレポート生成が有効にされた、訪問回数および訪問者数の追跡機能が含まれます。選択する変数は、記事、スライドショー、製品ページというように、データの格納に既に使用されているものの場合もあります。

a.media.view：（必須）メディアビューをカウントするイベントです。

a.media.segmentView：（任意）セグメントビューをカウントするイベントです。

a.media.complete：（任意）視聴の完了をカウントするイベントです。

a.media.timePlayed：（オプション、推奨）ビデオの再生秒数を格納する数値のイベントです。

a.media.milestones：（任意）s.Media.trackMilestones マイルストーンをカウンターイベントにマッピングするオブジェクトです。マイルストーンを定義する場合は、Media.segmentByMilestones を true に設定する必要があります。

広告トラッキング 広告を追跡するには、以下のコンテキストデータ編集を使用できます。
a.media.ad.name：（必須）変数に広告名を入力します。広告名の格納先として選択した eVar と、パス用に使用するカスタム Insight ビデオ変数（s.prop）を指定します。値はコンマ区切りリストで指定します。

a.media.ad.pod： ​広告が表示されたプライマリコンテンツ内の位置。

a.media.ad.podPosition： ​広告が表示されるポッド内の位置。

a.media.ad.CPM： ​この再生に適用される CPM または暗号化された CPM（「~」のプレフィックスが付く）。

a.media.ad.view：a.media.view

と同じように機能します。 a.media.ad.clicked： ​広告のクリック数をカウントします（Media.click 呼び出し）。

a.media.ad.timePlayed：a.media.timePlayed

と同じように機能します。 a.media.ad.complete： a.media.complete と同じように機能します。a.media.ad.segment：a.media.segment と同じように機能します。

a.media.ad.segmentView：a.media.segmentView

と同じように機能します。 a.media.ad.milestones：a.media.milestones

と同じように機能します。 a.media.ad.offsetMilestones：a.media.offsetMilestones と同じように機能します。

構文：

s.Media.trackVars =
   "events, prop2, eVar1, eVar2, eVar3";

ビデオ追跡コードに設定されるすべての変数のコンマ区切りリストです。

構文：

s.Media.trackEvents =
   "event1, event2, event3, event4, event5, event6, event7"

ビデオ追跡コードに設定されるすべてのイベントのコンマ区切りリストです。

変数

説明

構文：

s.Media.autoTrack = true

サポートされているプレーヤーの自動追跡を有効にします。サポートされているプレーヤーは次のとおりです。

• Open Source Media Framework（OSMF）
• FLVPlayback（Flash Professional のビデオのインポートウィザードによって作成されるビデオプレーヤー）
• Silverlight
• MediaDisplay
• MediaPlayback
• Brightcove API バージョン 2 および 3（Brightcove を参照）
• JavaScript を使用する、Windows Media Player、Quicktime または Real Player

以上のプレーヤーの中の 1 つを使用しない場合は、Media.open、Media.play、Media.stop、Media.close を使用して、プレーヤーイベントを追跡できます。

構文：

s.Media.autoTrackNetStreams = true

Flash 10.3 では、拡張ビデオトラッキングを可能にする新しい機能が NetStream コンポーネントに追加されました。カスタム Flash NetStream プレーヤーを使用する場合は、この変数を有効にすることで、autoTrack と同様の機能を有効にできます。このメソッドを使用するには、ビデオが Flash 10.3 以降で視聴されている必要があります。

構文：



s.Media.completeByCloseOffset = true

この設定を使用すると、実際にビデオの最後に到達する数秒前に、ビデオビューの完了としてカウントできます。

イベントは、completeCloseOffsetThreshold で指定されている秒数に基づいて送信されます。これにより、ビデオの長さに等しいオフセットの報告を実行しないビデオプレーヤーでも、完了を測定できます。

デフォルトでは、この値は true に設定され、しきい値は 1 秒に設定されます。これらのデフォルトでは、完了イベントは、ビデオの最後の 1 秒前に送信されます。

構文：

s.Media.completeCloseOffsetThreshold = 1

このしきい値を使用すると、実際にビデオの最後に到達する数秒前に、ビデオビューの完了としてカウントできます。このしきい値を使用するには、Media.completeByCloseOffset を true に設定する必要があります。

指定する整数値によって、終了時に完了としてカウントされる、ビデオの長さからのオフセットの値（秒数）が決まります。これにより、ビデオの長さに等しいオフセットの報告を実行しないビデオプレーヤーでも、完了を測定できます。

しきい値のデフォルトは 1 秒です。

構文：

s.Media.playerName = "Custom Player Name"

カスタムビデオプレーヤー名を指定します。

構文：

s.Media.trackSeconds = 15

ビデオ再生中にビデオトラッキングデータを Adobe データ収集サーバーへ送信する時間間隔を秒数で定義します。値は 5 秒単位の増分で設定する必要があります。

Media.trackSeconds を有効にすると、Media.contextDataMapping で定義されているイベントのみがトリガーされます。ビデオ測定のために指定以外の変数を追加で送信するには、Media.Monitor を使用する必要があります。

ビデオの長さに対する割合として、マイルストーンを追跡します。

構文：

s.Media.trackMilestones = "25, 50, 75";

ビデオトラッキングデータを Adobe データ収集サーバーに送信する時間間隔を、ビデオの長さの割合として定義します。整数のコンマ区切りリストとしてマイルストーンを指定します。例えば、10 は 10％を表し、23 は 23％を表します。

これらのマイルストーンはビデオ内の固定ポイントなので、訪問者が 10％のマイルストーンをまたいで視聴し、その後に巻戻しを実行して、もう一度 10％のマイルストーンを通過した場合、メディアモジュールは追跡データを複数回送信します。同様に、ある訪問者が早送りしてマイルストーンを通過した場合、そのマイルストーンについての追跡データはメディアモジュールによって送信されません。

Media.trackMilestones を有効にすると、Media.contextDataMapping で定義されているイベントのみがトリガーされます。ビデオ測定のために指定以外の変数を追加で送信するには、Media.Monitor を使用する必要があります。

ビデオの開始時点からの経過秒数としてマイルストーンを追跡します。

構文：

s.Media.trackOffsetMilestones = "20, 40, 60";

ビデオトラッキングデータを Adobe データ収集サーバーに送信する時間間隔を、ビデオの開始時点からの経過秒数として定義します。整数のコンマ区切りリストとしてマイルストーンを指定します。例：20 = 20 秒、40 = 40 秒。

これらのマイルストーンはビデオ内の固定ポイントなので、訪問者が 20 秒のマイルストーンをまたいで視聴し、その後に巻戻しを実行して、もう一度 20 秒のマイルストーンを通過した場合、メディアモジュールは追跡データを複数回送信します。同様に、ある訪問者が早送りしてマイルストーンを通過した場合、そのマイルストーンについての追跡データはメディアモジュールによって送信されません。

Media.trackOffsetMilestones を有効にすると、Media.contextDataMapping で定義されているイベントのみがトリガーされます。ビデオ測定のために指定以外の変数を追加で送信するには、Media.Monitor を使用する必要があります。

構文：

s.Media.segmentByMilestones = true;

メディアの長さと Media.trackMilestones で指定されているマイルストーンに基づいて、セグメント名、セグメント番号、セグメントの長さのデータを自動的に生成します。

マイルストーンによってセグメントに分割する方法は、autoTrack を使用する場合にセグメントを定義する唯一の方法です。

デフォルト値：false

構文：

s.Media.segmentByOffsetMilestones = true;

メディアの長さと Media.trackOffsetMilestones で指定されているマイルストーンに基づいて、セグメント名、セグメント番号、セグメントの長さのデータを自動的に生成します。

マイルストーンによってセグメントに分割する方法は、autoTrack を使用する場合にセグメントを定義する唯一の方法です。

デフォルト値：false

変数

説明

構文：

s.Media.adTrackSeconds = 15;

ビデオ再生中にビデオ広告トラッキングデータを Adobe データ収集サーバーに送信する時間間隔を秒数で定義します。値は 5 秒単位の増分で設定する必要があります。

Media.adTrackSeconds を有効にすると、Media.contextDataMapping で定義されているイベントのみがトリガーされます。ビデオ測定のために指定以外の変数を追加で送信するには、Media.monitor を使用する必要があります。

広告の長さに対する割合として、広告マイルストーンを追跡します。

構文：

s.Media.adTrackMilestones = "25, 50, 75";

広告トラッキングデータを Adobe データ収集サーバーに送信する時間間隔を、広告の長さの割合として定義します。整数のコンマ区切りリストとしてマイルストーンを指定します。例えば、10 は 10% を表し、23 は 23% を表します。

これらのマイルストーンは広告内の固定ポイントなので、訪問者が 10％のマイルストーンをまたいで視聴し、その後に巻戻しを実行して、もう一度 10％のマイルストーンを通過した場合、メディアモジュールは追跡データを複数回送信します。同様に、ある訪問者が早送りしてマイルストーンを通過した場合、そのマイルストーンについての追跡データはメディアモジュールによって送信されません。

Media.adTrackMilestones を有効にすると、Media.contextDataMapping で定義されているイベントのみがトリガーされます。ビデオ測定のために指定以外の変数を追加で送信するには、Media.monitor を使用する必要があります。

広告の開始時点からの経過秒数として広告マイルストーンを追跡します。

構文：

s.Media.adTrackOffsetMilestones = "20, 40, 60";

広告トラッキングデータを Adobe データ収集サーバーに送信する時間間隔を、広告の開始時点からの経過秒数として定義します。整数のコンマ区切りリストとしてマイルストーンを指定します。例：20 = 20 秒、40 = 40 秒。

これらのマイルストーンは広告内の固定ポイントなので、訪問者が 20 秒のマイルストーンをまたいで視聴し、その後に巻戻しを実行して、もう一度 20 秒のマイルストーンを通過した場合、メディアモジュールは追跡データを複数回送信します。同様に、ある訪問者が早送りしてマイルストーンを通過した場合、そのマイルストーンについての追跡データはメディアモジュールによって送信されません。

Media.adTrackOffsetMilestones を有効にすると、Media.contextDataMapping で定義されているイベントのみがトリガーされます。ビデオ測定のために指定以外の変数を追加で送信するには、Media.monitor を使用する必要があります。

構文：

s.Media.adSegmentByMilestones = true;

メディアの長さと Media.adTrackMilestones で指定されているマイルストーンに基づいて、セグメント名、セグメント番号、セグメントの長さのデータを自動的に生成します。

マイルストーンによってセグメントに分割する方法は、autoTrack を使用する場合にセグメントを定義する唯一の方法です。

デフォルト値：false

構文：

s.Media.adSegmentByOffsetMilestones = true;

メディアの長さと Media.adTrackOffsetMilestones で指定されているマイルストーンに基づいて、セグメント名、セグメント番号、セグメントの長さのデータを自動的に生成します。

マイルストーンによってセグメントに分割する方法は、autoTrack を使用する場合にセグメントを定義する唯一の方法です。

デフォルト値：false

メソッド

説明

構文：

s.Media.open(mediaName, mediaLength, mediaPlayerName)

メディアモジュールでビデオトラッキングデータを収集するよう準備します。このメソッドでは次のパラメーターを取ります。

• mediaName：（必須）ビデオレポートに表示するビデオの名前。
• mediaLength：（必須）ビデオの長さ（秒単位）。
• mediaPlayerName：（必須）ビデオの視聴に使用されるメディアプレーヤーの名前。ビデオレポートに表示する名前です。

構文：

s.Media.openAd(name, length, playerName, parentName,
parentPod, parentPodPosition, CPM)

メディアモジュールで広告トラッキングデータを収集するよう準備します。このメソッドでは次のパラメーターを取ります。

• name：（必須）広告の名前または ID。
• length：（必須）広告の長さ。
• playerName：（必須）広告の表示に使用するメディアプレーヤーの名前。
• parentName： ​広告が埋め込まれたプライマリコンテンツの名前または ID。
• parentPod： ​広告が表示されたプライマリコンテンツ内の位置。
• parentPodPosition： ​広告が表示されるポッド内の位置。
• CPM： ​この再生に適用される CPM または暗号化された CPM（「~」のプレフィックスが付く）。

構文：

s.Media.click(name, offset)

ビデオで広告がいつクリックされたかを追跡します。このメソッドでは次のパラメーターを取ります。

• name： ​広告の名前。Media.openAd で使用されている名前と一致させる必要があります。
• offset： ​クリックが発生した際の、広告までのオフセット。

構文：

s.Media.close(mediaName)

ビデオデータの収集を終了して情報を Adobe データ収集サーバーに送信します。このメソッドはビデオの最後で呼び出します。このメソッドは、次のパラメーターを取ります。

mediaName： ​ビデオ名。Media.open で使用されている名前と一致させる必要があります。

構文：

s.Media.complete(name, offset)

このメソッドを使用して、完了イベントを手動で追跡します。このメソッドは、Media.completeByCloseOffset で処理できない特別なロジックを使用してイベントをトリガーする必要がある場合に使用します。

例えば、最後が定義されていないライブストリームを測定する場合、ユーザーがライブストリームを X 秒間視聴した後で、完了をトリガーすることができます。コンテンツの長さと種類に基づいた割合の計算を使用して、完了を測定します。このメソッドでは次のパラメーターを取ります。

• mediaName： ​ビデオ名。Media.open で使用されている名前と一致させる必要があります。
• mediaOffset： ​完了イベントを送信する、ビデオ開始後の秒数。ゼロ秒を開始点としてオフセットを指定します。
  
  メディアプレーヤーでマイルストーンを使用して追跡を行っている場合は、Media.complete を呼び出す前に、値を秒数に必ず変換してください。

complete を手動で呼び出す計画がある場合は、

s.Media.completeByCloseOffset = false を参照してください。

構文：

s.Media.play(name, offset, segmentNum, segment, segmentLength)

ビデオの再生を開始するときは常にこのメソッドを呼び出します。手動でビデオ測定を行う場合、ビデオ測定データを送信するときに現在のセグメントデータを送信できます。

プレーヤーでの再生があるセグメントから別のセグメントへ移行した場合は、その理由がどのようなものであっても、Media.stop Media.play を呼び出す必要があります。

このメソッドでは次のパラメーターを取ります。

mediaName： ​ビデオ名。これは、Media.open で使用される名前と一致する必要があります。

mediaOffset： ​ビデオの再生が開始されてからの秒数。ゼロ秒を開始点としてオフセットを指定します。Media Player がミリ秒を使用して追跡する場合は、Media.play を呼び出す前に、値が秒単位に変換されていることを確認します。

segmentNum：（任意）現在のセグメント番号。マーケティングレポートでは、この番号を使用して、レポートでのセグメントの表示順を決定します。segmentNum パラメーターは 0 より大きい値にする必要があります。

segment：（任意）現在のセグメント名。

segmentLength：（任意）

現在のセグメントの長さ（秒単位）。

例：

s.Media.play("My Video", 1800, 2,"Second Quarter", 1800)

s.Media.play("My Video", 0, 1,"Preroll", 30)

構文：

s.Media.stop(mediaName, mediaOffset)

指定したビデオの停止イベント（停止、一時停止など）を追跡します。このメソッドでは次のパラメーターを取ります。

• mediaName： ​ビデオ名。Media.open で使用されている名前と一致させる必要があります。
• mediaOffset： ​停止または一時停止が発生するビデオ開始後の秒数。ゼロ秒を開始点としてオフセットを指定します。

構文：

s.Media.monitor(s, media)

Silverlight の構文：

s.Media.monitor =
   new AppMeasurement_Media_Monitor(myMediaMonitor);

Silverlight アプリケーションのメディアモニターには、Objective-C delegate の設計パターンが導入されています。myMediaMonitor クラスメソッドは s および media パラメーターを取ります。

このメソッドを使用して、追加のビデオ指標を送信します。変数（prop、eVar、event）を追加したり、ビデオの再生進行に伴う最新の状態に基づいて Media.track を呼び出し、変数を送信したりできます。

Media.monitor を使用した追加指標の測定を参照してください。

このメソッドでは次のパラメーターを取ります。

s： AppMeasurement インスタンス（または、JavaScript s オブジェクト）。

media： ​メンバーがビデオの状態を表すオブジェクトです。メンバーの例は次のとおりです。

• media.name: ビデオの名前。Media.open で使用されている名前と一致させる必要があります。
• media.length: Media.open への呼び出しで提供されるビデオの長さ（秒）。
• media.playerName: Media.open への呼び出しで提供されるメディア プレイヤー名。
• media.openTime: Media.open が呼び出された時点についてのデータを含む NSDate オブジェクト。
• media.offset:ビデオの現在の秒オフセット（実際のビデオ経過時間）。オフセットは 0 で開始します（ビデオの最初は 0 秒）。
• media.percent:ビデオの長さと現在のオフセットを基にした、再生されているビデオの現在のパーセント。
• media.timePlayed:それまでの再生秒数の合計。
• media.eventFirstTime:そのビデオに当該メディアイベントが初めて呼び出されたことを示します。
• media.mediaEvent:モニターが呼び出される原因となったイベント名を含む文字列。

media.mediaEvent events：

• OPEN: 再生が初めて観察されたとき（Media.autoTrack 使用時）、または Media.play への呼び出し。
• CLOSE: ビデオの完了時に再生が終了したとき（Media.autoTrack 使用時）、または Media.close への呼び出し。
• PLAY:一時停止またはスクラブ後に再生が再開されたとき（Media.autoTrack 使用時）、または Media.play への呼び出し。
• STOP:スクラブの開始の一時停止により再生が停止したとき（Media.autoTrack 使用時）、または Media.stop への呼び出し。
• MONITOR:自動監視機能により再生中にビデオの状態がチェックされるとき（毎秒）。
• SECONDS: Media.trackSeconds 変数で定義されている秒間隔。
• MILESTONE: Media.trackMilestones 変数で定義されているマイルストーン。

構文：

s.Media.track(mediaName)

現在のビデオの状態と共に、ユーザーが定義した Media.trackVars と Media.trackEvents を即座に送信します。このメソッドは、Media.monitor 内で使用します。

Media.monitor を使用した追加指標の測定を参照してください。

このメソッドを呼び出す前にビデオの Media.open と Media.play を呼び出します。このメソッドでは次のパラメーターを取ります。

• mediaName：ビデオ名。Media.open で使用されている名前と一致させる必要があります。

このメソッドは、ビデオ再生中に他の変数を送信する唯一の方法です。このメソッドは、追跡が複数回ヒットしないように、秒間隔およびパーセントマイルストーンを 0 にリセットします。