スタンドアロンの Media SDK から Adobe Launch - Web(JS)への移行
機能の違い
- Launch - Launch は、Web ベースのメディアトラッキングソリューションの設定、構成およびデプロイの手順を示す UI を提供します。Launch は、Dynamic Tag Management(DTM)を改善したものです。
- Media SDK - Media SDK は、特定のプラットフォーム向けに設計されたメディアトラッキングライブラリ(例:Android、iOSなど)を提供します。モバイルアプリケーションでのメディア使用状況を追跡する際には、Media SDK をお勧めします。
設定
スタンドアロンの Media SDK
スタンドアロンの Media SDK では、アプリケーションでトラッキング設定をおこない、トラッカーを作成する際に SDK に渡します。
//Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.trackingServer = "namespace.hb.omtrdc.net";
mediaConfig.playerName = "html5-player";
mediaConfig.channel = "sample-channel";
mediaConfig.ovp = "video-provider";
mediaConfig.appVersion = "v2.0.0"
mediaConfig.ssl = true;
mediaConfig.debugLogging = true;
メディアトラッキングが正しく機能するには、MediaHeartbeat
設定に加えて、ページで AppMeasurement
インスタンスと VisitorAPI
インスタンスを設定して渡す必要があります。
Launch 拡張機能
-
Experience Platform Launch で Web プロパティの「拡張機能」タブをクリックします。
-
「カタログ」タブでオーディオおよびビデオ用 Adobe Media Analytics 拡張機能を探し、「インストール」をクリックします。
-
拡張機能の設定ページで、トラッキングパラメーターを設定します。メディア拡張機能では、設定済みのパラメーターをトラッキングに使用します。
トラッカーの作成の違い
メディア SDK
- 開発プロジェクトに Media Analytics ライブラリを追加します。
- 設定オブジェクト(
MediaHeartbeatConfig
)を作成します。 getQoSObject()
およびgetCurrentPlaybackTime()
を公開する delegate プロトコルを実装します。- メディアハートビートインスタンス(
MediaHeartbeat
)を作成します。
// Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
...
// Configuration settings
mediaConfig.trackingServer = Configuration.HEARTBEAT.TRACKING_SERVER;
...
// Implement Media Delegate (Quality of Service and Playhead)
var mediaDelegate = new MediaHeartbeatDelegate();
...
mediaDelegate.getQoSObject = function() {
return MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
...
}
...
// Create your tracker
this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);
Launch
Launch は、トラッキングインフラストラクチャを作成する 2 つの方法を提供します。いずれの方法でも、Media Analytics Launch 拡張機能を使用します。
-
Web ページからメディアトラッキング API を使用します。
このシナリオでは、Media Analytics 拡張機能が、グローバルウィンドウオブジェクトの設定済み変数にメディアトラッキング API をエクスポートします。
code language-none window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance
-
別の Launch 拡張機能のメディアトラッキング API を使用します。
このシナリオでは、
get-instance
およびmedia-heartbeat
共有モジュールで公開されているメディアトラッキング API を使用します。note note NOTE 共有モジュールは Web ページでは使用できません。他の拡張機能の共有モジュールのみを使用できます。 get-instance
共有モジュールを使用してMediaHeartbeat
インスタンスを作成します。
delegate オブジェクトを、getQoSObject()
およびgetCurrentPlaybackTime()
関数を公開するget-instance
に渡します。code language-none var getMediaHeartbeatInstance = turbine.getSharedModule('adobe-video-analytics', 'get-instance');
media-heartbeat
共有モジュールを使用してMediaHeartbeat
定数にアクセスします。