從獨立 Media SDK 移轉至 Adobe Launch - Web (JS)
功能差異
- Launch - Launch 提供您一個 UI，引導您建立、設定和部署網頁型媒體追蹤解決方案。Launch 可改善 Dynamic Tag Management (DTM)。
- Media SDK - Media SDK 提供您專為特定平台 (例如：Android、iOS 等) 所設計的媒體追蹤程式庫。Adobe 建議使用 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 for Audio and
Video 擴充功能，然後按一下「安裝」。 -
在擴充功能設定頁面中，設定追蹤參數。Media 擴充功能會使用已設定的參數進行追蹤。
追蹤器建立差異
Media SDK
- 將 Media Analytics 程式庫新增至您的開發專案。
- 建立設定物件 (
MediaHeartbeatConfig)。 - 實施委派通訊協定，公開
getQoSObject()和getCurrentPlaybackTime()函數。 - 建立 Media Heartbeat 例項 (
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 提供兩種建立追蹤基礎架構的方法。兩種方法都使用 Media Analytics Launch 擴充功能：
-
使用網頁中的媒體追蹤 API。
在此案例中，Media Analytics 擴充功能會將媒體追蹤 API 匯出至全域視窗物件中已設定的變數：
code language-none window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance -
使用其他 Launch 擴充功能的媒體追蹤 API。
在此案例中，您會使用
get-instance和media-heartbeat「共用模組」公開的媒體追蹤 API。note note NOTE 「共用模組」不適用於網頁。您只能使用其他擴充功能的「共用模組」。 使用
get-instance「共用模組」建立MediaHeartbeat例項。
將委派物件傳遞至get-instance公開的getQoSObject()和getCurrentPlaybackTime()函數。code language-none var getMediaHeartbeatInstance = turbine.getSharedModule('adobe-video-analytics', 'get-instance');透過
media-heartbeat「共用模組」存取MediaHeartbeat常數。