從里程碑移轉至 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 金鑰:playerName;
API 金鑰: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:Pod 內播放廣告的位置。
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