Adobe Analytics のビデオトラッキングの設定

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

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

共通の手順

1. サイドキックから​ビデオコンポーネント​をドラッグし、再生可能なビデオをそのコンポーネントの​アセットとして​追加することによって、Web ページを設定します。

2. Adobe Analyticsの設定とフレームワークを作成します。

   • 以降の節の例では、設定には​my-sc-configuration​という名前を、フレームワークには​videofw​を使用します。

3. フレームワークページで、RSIDを選択し、使用方法を「all」に設定します。 (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

4. サイドキックの「一般」コンポーネントカテゴリから、ビデオコンポーネントをフレームワークにドラッグします。

5. トラッキング方式を選択します。

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

6. トラッキング方式を選択すると、それに従って CQ 変数のリストが変更されます。コンポーネントをさらに設定し、CQ変数をAdobe Analyticsのプロパティにマッピングする方法については、次の節を参照してください。

マイルストーン

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

マイルストーン方式を使用するには、時間ベースの追跡オフセットを指定して、マイルストーンを定義します。ビデオ再生がマイルストーンを渡すと、ページはAdobe Analyticsを呼び出してイベントを追跡します。 定義したマイルストーンごとに、Adobe Analyticsプロパティにマップできる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 変数	Adobe Analytics特性
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は、 でマイルストーンがトリガされる2番目の値を表します
eventdata.a.contentType	すべてのマイルストーンで送信され、は、Adobe Analytics呼び出しでpev3として表示され、通常は「video」 として送信されます。
eventdata.a.media.name	eventdata.videoName とまったく同じです。
eventdata.a.media.segment	表示されているセグメントに関する情報（例：2:O:4-8）を格納します。

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

   4,8,16,20,24
   

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

2. CQ変数をAdobe Analyticsプロパティにマップするには、ContentFinderからコンポーネント上のCQ変数の横にあるAdobe Analyticsプロパティをドラッグします。

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

3. 追加 frameworktoページ。

4. プレビューモード​で設定をテストするには、ビデオを再生して、Adobe Analyticsからのトリガーへのコールを受け取ります。

以下のAdobe Analyticsトラッキングデータの例は、4,8,16,20, 24のトラックオフセットと、CQ変数に対する次のマッピングを使用したマイルストーントラッキングに適用されます。

CQ 変数	Adobe Analytics特性
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

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

DigitalPulse Debuggerで表示する場合、前述の例を使用したAdobe Analyticsへの呼び出しは次のようになります。

これは、次の値を含む、Adobe Analyticsに対する​最初の呼び出しです。

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

これは Adobe Analytics への​3 回目の呼び出​しです。

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

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

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

• ビデオ再生がマイルストーンを渡すと、ページはAdobe Analyticsを呼び出してイベントを追跡します。
• Adobe Analyticsプロパティとのマッピング用に定義されたCQ変数](#cqvars)の[静的セットです。
• 定義したマイルストーンごとに、Adobe Analyticsプロパティにマップできる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変数をAdobe Analyticsプロパティにマップするには、ContentFinderからコンポーネント上のCQ変数の横にあるAdobe Analyticsプロパティをドラッグします。

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

3. 追加 frameworktoページ。

4. プレビューモード​で設定をテストするには、ビデオを再生して、Adobe Analyticsからのトリガーへのコールを受け取ります。

レガシーマイルストーン

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

1. 追跡オフセットを設定します。

   • 例：10,50,75,100

   また、Adobe Analyticsに送信される情報はカスタマイズが容易で、マッピングに使用できる変数は3つのみです。

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

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

   呼び出しの​残りの関連情報​は、pev3​という名前の​1つの​変数に連結されて送信されます。

   前述の例を使用したAdobe Analyticsへの 呼び出しの例は、DigitalPulse Debuggerで表示した場合、次のようになります。

   

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

   • 名前 — ビデオファイル(film.avi)の名前。

   • 長さ — ビデオファイルの長さ（秒単位）(100)

   • プレーヤー名 — ビデオファイルの再生に使用するビデオプレーヤー(HTML5ビデオ)

   • 再生秒数合計 — ビデオが再生された秒数の合計(25)

   • 開始のタイムスタンプ — ビデオ再生がいつ開始したかを識別するタイムスタンプ(1331035567)

   • 再生セッション — 再生セッションの詳細。このフィールドは、ユーザーによるビデオの操作を示します。例えば、ビデオの再生開始場所、ビデオの前進にビデオスライダーを使用したかどうか、ビデオの再生を停止した場所（L10E24S58L58 — ビデオが1秒で停止された場合）などのデータが含まれます。セクションL10の25、次に秒にスキップ48)

レガシー秒

「レガシー秒」メソッドを使用すると、Adobe Analyticsの呼び出しはN秒ごとにトリガされます。ここで、NはTrackオフセットフィールドで指定されます。

1. トラックのオフセットを任意の秒数に設定します。

   • 例：6
   メモ

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

   Adobe Analyticsに送信される情報はカスタマイズが容易です。 マッピングに使用できる変数は次の 3 つだけです。

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

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

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

   DigitalPulse Debuggerで表示する場合、前述の例を使用したAdobe Analyticsへの呼び出しは次のようになります。

   

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

このチュートリアルで使用しているリファレンス：

[0] https://docs.adobe.com/content/help/ja-JP/media-analytics/using/media-overview.html