現在表示中:

ビデオイベントの追跡には、いくつかの方式を使用できます。そのうち 2 つは古いバージョンの SiteCatalyst 用のレガシーオプションで、レガシーマイルストーンとレガシー秒と呼ばれます。

注意:

次に進む前に、 AEM に再生可能なビデオがアップロードされていることを確認してください。

ページ上でビデオを再生できるようにするには、AEM でビデオファイルをトランスコードする方法について、こちらのチュートリアルを参照してください。

各方式を使用してビデオトラッキングのフレームワークを設定するには、以下の手順を実行します。 

注意:

新規実装の場合は、ビデオトラッキングにレガシーオプションを使用しないことを推奨します。 代わりにマイルストーン方式を使用してください。

 

 

共通の手順

  1. サイドキックからビデオコンポーネントをドラッグし、再生可能なビデオをそのコンポーネントのアセットとして追加することによって、Web ページを設定します。
  2. SiteCatalyst の設定とフレームワークを作成します。
    • 以降のセクションの例では、設定には my-sc-configuration、フレームワークには videofw という名前を使用します。
  3. フレームワークページで RSID を選択し、「使用状況」を「すべて」に設定します(http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)。
  4. サイドキックの「一般」コンポーネントカテゴリから、ビデオコンポーネントをフレームワークにドラッグします。
  5. トラッキング方式を選択します。
  6. トラッキング方式を選択すると、それに従って CQ 変数のリストが変更されます。コンポーネントの詳細設定方法および CQ 変数と SiteCatalyst プロパティのマッピング方法については、以降のセクションを参照してください。

マイルストーン

マイルストーン方式では、ビデオに関する大部分の情報を追跡します。高度なカスタマイズが可能で、設定が容易です。

マイルストーン方式を使用するには、時間ベースの追跡オフセットを指定して、マイルストーンを定義します。ビデオの再生がマイルストーンを通過すると、そのイベントを追跡するためにページが SiteCatalyst を呼び出します。定義したマイルストーンごとに、SiteCatalyst プロパティにマッピングできる CQ 変数が作成されます。これらの CQ 変数の名前には、次の形式を使用します。

eventdata.events.milestoneXX

XX というサフィックスは、マイルストーンを定義する追跡オフセットです。例えば、4、8、16、20 および 28 秒の追跡オフセットを指定すると、以下の CQ 変数が生成されます。

  • eventdata.events.milestone4
  • eventdata.events.milestone8
  • eventdata.events.milestone16
  • eventdata.events.milestone20
  • eventdata.events.milestone28

次の表に、マイルストーン方式用に提供されているデフォルトの CQ 変数を示します。

CQ 変数 SiteCatalyst プロパティ
eventdata.videoName  DAM で設定されている場合、このプロパティにマッピングされる変数にはビデオのわかりやすい名前(タイトル)が格納されます。設定されていない場合は、代わりにビデオのファイル名が送信されます。ビデオの再生開始時に一度だけ送信されます。
eventdata.videoFileName  このプロパティにマッピングされる変数には、ファイルの名前が格納されます。eventdata.events.a.media.view と一緒にのみ送信されます。
eventdata.videoFilePath  このプロパティにマッピングされる変数には、ファイルのサーバー上のパスが格納されます。eventdata.events.a.media.view と一緒にのみ送信されます。
eventdata.events.a.media.segmentView    セグメントマイルストーンを通過するたびに送信されます。
eventdata.events.a.media.timePlayed マイルストーンがトリガーされるたびに送信されます。ユーザーが特定のセグメントの視聴に費やした秒数も、このイベントと一緒に送信されます(例:eventX=21)。
eventdata.events.a.media.view  ビデオビューの初期化時に送信されます。
eventdata.events.a.media.complete    ビデオの再生終了時に送信されます。
eventdata.events.milestoneX  特定のマイルストーンを通過したときに送信されます。X はマイルストーンがトリガーされる秒を表します。
eventdata.a.contentType  マイルストーンごとに送信されます。SiteCatalyst 呼び出しでは pev3 として表示され、通常は「video」として送信されます。
eventdata.a.media.name  eventdata.videoName とまったく同じです。
eventdata.a.media.segment  表示されているセグメントに関する情報(例:2:O:4-8)を格納します。

注意:

