有効な設定パラメーターを取得 これらのパラメーターは、Analytics アカウントの設定後、アドビの担当者から取得できます。
JavaScript 向けAppMeasurement
をメディアアプリケーションに実装 Adobe Mobile SDK のドキュメントについて詳しくは、JavaScript を使用した Analytics の実装を参照してください。
メディアプレーヤーで以下の機能を設定します。
ダウンロードしたライブラリをプロジェクトに追加します。利便性のために、クラスへのローカル参照を作成します。
ダウンロードした MediaSDK-js-v2.*.zip
ファイルを展開します。
libs
ディレクトリに MediaSDK.min.js
ファイルが存在することを確認します。
MediaSDK.min.js
ファイルをホストします。
このコア JavaScript ファイルは、サイトのすべてのページから参照可能な Web サーバーでホストする必要があります。次の手順で、これらのファイルへのパス情報が必要になります。
サイトのすべてのページから MediaSDK.min.js
を参照します。
各ページの <head>
タグまたは <body>
タグに以下のコードを追加して、JavaScript 用の MediaSDK
を含めます。例:
<script type="text/javascript"
src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.min.js"></script>
ライブラリが正しくインポートされたことをすばやく確認するには、ADB.va.MediaHeartbeatConfig
クラスをインスタンス化します。
バージョン 2.1.0 以降の JavaScript SDK は、AMD および CommonJS モジュールの仕様に準拠しており、互換性のあるモジュールローダーと共に VideoHeartbeat.min.js
を使用することもできます。
API に簡単にアクセスできるように、MediaHeartbeat
クラスへのローカル参照を作成します。
var MediaHeartbeat = ADB.va.MediaHeartbeat;
var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;
MediaHeartbeatConfig
インスタンスを作成します。
ここでは、MediaHeartbeat
設定パラメーターと、正確な追跡のために MediaHeartbeat
インスタンスに正しい設定値を設定する方法について説明します。
MediaHeartbeatConfig
初期化のサンプル:
//Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.trackingServer = Configuration.HEARTBEAT.TRACKING_SERVER;
mediaConfig.playerName = Configuration.PLAYER.NAME;
mediaConfig.channel = Configuration.HEARTBEAT.CHANNEL;
mediaConfig.debugLogging = true;
mediaConfig.appVersion = Configuration.HEARTBEAT.SDK;
mediaConfig.ssl = false;
mediaConfig.ovp = Configuration.HEARTBEAT.OVP;
MediaHeartbeatDelegate
プロトコルを実装します。
var mediaDelegate = new MediaHeartbeatDelegate();
// Replace <currentPlaybackTime> with the video player current playback time
mediaDelegate.getCurrentPlaybackTime = function() {
return <currentPlaybackTime>;
};
// Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values.
mediaDelegate.getQoSObject = function() {
return MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
};
MediaHeartbeat
インスタンスを作成します。
MediaHeartbeatConfig
および MediaHeartbeatDelegate
を使用して、MediaHeartbeat
インスタンスを作成します。
this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);
MediaHeartbeat
インスタンスがアクセス可能であることと、メディアセッションの終わりまで解放されないことを確認します。このインスタンスは、以下のすべてのトラッキングイベントに使用されます。
MediaHeartbeat
が Adobe Analytics に呼び出しを送信するためには、AppMeasurement
のインスタンスが必要です。以下に、AppMeasurement
インスタンスの例を示します。
var appMeasurement = new AppMeasurement();
appMeasurement.visitor = visitor;
appMeasurement.trackingServer = "<visitor_namespace>.sc.omtrdc.net";
appMeasurement.account = <rsid>;
appMeasurement.pageName = <page_name>;
appMeasurement.charSet = "UTF8";
バージョン 2.x では、すべてのパブリックメソッドは、開発をより簡単にするために、ADB.va.MediaHeartbeat
クラスに統合されています。また、すべての設定は、ADB.va.MediaHeartbeatConfig
クラスに統合されました。
1.x から 2.x への移行について詳しくは、VHL 1.x から 2.x への移行を参照してください。