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 変数の横のコンテンツファインダーから 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 変数の横のコンテンツファインダーから Adobe Analytics プロパティをコンポーネント上にドラッグします。

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

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

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

レガシーマイルストーン

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

1. トラックオフセットを設定します。

   • 例：10,50,75,100

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

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

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

   この例を使用した Adobe Analytics への​呼び出しサンプル​は、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 秒までスキップされました）。

レガシー秒

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

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

   • 例： 6
   メモ

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

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

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

   The 関連情報の残り を呼び出すと、次に連結されます： 1 つ 名前の付いた変数 pev3.

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

   

   この呼び出しは、上記のレガシーマイルストーン呼び出しに似ています。 pev3 の情報を参照してください。指定された.

このチュートリアルで使用する参照：

[0] https://experienceleague.adobe.com/docs/media-analytics/using/media-overview.html?lang=ja