从里程碑迁移到 Media Analytics migrating-from-milestone-to-media-analytics

Last update: Tue Jul 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

用户
管理员
开发人员

概述 overview

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

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

迁移指南 migration-guide

变量引用

里程碑量度

变量类型

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)

不适用

跟踪调用频率是自动设置的。

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb