从独立 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-instancemedia-heartbeat 共享模块公开的媒体跟踪 API。

    注意

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

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

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

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

相关文档

Media SDK

Launch

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now