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

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

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

共通の手順

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

2. Adobe Analyticsの設定とフレームワークの作成を参照してください。

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

3. フレームワークページで、RSIDを選択し、使用方法を「すべて」に設定します。 (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 変数を示します。

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

   4,8,16,20,24
   

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

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

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

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

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

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

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

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

これは、次の値を​含む​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変数🔗の静的セット。
• 定義するマイルストーンごとに、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プロパティにマッピングするには、コンポーネント上のCQ変数の横にあるContentFinderからAdobe Analyticsプロパティをドラッグします。

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

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

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

レガシーマイルストーン

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

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

   • 例：10,50,75,100

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

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

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

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

   

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

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

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

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

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

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

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

レガシー秒

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

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

   • 例：6
   メモ

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

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

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

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

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

   

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

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

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