ビデオイベントの追跡には、いくつかの方式を使用できます。そのうち 2 つは古いバージョンの Adobe Analytics 用のレガシーオプションで、レガシーマイルストーンとレガシー秒と呼ばれます。
次に進む前に、AEM に再生可能なビデオがアップロードされていることを確認してください。
ページ上でビデオを再生できるようにするには、AEM でビデオファイルをトランスコードする方法について、こちらのチュートリアルを参照してください。
各方式を使用してビデオトラッキングのフレームワークを設定するには、以下の手順を実行します。
新規実装の場合は、ビデオトラッキングにレガシーオプションを使用しないことを推奨します。代わりにマイルストーン方式を使用してください。
サイドキックからビデオコンポーネントをドラッグし、再生可能なビデオをそのコンポーネントのアセットとして追加することによって、Web ページを設定します。
Adobe Analyticsの設定とフレームワークを作成します。
フレームワークページで、RSIDを選択し、使用方法を「all」に設定します。 (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は、 でマイルストーンがトリガされる2番目の値を表します |
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プロパティにマップするには、ContentFinderからコンポーネント上のCQ変数の横にあるAdobe Analyticsプロパティをドラッグします。
マッピングの最適化について詳しくは、『Adobe Analyticsでのビデオの測定ガイド』を参照してください。
追加 frameworktoページ。
プレビューモードで設定をテストするには、ビデオを再生して、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などの適切なツールを使用します。
DigitalPulse Debuggerで表示する場合、前述の例を使用したAdobe Analyticsへの呼び出しは次のようになります。
これは、次の値を含む、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プロパティにマップするには、ContentFinderからコンポーネント上のCQ変数の横にあるAdobe Analyticsプロパティをドラッグします。
マッピングの最適化について詳しくは、『Adobe Analyticsでのビデオの測定ガイド』を参照してください。
追加 frameworktoページ。
プレビューモードで設定をテストするには、ビデオを再生して、Adobe Analyticsからのトリガーへのコールを受け取ります。
この方式は、マイルストーン方式によく似ていますが、「追跡オフセット」**フィールドに指定するマイルストーンが、ビデオ内の設定ポイントではなく割合であるという点が異なります。
「追跡オフセット」フィールドには、1~100 の整数を含むコンマ区切りリストのみを指定できます。
追跡オフセットを設定します。
また、Adobe Analyticsに送信される情報はカスタマイズが容易で、マッピングに使用できる変数は3つのみです。
eventdata.videoName |
これにマッピングされる変数は、DAMに設定されている場合、ビデオのユーザーにわかりやすい名前(タイトル)を含みます。タイトルが設定されていない場合は、ビデオのファイル名が代わりに送信されます。 ビデオの再生開始時に一度だけ送信されます。 |
eventdata.videoFileName | このプロパティにマッピングされる変数には、ファイルの名前が格納されます。ビデオの再生開始時に一度だけ送信されます。 |
eventdata.videoFilePath | このプロパティにマッピングされる変数には、ファイルのサーバー上のパスが格納されます。ビデオの再生開始時に一度だけ送信されます。 |
DAMで編集するビデオを開き、タイトルメタデータフィールドを目的の名前に設定することで、ビデオのユーザーにわかりやすい名前を設定できます。 また、終了したら、変更内容を保存する必要があります。
これらの変数を 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オフセットフィールドで指定されます。
トラックのオフセットを任意の秒数に設定します。
「追跡オフセット」フィールドに指定できるのは、0 より大きい整数だけです。
Adobe Analyticsに送信される情報はカスタマイズが容易です。 マッピングに使用できる変数は次の 3 つだけです。
eventdata.videoName |
これにマッピングされる変数は、DAMに設定されている場合、ビデオのユーザーにわかりやすい名前(タイトル)を含みます。タイトルが設定されていない場合は、ビデオのファイル名が代わりに送信されます。 ビデオの再生開始時に一度だけ送信されます。 |
eventdata.videoFileName | このプロパティにマッピングされる変数には、ファイルの名前が格納されます。ビデオの再生開始時に一度だけ送信されます。 |
eventdata.videoFilePath | このプロパティにマッピングされる変数には、ファイルのサーバー上のパスが格納されます。ビデオの再生開始時に一度だけ送信されます。 |
DAMで編集するビデオを開き、タイトルメタデータフィールドを目的の名前に設定することで、ビデオのユーザーにわかりやすい名前を設定できます。 また、終了したら、変更内容を保存する必要があります。
これらの変数を prop1、prop2 および prop3 にマッピングします。
呼び出しの中のその他の関連情報は、pev3 というひとつの変数に連結されて送信されます。
DigitalPulse Debuggerで表示する場合、前述の例を使用したAdobe Analyticsへの呼び出しは次のようになります。
この呼び出しは、前述のレガシーマイルストーン呼び出しと同じです。こちらの pev3 に関する情報を参照してください。
このチュートリアルで使用しているリファレンス:
[0] https://docs.adobe.com/content/help/ja-JP/media-analytics/using/media-overview.html