从里程碑迁移到 Media Analytics

概述

视频测量的核心概念与里程碑和 Media Analytics 相同，后者采用视频播放器事件并将其映射到分析方法，同时捕获播放器元数据和值并将它们映射到分析变量。Media Analytics 解决方案源自里程碑，因此许多方法和量度都与里程碑是相同的，但配置方法和代码发生了显著变化。也可以更新播放器事件代码以指向新的 Media Analytics 方法。有关实施 Media Analytics 的更多详细信息，请参阅 SDK 概述和跟踪概述。

下表提供了“里程碑”解决方案和“Media Analytics”解决方案之间的转换。

迁移指南

变量引用

里程碑量度	变量类型	Media Analytics 量度
内容	eVar 默认过期：访问	内容
内容类型	eVar 默认过期：页面查看	内容类型
内容逗留时间	事件类型：计数器	内容逗留时间
视频初始化	事件类型：计数器	视频初始化
视频结束	事件类型：计数器	内容结束

媒体模块变量

里程碑	里程碑语法	Media Analytics	Media Analytics 语法
Media.trackUsingContextData	`s.Media.trackUsingContextData` `= true;`	不适用	所有 Media Analytics 数据仅使用上下文数据发送。
Media.contextDataMapping	`s.Media.contextDataMapping = {` `"a.media.name":"eVar2,prop2",` `"a.media.segment":"eVar3",` `"a.contentType":"eVar1",` `"a.media.timePlayed":"event3",` `"a.media.view":"event1",` `"a.media.segmentView":"event2",` `"a.media.complete":"event7",` `"a.media.milestones": {` `25:"event4",` `50:"event5",` `75:"event6"` `}` `};`	不适用	Media Analytics 上下文数据会自动填充到保留变量中。实施代码中不再需要映射到 eVar、prop 和事件。客户可以使用处理规则将上下文数据映射到变量。
Media.trackVars	`s.Media.trackVars =` `"events,` `prop2,` `eVar1,` `eVar2,` `eVar3";`	不适用	不再需要，因为映射是通过保留变量和处理规则进行的。
Media.trackEvents	`s.Media.trackEvents =` `"event1,` `event2,` `event3,` `event4,` `event5,` `event6,` `event7"`	不适用	不再需要，因为映射是通过保留变量和处理规则进行的。

可选变量

里程碑	里程碑语法	Media Analytics	Media Analytics 语法
Media.autoTrack	`s.Media.autoTrack` `= true;`	不适用	我们不再提供预建的播放器映射。
Media.autoTrackNetStreams	`s.Media.` `autoTrackNetStreams` `= true`	不适用	我们不再提供预建的播放器映射。
Media.completeByCloseOffset	`s.Media.` `completeByCloseOffset` `= true`	不适用	“内容结束”仅支持 100% 进度标记。
Media.completeCloseOffsetThreshold	`s.Media.` `completeCloseOffsetThreshold` `= 1`	不适用	“内容结束”仅支持 100% 进度标记。
Media.playerName	`s.Media.playerName` `= "Custom Player Name"`	SDK Key: playerName; API Key: media.playerName	`MediaHeartbeatConfig.` `playerName`
Media.trackSeconds	`s.Media.` `trackSeconds` `= 15`	不适用	对于内容，Media Analytics 设置为 10 秒；对于广告，设置为 1 秒。无其他选项可用。
Media.trackMilestones	`s.Media.` `trackMilestones` `= "25,50,75";`	不适用	Media Analytics 始终跟踪 10%、25%、50%、75%、95% 进度标记。
Media.trackOffsetMilestones	`s.Media.` `trackOffsetMilestones` `= "20,40,60";`	不适用	Media Analytics 始终跟踪 10%、25%、50%、75%、95% 进度标记。
Media.segmentByMilestones	`s.Media.segmentByMilestones` `= true;`	不适用	自动跟踪不再可用。
Media.segmentByOffsetMilestones	`s.Media.` `segmentByOffsetMilestones` `= true;`	不适用	自动跟踪不再可用。

广告跟踪变量

