從獨立 Media SDK 移轉至 Adobe Launch - Web (JS)

NOTE
Adobe Experience Platform Launch 已經過品牌重塑,現在是 Experience Platform 中的一套資料收集技術。 因此,所有產品文件中出現了幾項術語變更。 如需術語變更的彙整參考資料,請參閱以下文件

功能差異

  • 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 擴充功能

  1. 在 Experience Platform Launch 中,按一下您 Web 屬性的「擴充功能」
    標籤。

  2. 在「編目」標籤上,找到 Adobe Media Analytics for Audio and
    Video 擴充功能,然後按一下「安裝」。

  3. 在擴充功能設定頁面中,設定追蹤參數。Media 擴充功能會使用已設定的參數進行追蹤。

Launch 使用手冊 - 安裝和設定媒體擴充功能

追蹤器建立差異

Media SDK

  1. 將 Media Analytics 程式庫新增至您的開發專案。
  2. 建立設定物件 (MediaHeartbeatConfig)。
  3. 實施委派通訊協定,公開 getQoSObject()getCurrentPlaybackTime() 函數。
  4. 建立 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 擴充功能:

  1. 使用網頁中的媒體追蹤 API。

    在此案例中,Media Analytics 擴充功能會將媒體追蹤 API 匯出至全域視窗物件中已設定的變數:

    code language-none
    window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance
    
  2. 使用其他 Launch 擴充功能的媒體追蹤 API。

    在此案例中,您會使用 get-instancemedia-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 常數。

相關文件

Media SDK

Launch

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb