从独立 Media SDK 迁移到 Adobe Launch - Web (JS)

功能差异

• Launch - Launch 为您提供了一个 UI，可引导您设置、配置和部署基于 Web 的媒体跟踪解决方案。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. 创建“媒体心率”实例 (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 导出到全局窗口对象中的已配置变量：

   window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance
   

2. 从另一个 Launch 扩展中使用媒体跟踪 API。

   在此方案中，您将使用由 get-instance 和 media-heartbeat 共享模块公开的媒体跟踪 API。

   注意

   共享模块不可用于网页。您只能从其他扩展中使用共享模块。

   使用 get-instance 共享模块创建 MediaHeartbeat 实例。
   将委派对象传递给公开 getQoSObject() 和 getCurrentPlaybackTime() 函数的 get-instance。

   var getMediaHeartbeatInstance =
   turbine.getSharedModule('adobe-video-analytics', 'get-instance');
   

   通过 media-heartbeat 共享模块访问 MediaHeartbeat 常量。

相关文档

Media SDK

• 设置 JavaScript 2.x
• Media SDK JS API

Launch

• Launch 概述
• Media Analytics 扩展