Show Menu
主题×

适用于音频和视频扩展的Adobe Media Analytics(3.x SDK)

有关安装、配置和实施适用于音频和视频扩展(媒体分析扩展)的Adobe Media Analytics(3.x SDK)的信息,请使用本文档。 其中包括使用此扩展构建规则时可用的选项,以及一些示例和指向示例的链接。
Media Analytics (MA) 扩展添加了核心 JavaScript Media SDK (Media 3.x SDK)。此扩展提供了将 Media 跟踪器实例添加到 Launch 网站或项目的功能。MA 扩展需要使用其他两个扩展:
此扩展随Media 3.x SDK一起部署,它不向后兼容Media 2.x SDK。 如果您的页面已使用Media 2.x SDK,请使 用Adobe Media Analytics for Audio and Video Extension ,而非此扩展。
在 Launch 项目中包含上述所有三个扩展后,可以采用以下两种方法之一继续操作:
  • 使用您的 Web 应用程序中的 Media API
  • 包含或构建特定于播放器的扩展,以便将特定媒体播放器事件映射到 Media 跟踪器实例上的 API。此实例将通过 MA 扩展公开。

安装和配置 MA 扩展

  • 安装: 要安装MA扩展,请打开扩展属性,单 Extensions > Catalog ​击,将指针悬停在 Adobe Media Analytics (3.x SDK) for Audio and Video 该扩展上,然后单击 Install
  • 配置: 要配置MA扩展,请打开选 Extensions 项卡,将指针悬停在扩展上,然后单击 Configure :

配置选项:

选项
描述
集合API服务器
定义Media Collection API Server(请与Adobe代表联系以获取此服务器)
Application Version
媒体播放器应用程序/SDK 的版本
Player Name
正在使用的媒体播放器的名称(例如“AVPlayer”、“HTML5 播放器”、“我的自定义视频播放器”)
Channel
渠道名称属性
Debug Logging
启用或禁用日志记录
Enable SSL
允许或禁止通过 HTTPS 发送 ping
Export APIs to Window Object
允许或禁止将 Media Analytics API 导出到全局范围
Variable Name
window 对象下用于导出 Media Analytics API 的变量
提醒: MA 扩展要求使用 Analytics Experience Cloud ID 扩展。您还必须将这些扩展添加到您的扩展资产并对其进行配置。

使用 MA 扩展

通过网页/JS 应用程序使用

The MA extension exports the Media APIs in the global window object by enabling the "Export APIs to Window Object" setting in the Configuration page. 它将在配置的变量名称下导出 API。For example, if the variable name is configured to be ADB , then Media APIs can be accessed by window.ADB.Media .
MA 扩展仅在 window["CONFIGURED_VARIABLE_NAME"] 未定义时才导出 API,并且不会覆盖现有变量。
  1. 媒体API:   window["CONFIGURED_VARIABLE_NAME"].Media
  2. 创建媒体跟踪器实例:   window["CONFIGURED_VARIABLE_NAME"].Media.getInstance
    返回值: 用于 Media 跟踪媒体会话的跟踪器实例。
    var Media = window["CONFIGURED_VARIABLE_NAME"].Media;
    
    var tracker = Media.getInstance();
    
    
  3. 使用媒体跟踪器实例,按照 JS API文档 ,实现媒体跟踪。
您可在此处获得示例播放器: MA 示例播放器 。示例播放器作为参考,展示了如何使用 MA 扩展直接从 Web 应用程序支持 Media Analytics。

通过其他扩展使用

MA扩展作为共享 media 模块公开给其他扩展。 (有关共享模块的其他信息,请参阅 共享模块文档 。)
只能从其他扩展访问共享模块。That is, a webpage/JavaScript app cannot access the shared modules, or use turbine (see code sample below) outside of an extension.
  1. 媒体API:   media 共享模块
  2. 创建媒体跟踪器实例,如下所示:
    返回值: 用于 Media 跟踪媒体会话的跟踪器实例。
    var Media =
      turbine.getSharedModule('adobe-media-analytics', 'media');
    
    var tracker = Media.getInstance();
    
    
  3. 使用媒体跟踪器实例,按照 JS API文档 ,实现媒体跟踪。
测试: ​对于此版本,要测试您的扩展,必须将其上传到 Adobe Experience Platform Launch ,您可以在其中访问所有依赖的扩展。