從里程碑移轉至 Media Analytics migrating-from-milestone-to-media-analytics

Last update: Mon Jul 14 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 金鑰：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