編集するビデオを DAM で開き、「タイトル」メタデータフィールドを目的の名前に設定することにより、ビデオのわかりやすい名前を設定できます。

  1. 「オフセットを追跡」ボックスで、トラッキング方式としてマイルストーンを選択してから、秒単位の追跡オフセットのコンマ区切りリストを入力します。例えば、次の値はビデオの開始から 4、8、16、20 および 28 秒後にマイルストーンを定義します。

    4,8,16,20,24

    オフセット値は、0 より大きい整数でなければなりません。デフォルト値は 10,25,50,75 です。

  2. CQ 変数を SiteCatalyst プロパティにマッピングするには、CQ 変数の横のコンテンツファインダーから SiteCatalyst プロパティをコンポーネント上にドラッグします。

    マッピングの最適化については、SiteCatalyst でのビデオの測定ガイドを参照してください。

  3. ページにフレームワークを追加します。

  4. 設定をプレビューモードでテストするには、ビデオを再生して SiteCatalyst 呼び出しをトリガーします。

以降の SiteCatalyst のデータ追跡例では、4、8、16、20 および 24 の追跡オフセットを使用したマイルストーントラッキングと、CQ 変数に対する以下のマッピングが適用されます。

CQ 変数 SiteCatalyst プロパティ
eventdata.videoName  prop2
eventdata.videoFileName  prop3 
eventdata.videoFilePath  prop4
eventdata.events.a.media.segmentView    event1
eventdata.events.a.media.timePlayed event2
eventdata.events.a.media.view  event3
eventdata.events.a.media.complete    event4
eventdata.events.milestone4 event10
eventdata.events.milestone8 event11
eventdata.events.milestone16 event12
eventdata.events.milestone20 event13
eventdata.events.milestone24 event14
eventdata.a.contentType  eVar3
eventdata.a.media.name  eVar1, prop1 
eventdata.a.media.segment  eVar2

この例では、ビデオコンポーネントはフレームワークページに次のように表示されます。

注意:

SiteCatalyst への呼び出しを確認するには、DigitalPulse Debugger や Fiddler など適切なツールを使用してください。

この例を使用した SiteCatalyst への呼び出しは、DigitalPulse Debugger では次のように表示されます。

これは SiteCatalyst への最初の呼び出しで、次の値が含まれています。

  • eventdata.a.media.name に対する prop1 と eVar1
  • prop2 ~ 4、および contentType(video)と segment(1:O:1-4)を格納している eVar2 と eVar3
  • eventdata.events.a.media.view にマッピングされた event3

これは SiteCatalyst への 3 回目の呼び出しです。

  • prop1 と eVar1 には a.media.name が格納されている
  • セグメントが表示されたことによって event1 が送信された
  • 再生時間 = 4 で event2 が送信された
  • eventdata.events.milestone8 に到達したことによって event11 送信された
  • (eventdata.events.a.media.view がトリガーされなかったので)prop2 ~ 4 は送信されない

非レガシーマイルストーン

非レガシーマイルストーン方式は、マイルストーン方式によく似ていますが、マイルストーンを計測の長さの割合に基づいて定義する点が異なります。次の点は共通です。

  • ビデオの再生がマイルストーンを通過すると、そのイベントを追跡するためにページが SiteCatalyst を呼び出します。
  • SiteCatalyst プロパティとのマッピング用に定義される CQ 変数の静的セット
  • 定義したマイルストーンごとに、SiteCatalyst プロパティにマッピングできる CQ 変数が作成されます。

これらの CQ 変数の名前には、次の形式を使用します。

XX というサフィックスは、マイルストーンを定義する計測の長さの割合です。例えば、10、25、50 および 75 という割合を指定すると、以下の CQ 変数が生成されます。

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX
  1. 「オフセットを追跡」ボックスで、トラッキング方式として非レガシーマイルストーンを選択してから、計測の長さの割合のコンマ区切りリストを入力します。例えば、次のデフォルト値は計測の長さの 10、25、50 および 75% でマイルストーンを定義します。

    10,25,50,75

    オフセット値は、0 より大きい整数でなければなりません。

  2. CQ 変数を SiteCatalyst プロパティにマッピングするには、CQ 変数の横のコンテンツファインダーから SiteCatalyst プロパティをコンポーネント上にドラッグします。

    マッピングの最適化については、SiteCatalyst でのビデオの測定ガイドを参照してください。

  3. ページにフレームワークを追加します。

  4. 設定をプレビューモードでテストするには、ビデオを再生して SiteCatalyst 呼び出しをトリガーします。

