Show Menu
主题×

设置 JavaScript 3.x

先决条件

  • 获取有效配置参数
    在设置 Analytics 帐户后,您可以从 Adobe 代表处获取这些参数。
  • 在媒体应用程序中实施适用于 JavaScript 的
    AppMeasurement
    Experience Cloud Identity Service
    有关更多信息,请参阅 使用 JavaScript 实施 Analytics 实施 Experience Cloud Identity Service。
  • 在媒体播放器中提供以下功能:
    • 用于订阅播放器事件的 API
      - Media SDK 要求在播放器中发生事件时调用一组简单的 API。
    • 提供播放器信息的 API
      - 其中包括有关当前播放的媒体、广告、章节的信息。
  1. 下载 的库添加到您的项目中。为方便起见,请创建对类的本地引用。
    1. 展开您下载的
      MediaSDK-js-v3*.zip
      文件。
    2. 验证
      MediaSDK.js
      文件存在于
      libs
      目录中。
    3. 托管
      MediaSDK.js
      文件。
      此核心 JavaScript 文件必须在一个您站点的所有页面都能访问的 Web 服务器上托管。您需要具有这些文件的路径才能进行下一步操作。
    4. 在所有网站页面上引用
      MediaSDK.js
      通过将下面一行代码添加到每个页面的
      <head>
      <body>
      标记中,加入适用于 JavaScript 的
      MediaSDK
      。例如:
      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.js"></script>
    5. 要快速验证是否成功导入了库,请检查
      ADB.Media
      是否已在窗口对象上导出。
      JavaScript SDK 遵循 AMD 和 CommonJS 模块规范,并且
      MediaSDK.js
      也可以与兼容的模块加载器一起使用。
  2. 创建
    AppMeasurement
    实例并配置
    visitor
    Media SDK 配置需要一个已配置
    visitor
    AppMeasurement
    实例。
    var appMeasurement = new AppMeasurement(“<rsid>”); appMeasurement.visitor = visitor; appMeasurement.trackingServer = “<visitor_namespace>.sc.omtrdc.net”;
  3. 配置 Media SDK
    应该为每个网页配置一次 Media SDK,并且该配置适用于创建的所有跟踪器实例。
    Media SDK (3.x) 使用媒体收集 API 跟踪媒体,该 API 与 2.x SDK 中使用的 HB 端点不同。请与 Adobe 代表联系以获取更多信息。
    以下是
    MediaConfig
    初始化示例:
    // Create MediaConfig object (same as above) var mediaConfig = new ADB.MediaConfig(); mediaConfig.trackingServer = Configuration.MEDIA_COLLECTION_ENDPOINT; mediaConfig.playerName = Configuration.PLAYER_NAME; mediaConfig.channel = Configuration.CHANNEL; mediaConfig.appVersion = Configuration.APP_VERSION; mediaConfig.debugLogging = false; mediaConfig.ssl = true; ADB.Media.configure(mediaConfig, appMeasurement);
  4. 创建
    MediaTracker
    实例。
    配置 Media SDK 后,可以使用
    getInstance
    API 创建用于跟踪媒体内容的跟踪器实例。
    var tracker = ADB.Media.getInstance();
    在媒体会话结束前,请确保您的
    tracker
    实例可以访问且未被取消分配。此实例将用于跟踪该会话的以下所有事件。

从 JavaScript 2.x 迁移到 3.x

有关从 2.x 迁移到 3.x 的详细信息,请参阅 从 2.x 迁移到 3.x