ビデオイベントの追跡には、いくつかの方法を使用できます。そのうち 2 つは古いバージョンのAdobe Analyticsのレガシーオプションです。 従来のオプションは、レガシーマイルストーンとレガシー秒です。
次に進む前に、AEM に再生可能なビデオがアップロードされていることを確認してください。
ページ上でビデオを再生できるようにするには、AEM でビデオファイルをトランスコードする方法について、こちらのチュートリアルを参照してください。
各方式を使用してビデオトラッキングのフレームワークを設定するには、以下の手順を実行します。
新規実装の場合は、ビデオトラッキングにレガシーオプションを使用しないことを推奨します。以下を使用します。 マイルストーン メソッドを使用します。
サイドキックからビデオコンポーネントをドラッグし、再生可能なビデオをそのコンポーネントのアセットとして追加することによって、Web ページを設定します。
Adobe Analytics 設定およびフレームワークを作成します。
フレームワークページで RSID を選択し、「使用状況」を「すべて」に設定します。(https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
サイドキックの「一般」コンポーネントカテゴリから、ビデオコンポーネントをフレームワークにドラッグします。
トラッキング方式を選択します。
トラッキング方式を選択すると、それに従って 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 はマイルストーンが でトリガーされる秒を表します。 |
eventdata.a.contentType | マイルストーンごとに送信されます。Adobe Analytics 呼び出しでは pev3 として表示され、通常は「video」として送信されます。 |
eventdata.a.media.name | eventdata.videoName とまったく同じです。 |
eventdata.a.media.segment | 表示されたセグメントに関する情報が含まれます(例: 2)。:O:4-8 |
編集するビデオを DAM で開き、「タイトル」メタデータフィールドを目的の名前に設定することにより、ビデオのわかりやすい名前を設定できます。
トラッキング方法として「マイルストーン」を選択した後、「オフセットを追跡」ボックスに、トラッキングオフセットのコンマ区切りリストを秒単位で入力します。 例えば、次の値では、ビデオの開始後の 4、8、16、20、28 秒でマイルストーンを定義しています。
4,8,16,20,24
オフセット値は、0 より大きい整数にする必要があります。 デフォルト値は 10,25,50,75
です。
CQ 変数を Adobe Analytics プロパティにマッピングするには、CQ 変数の横のコンテンツファインダーから Adobe Analytics プロパティをコンポーネント上にドラッグします。
マッピングの最適化については、Adobe Analytics でのビデオの測定ガイドを参照してください。
ページに フレームワークを追加します。
設定をプレビューモードでテストするには、ビデオを再生して 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 |
この例では、ビデオコンポーネントはフレームワークページに次のように表示されます。
Adobe Analytics への呼び出しを確認するには、DigitalPulse Debugger や Fiddler など適切なツールを使用します。
この例を使用した Adobe Analytics への呼び出しは、DigitalPulse Debugger では次のように表示されます。
これは Adobe Analytics への最初の呼び出しであり、次の値が含まれています。
これは Adobe Analytics への3 回目の呼び出しです。
非レガシーマイルストーン方式は、マイルストーン方式に似ていますが、マイルストーンは、トラックの長さの割合を使用して定義される点が異なります。 一般には次のようなものがあります。
これらの CQ 変数の名前は、次の形式を使用します。
XX サフィックスは、マイルストーンを定義するトラックの長さのパーセンテージです。 例えば、10、25、50、75 の割合を指定すると、次の CQ 変数が生成されます。
eventdata.events.milestone10
eventdata.events.milestone25
eventdata.events.milestone50
eventdata.events.milestone75
eventdata.events.milestoneXX
追跡方法として非レガシーマイルストーンを選択した後、「オフセットを追跡」ボックスに、追跡の長さの割合のコンマ区切りリストを入力します。 例えば、次のデフォルト値では、トラックの長さの 10、25、50、75%でマイルストーンを定義しています。
10,25,50,75
オフセット値は、0 より大きい整数にする必要があります。
CQ 変数を Adobe Analytics プロパティにマッピングするには、CQ 変数の横のコンテンツファインダーから Adobe Analytics プロパティをコンポーネント上にドラッグします。
マッピングの最適化については、Adobe Analytics でのビデオの測定ガイドを参照してください。
ページに フレームワークを追加します。
設定をプレビューモードでテストするには、ビデオを再生して Adobe Analytics 呼び出しをトリガーします。
この方式は、マイルストーン方式によく似ていますが、「追跡オフセット」フィールドに指定するマイルストーンが、ビデオ内の設定ポイントではなく割合であるという点が異なります。
「追跡オフセット」フィールドでは、1 ~ 100 の整数を含むコンマ区切りリストのみを使用できます。
トラックオフセットを設定します。
また、Adobe Analytics に送信される情報は、大きくはカスタマイズできません。マッピングに使用できる変数は次の 3 つだけです。
eventdata.videoName |
DAM で設定されている場合、このプロパティにマッピングされる変数にはビデオのわかりやすい 名前(タイトル)が格納されます。設定されていない場合は、代わりにビデオのファイル名が送信されます。ビデオの再生開始時に一度だけ送信されます。 |
eventdata.videoFileName | これにマッピングされる変数には、ファイルの名前が含まれます。 ビデオの再生開始時に一度だけ送信されます。 |
eventdata.videoFilePath | これにマッピングされる変数には、サーバー上のファイルのパスが含まれます。 ビデオの再生開始時に一度だけ送信されます。 |
編集するビデオを DAM で開き、「タイトル」メタデータフィールドを目的の名前に設定することにより、ビデオにわかりやすい名前を設定できます。また、終了したら、変更内容を保存する必要があります。
これらの変数を 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 は「追跡オフセット」フィールドで指定します。
追跡オフセットを任意の秒数に設定します。
「オフセットを追跡」フィールドに指定できるのは、0 より大きい整数のみです
Adobe Analytics に送信される情報のカスタマイズには、制限があります。マッピングに使用できる変数は次の 3 つだけです。
eventdata.videoName |
DAM で設定されている場合、このプロパティにマッピングされる変数にはビデオのわかりやすい 名前(タイトル)が格納されます。設定されていない場合は、代わりにビデオのファイル名が送信されます。ビデオの再生開始時に一度だけ送信されます。 |
eventdata.videoFileName | これにマッピングされる変数には、ファイルの名前が含まれます。 ビデオの再生開始時に一度だけ送信されます。 |
eventdata.videoFilePath | これにマッピングされる変数には、サーバー上のファイルのパスが含まれます。 ビデオの再生開始時に一度だけ送信されます。 |
編集するビデオを DAM で開き、「タイトル」メタデータフィールドを目的の名前に設定することにより、ビデオにわかりやすい名前を設定できます。また、終了したら、変更内容を保存する必要があります。
これらの変数を 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