レガシーマイルストーン

この方式は、マイルストーン方式によく似ていますが、「追跡オフセット」フィールドに指定するマイルストーンが、ビデオ内の設定ポイントではなく割合であるという点が異なります。

注意:

「追跡オフセット」フィールドには、1 ~ 100 の整数を含むコンマ区切りリストのみを指定できます。

  1. 追跡オフセットを設定します。
    • 例:10,50,75,100

また、SiteCatalyst に送信される情報は、あまり大きくカスタマイズできません。マッピングに使用できる変数は次の 3 つだけです。

eventdata.videoName 
DAM で設定されている場合、このプロパティにマッピングされる変数にはビデオのわかりやすい名前(タイトル)が格納されます。設定されていない場合は、代わりにビデオのファイル名が送信されます。ビデオの再生開始時に一度だけ送信されます。
eventdata.videoFileName  このプロパティにマッピングされる変数には、ファイルの名前が格納されます。 ビデオの再生開始時に一度だけ送信されます。
eventdata.videoFilePath  このプロパティにマッピングされる変数には、ファイルのサーバー上のパスが格納されます。 ビデオの再生開始時に一度だけ送信されます。

注意:

編集するビデオを DAM で開き、「タイトル」メタデータフィールドを目的の名前に設定することにより、ビデオのわかりやすい名前を設定できます。また、終了したら、変更内容を保存する必要があります。

  1. これらの変数を prop1 ~ 3 にマッピングします。

呼び出しの中のその他の関連情報は、pev3 という 1 つの変数に連結されて送信されます。

この例を使用した SiteCatalyst へのサンプルの呼び出しは、DigitalPulse Debugger では次のように表示されます。

この呼び出しで送信される pev3 変数には、以下の情報が格納されます。

  • Name - ビデオファイルの名前(例:film.avi
  • Length - 秒単位でのビデオファイルの長さ(例:100
  • Player Name - ビデオファイルの再生に使用されるビデオプレーヤー(例:HTML5 video
  • Total Seconds Played - ビデオが再生された合計秒数(例:25
  • Start Timestamp - ビデオの再生がいつ開始されたかを識別するタイムスタンプ(例:1331035567
  • Play Session - 再生セッションの詳細。このフィールドは、ユーザーによるビデオの操作を示します。ビデオの再生を開始した場所、ビデオを進めるためにビデオスライダーを使用したかどうか、ビデオの再生を停止した場所などのデータを含めることができます(例:L10E24S58L58 – ビデオはセクション L10 の 25 秒で停止され、48 秒までスキップされました)。

注意:

レガシービデオトラッキングの実装方法について詳しくは、こちらのリンク を参照してください。[1]

レガシー秒

レガシー秒方式を使用すると、N 秒ごとに SiteCatalyst 呼び出しがトリガーされます。N は「追跡オフセット」フィールドで指定します。

  1. 追跡オフセットを任意の秒数に設定します。
    • 例:6

注意:

「追跡オフセット」フィールドに指定できるのは、0 より大きい整数だけです。

SiteCatalyst に送信される情報は、あまり大きくカスタマイズできません。マッピングに使用できる変数は次の 3 つだけです。

eventdata.videoName 
DAM で設定されている場合、このプロパティにマッピングされる変数にはビデオのわかりやすい名前(タイトル)が格納されます。設定されていない場合は、代わりにビデオのファイル名が送信されます。ビデオの再生開始時に一度だけ送信されます。
eventdata.videoFileName  このプロパティにマッピングされる変数には、ファイルの名前が格納されます。 ビデオの再生開始時に一度だけ送信されます。
eventdata.videoFilePath  このプロパティにマッピングされる変数には、ファイルのサーバー上のパスが格納されます。 ビデオの再生開始時に一度だけ送信されます。

注意:

編集するビデオを DAM で開き、「タイトル」メタデータフィールドを目的の名前に設定することにより、ビデオのわかりやすい名前を設定できます。また、終了したら、変更内容を保存する必要があります。

  1. これらの変数を prop1、prop2 および prop3 にマッピングします。

呼び出しの中のその他の関連情報は、pev3 というひとつの変数に連結されて送信されます。

この例を使用した SiteCatalyst への呼び出しは、DigitalPulse Debugger では次のように表示されます。

この呼び出しは、前述のレガシーマイルストーン呼び出しと同じです。こちらの pev3 に関する情報を参照してください。

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー