从里程碑迁移到 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
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