マイルストーンの概要

レガシーのマイルストーンドキュメント

設定

マイルストーンビデオの設定

ビデオを追跡するには、追跡とレポートに使用される​カスタムコンバージョン変数（eVar）と​カスタムイベント​のセットを指定します。また、1 つの​カスタム Insight​変数（s.prop）もパスに使用されます。

それぞれの指標に対して選択した変数がビデオ設定ページに追加されます。これにより、システムは、自動的に標準ビデオレポートを生成し、書式設定します。ビデオ名 eVar と​ビデオビュー​カウンターの両方が必要です。その他の変数は任意ですが、完全な測定をおこなううえで推奨されます。ビデオトラッキングを有効にしたら、ビデオトラッキングを使用してレポートしたビデオデータから生成されたレポートを表示できます。

さらに、ビデオに関する任意の数の追加指標を追跡できます。例えば、サイトで複数のビデオプレーヤーを使用している場合は、eVar にプレーヤー名を格納できます。選択した変数のいくつかは、サイトの他の領域でも使用される場合があります。例えば、サイト全体で使用される​コンテンツタイプ​変数を利用すると、ビデオから取得されたページ表示の割合を測定したり、コンバージョンイベントをビデオに関連付けたりできます。

マイルストーンレポートの設定

マイルストーン実装用にビデオレポートを設定するには、管理者／レポートスイートマネージャーに移動します。​レポートスイートを選択し、ビデオ管理／ビデオレポートを選択します。

最初の画面では、マイルストーンデータと共に使用できるのはビデオコアのみです。「ビデオコア」を選択し、「保存」を選択します。

次の画面で、「カスタム変数を使用」を選択します。

最後の画面で、次のように、ビデオ測定で使用する 2 つの eVar と 3 つのイベントを選択します。

ビデオ変数リファレンス

次の表に、ビデオのコマース変数とカスタムイベントの詳細を示します。

メディアモジュール変数

次の変数を使用して、ビデオ測定を設定できます。「必須変数」の表に示した変数に対する値を定義する必要があります。また、ビデオプレーヤーでイベントを追跡するには、autoTrack を有効にするか（サポートされているプレーヤーの場合）、open、play、stop および close の各メソッドを使用してカスタムプレーヤーイベント追跡を導入する必要があります。

オプションの変数

広告トラッキング変数

これらの変数は、openAd メソッドと組み合わせて広告情報を送信するために使用されます。VAST ビデオ広告トラッキングを参照してください。

メディアモジュールメソッド

メディアモジュールメソッドを使用すると、プレーヤーのイベントを手動で追跡したり、標準ビデオレポートに含まれていない追加の指標を追跡したりできます。

Media.autoTrack を使用し、追加指標を追跡しない場合、これらのメソッドを直接呼び出す必要はありません。特にオプションとして指定されていない限り、すべての引数が必要です。

ビデオプレーヤーイベントの追跡

ビデオプレーヤーのイベントハンドラーに追加する関数を作成することで、メディアプレーヤーを追跡できます。これにより、Media.open、Media.play、Media.stop および Media.close を適切なタイミングで呼び出すことができます。次に例を示します。

• 読み込み：Media.openおよびMedia.play を呼び出します。
• 一時停止：Media.stop を呼び出します。例えば、ユーザーが 15 秒後にビデオを一時停止したときは、s.Media.stop("Video1", 15) を呼び出します。
• バッファー：​ビデオのバッファリング中に Media.stop を呼び出します。再生の再開時に Media.play を呼び出します。
• 再開：Media.play を呼び出します。例えば、ユーザーが最初にビデオを 15 秒間再生した後にビデオを再開した場合は、s.Media.play("Video1", 15) を呼び出します。
• スクラブ（スライダー）：​ユーザーがビデオスライダーをドラッグしたとき、Media.stop を呼び出します。ユーザーがビデオのスライダーを離したときに、Media.play を呼び出します。
• 終了： Media.stop を呼び出してから、Media.close を呼び出します。例えば、100 秒のビデオの終了時に、s.Media.stop("Video1", 100) を呼び出し、次に s.Media.close("Video1") を呼び出します。

以上を実行するために、メディアプレーヤーイベントハンドラーから呼び出すことができる 4 つのカスタム関数を定義します。プレーヤーから各種パラメーターが Media.open、Media.play、Media.stop および Media.close に渡されます。次の擬似コードに、この処理を示します。

/* Call on video load */
function startMovie() {
    s.Media.open(mediaName, mediaLength, mediaPlayerName);
    playMovie();
}

/* Call on video resume from pause and slider release */
function playMovie() {
    s.Media.play(mediaName,
                 mediaOffset,
                 segmentNum,
                 segment,
                 segmentLength);
}
/* Call on video pause and slider grab */
function stopMovie() {
    s.Media.stop(mediaName, mediaOffset);
}

/* Call on video end */
/* Measuring Video for Developers 43 */
function endMovie() {
    stopMovie();
    s.Media.close(mediaName);
}

JavaScript autotrack

JavaScript メディアモジュールは、ページ HTML 内のすべての <embed> タグまたは <object> タグを識別します。その後、各タグのデータを検索し、使用されているメディアプレーヤーがある場合はどのメディアプレーヤーかを判断します。プレーヤーが Windows Media Player、Quicktime、または Real Player の場合は、autoTrack を使用できます。ただし、Windows Media Player については、autoTrack が機能するのは Internet Explorer のみです。その他のすべてのブラウザーをサポートするには、Windows Media Player の手動の追跡が必要です。

追跡するオブジェクトに classid 属性を設定する必要があります。ビデオを自動的に追跡するには、classid は、メディアモジュールで使用するイベントハンドラーを公開する必要があります。

s.Media.autoTrack = true

JavaScript のサンプルコード

// Sample implementation
s.usePlugins=true
function s_doPlugins(s) {
    /* Add manual calls to modules and plugins here */
}

s.doPlugins=s_doPlugins

/*********Media Module Calls**************/
s.loadModule("Media")

/*Configure Media Module Functions */
s.Media.autoTrack= true;
s.Media.trackVars="events, prop2, eVar1, eVar2, eVar3";
s.Media.trackEvents="event1, event2, event3, event4, event5, event6, event7"
s.Media.trackMilestones="25, 50, 75";
s.Media.playerName="My Media Player";
s.Media.segmentByMilestones = true;
s.Media.trackUsingContextData = true;
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"
    }
}

s.Media.monitor = function (s, media) { } //If Needed

/* Turn on and configure debugging here */
s.debugTracking = true;
s.trackLocal = true;

/* WARNING: Changing any of the below variables will cause drastic changes to how your visitor
data is collected. Changes should only be made when instructed to do so by your account
manager.*/
s.visitorNamespace = "yourNamespace";
s.trackingServer="metrics.mysite.com" //Use only if using first party cookies
s.trackingServerSecure="smetrics.mysite.com" // Use only if using first party cookies in
                                             // conjunction with SSL
s.dc = '122';

/************************** PLUGINS SECTION *************************/
/* Insert any plugins code you want to use here. */

/****************************** MODULES *****************************/
/* Insert the media module tracking code here. */

Business.Adobe.com リソース