从里程碑迁移到 Media Analytics migrating-from-milestone-to-media-analytics
概述 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
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
或
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