Adobe Experience Platform Launch已更名为Adobe Experience Platform中的一套数据收集技术。 因此,产品文档中的术语有一些改动。有关术语更改的综合参考,请参阅以下文档。
使用本文档了解有关安装、配置和实施 Adobe Media Analytics (3.x SDK) for Audio and Video 扩展(Media Analytics 扩展)的信息。其中包括使用此扩展构建规则时可用的选项,以及一些示例和指向示例的链接。
Media Analytics (MA) 扩展添加了核心 JavaScript Media SDK (Media 3.x SDK)。此扩展提供了用于添加 Media
指向启用了标记的网站或项目的跟踪器实例。 MA 扩展需要使用其他两个扩展:
此扩展随 Media 3.x SDK 一起部署,无法向后兼容 Media 2.x SDK。自2.x被弃用以来,请更新到3.x。
在启用标记的项目中包含上述所有三个扩展后,可以采用以下两种方法之一继续操作:
Media
APIMedia
跟踪器实例上的 API。此实例将通过 MA 扩展公开。安装: 要安装MA扩展,请打开您的扩展资产,然后选择 “扩展”>“目录”,将光标悬停在 适用于音频和视频的Adobe Medium Analytics (3.x SDK) 扩展并选择 安装.
配置: 要配置MA扩展,请打开 扩展 选项卡,将鼠标悬停在该扩展上,然后选择 配置:
选项 | 描述 |
---|---|
收集 API 服务器 | 定义媒体收集 API 服务器(请联系 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扩展通过启用中的“Export APIs to Window Object”设置,在全局窗口对象中导出Media API。 配置 页面。 它将在配置的变量名称下导出 API。例如,如果变量名称配置为 ADB
,则 window.ADB.Media
可以访问 Media API。
MA 扩展仅在 window["CONFIGURED_VARIABLE_NAME"]
未定义时才导出 API,并且不会覆盖现有变量。
Media API:window["CONFIGURED_VARIABLE_NAME"].Media
这会公开 Media SDK 中的所有 API 和常量:https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html
创建媒体跟踪器实例:window["CONFIGURED_VARIABLE_NAME"].Media.getInstance
返回值:用于跟踪媒体会话的 Media
跟踪器实例。
var Media = window["CONFIGURED_VARIABLE_NAME"].Media;
var tracker = Media.getInstance();
使用媒体跟踪器实例,按照 JS API 文档来实施媒体跟踪。
您可在此处获得示例播放器:MA 示例播放器。示例播放器作为参考,展示了如何使用 MA 扩展直接从 Web 应用程序支持 Media Analytics。
MA扩展会公开 media
作为共享模块添加到其他扩展。 (有关共享模块的其他信息,请参阅共享模块文档。)
只能从其他扩展访问共享模块。也就是说,网页/JavaScript 应用程序既无法访问共享模块,也无法在扩展之外使用 turbine
(请参阅下面的代码示例)。
Media API:media
共享模块
这会公开 Media SDK 中的所有 API 和常量:https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html
按如下方式创建媒体跟踪器实例:
返回值:用于跟踪媒体会话的 Media
跟踪器实例。
var Media =
turbine.getSharedModule('adobe-media-analytics', 'media');
var tracker = Media.getInstance();
使用媒体跟踪器实例,按照 JS API 文档来实施媒体跟踪。
测试:对于此版本,要测试您的扩展,必须将其上传到 Platform ,您可以在其中访问所有依赖的扩展。