里程碑	里程碑语法	Media Analytics	Media Analytics 语法
Media.adTrackSeconds	`s.Media.` `adTrackSeconds` `= 15`	不适用	对于内容，Media Analytics 设置为 10 秒；对于广告，设置为 1 秒。无其他选项可用。
Media.adTrackMilestones	`s.Media.` `adTrackMilestones` `= "25,50,75";`	不适用	默认情况下，广告不提供进度标记。请使用计算量度来构建广告进度标记。
Media.adTrackOffsetMilestones	`s.Media.` `adTrackOffsetMilestones` `= "20,40,60";`	不适用	对于广告，Media Analytics 设置为 1 秒。无其他选项可用。
Media.adSegmentByMilestones	`s.Media.` `adSegmentByMilestones` `= true;`	不适用	自动跟踪不再可用。
Media.adSegmentByOffsetMilestones	`s.Media.` `adSegmentByOffsetMilestones` `= true;`	不适用	自动跟踪不再可用。

媒体模块方法

里程碑	里程碑语法	Media Analytics	Media Analytics 语法
Media.open	`s.Media.open(` `mediaName,` `mediaLength,` `mediaPlayerName)`	trackSessionStart	`trackSessionStart(` `mediaObject,` `contextData)`
mediaName	`mediaName`：（必需）您希望在视频报表中显示的视频名称。	name	`createMediaObject(` `name,` `mediaId,` `length,` `streamType)`
mediaLength	`mediaLength`：（必需）视频的长度，以秒为单位。	length	`createMediaObject(` `name,` `mediaId,` `length,` `streamType)`
mediaPlayerName	`mediaPlayerName`：（必需）您希望在视频报表中显示的用于查看视频的媒体播放器名称。	playerName	`MediaHeartbeatConfig.` `playerName`
Media.openAd	`s.Media.openAd(` `name,` `length,` `playerName,` `parentName,` `parentPod,` `parentPodPosition,` `CPM)`	trackEvent	`mediaHeartbeat.trackEvent(` `MediaHeartbeat.` `Event.` `AdBreakStart,` `adBreakObject);` `...` `trackEvent(` `MediaHeartbeat.` `Event.` `AdStart,` `adObject,` `adCustomMetadata);`
name	`name`：（必需）广告的名称或 ID。	name	`createAdObject(` `name,` `adId,` `position,` `length)`
length	`length`：（必需）广告的长度。	length	`createAdObject(` `name,` `adId,` `position,` `length)`
playerName	`playerName`：（必需）用于查看广告的媒体播放器名称。	playerName	`MediaHeartbeatConfig.` `playerName`
parentName	`parentName`：嵌入了广告的主内容的名称或 ID。	不适用	自动继承。
parentPod	`parentPod`：广告在主内容中播放的位置。	position	`createAdBreakObject(` `name,` `position,` `startTime)`
parentPodPosition	`parentPodPosition`：广告在面板中播放的位置。	position	`createAdObject(` `name,` `adId,` `position,` `length)`
CPM	`CPM`：应用于此播放的 CPM 或加密 CPM（以“~”为前缀）。	不适用	在 Media Analytics 中默认不可用。
Media.click	`s.Media.click(name, offset)`	不适用	使用自定义链接分析调用来跟踪点击次数。
Media.close	`s.Media.close(mediaName)`	trackSessionEnd	`trackSessionEnd()`
Media.complete	`s.Media.complete(name, offset)`	trackComplete	`trackComplete()`
Media.play	`s.Media.play(` `name,` `offset,` `segmentNum,` `segment,` `segmentLength)`	trackPlay	`trackPlay()`
Media.stop	`s.Media.stop(mediaName, mediaOffset)`	trackPause 或 trackEvent	`trackPause()` 或 `trackEvent(` `MediaHeartbeat.` `Event.` `SeekStart)` 或 `trackEvent(` `MediaHeartbeat.` `Event.` `BufferStart);`
Media.monitor	`s.Media.monitor(s, media)`	使用自定义或标准元数据来设置其他变量。	`var customVideoMetadata =` `{` `isUserLoggedIn:` `"false",` `tvStation:` `"Sample TV station",` `programmer:` `"Sample programmer"` `};` `...` `var standardVideoMetadata` `= {};` `standardVideoMetadata` `[MediaHeartbeat.` `VideoMetadataKeys.` `EPISODE] =` `"Sample Episode";` `standardVideoMetadata` `[MediaHeartbeat.` `VideoMetadataKeys.` `SHOW] = "Sample Show";` `...` `mediaObject.setValue(` `MediaHeartbeat.` `MediaObjectKey.` `StandardVideoMetadata,` `standardVideoMetadata);`
Media.track	`s.Media.track(mediaName)`	不适用	跟踪调用频率是自动设置的。