從里程碑移轉至自訂連結 migrating-from-milestone-to-custom-link

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

使用者
管理員
開發人員

概觀 overview

「里程碑」和「自訂連結」追蹤的影片測量核心概念相同，也就是擷取影片播放器事件，並對應至分析方法，同時擷取播放器中繼資料和值，將其對應至分析變數。「自訂連結」方法應視為同時減少及簡化實作和收集的資料。使用「自訂連結」解決方案，不會預先定義影片測量的變數或方法，須完全自訂。應可更新播放器事件程式碼，以顯示可能有基本播放器事件 (如開始和結束) 的自訂連結追蹤呼叫。如需詳細資訊，請參閱自訂連結實作指南。

下表為「里程碑」解決方案和「自訂連結」解決方案的對照表。

移轉指南 migration-guide

視訊變數參考資料

里程碑量度

變數類型

自訂連結

內容

eVar
預設過期時間：造訪

定義專屬 eVar。

內容類型

eVar
預設過期時間：頁面檢視

定義專屬 eVar。

內容逗留時間

事件
類型：計數器

定義專屬事件。

影片起始

事件
類型：計數器

定義專屬事件。

影片完成

事件
類型：計數器

定義專屬事件。

媒體模組變數

里程碑

里程碑語法

自訂連結

自訂連結語法

Media.trackUsingContextData

s.Media.trackUsingContextData
= true;

linkTrackVars

s.linkTrackVars
= 'events,
contextData.video.name’;
s.contextData["video.name"]
= mediaName;

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"
}
};

不適用

目前已透過處理規則，將內容資料對應至 eVar、prop 和事件。

Media.trackVars

s.Media.trackVars =
"events,
prop2,
eVar1,
eVar2,
eVar3";

linkTrackVars

s.linkTrackVars
= 'events,
prop10,
eVar10,
eVar12,
eVar13,
eVar15,
contextData.
video.name,
contextData.
video.view';

Media.trackEvents

s.Media.trackEvents =
"event1,
event2,
event3,
event4,
event5,
event6,
event7"

linkTrackEvents

s.linkTrackEvents
= 'event2';

選擇性變數

里程碑

里程碑語法

自訂連結

自訂連結語法

Media.autoTrack

s.Media.autoTrack
= true;

不適用

無法使用。

Media.autoTrackNetStreams

s.Media.
autoTrackNetStreams
= true

不適用

無法使用。

Media.completeByCloseOffset

s.Media.
completeByCloseOffset
= true

不適用

無法使用。

Media.completeCloseOffsetThreshold

s.Media.
completeCloseOffsetThreshold
= 1

不適用

無法使用。

Media.playerName

s.Media.playerName
= "Custom Player Name"

在連結呼叫設定 eVar 或內容資料變數。

s.contextData['video.player']
= "CustomPlayer Name";

Media.trackSeconds

s.Media.
trackSeconds
= 15

不適用

無法使用。

Media.trackMilestones

s.Media.
trackMilestones
= "25,50,75";

不適用

無法使用。

Media.trackOffsetMilestones

s.Media.
trackOffsetMilestones
= "20,40,60";

不適用

無法使用。

Media.segmentByMilestones

s.Media.segmentByMilestones
= true;

不適用

無法使用。

Media.segmentByOffsetMilestones

s.Media.
segmentByOffsetMilestones
= true;

不適用

無法使用。

廣告追蹤變數

里程碑

里程碑語法

自訂連結

自訂連結語法

Media.adTrackSeconds

s.Media.
adTrackSeconds
= 15

不適用

無法使用。

Media.adTrackMilestones

s.Media.
adTrackMilestones
= "25,50,75";

不適用

無法使用。

Media.adTrackOffsetMilestones

s.Media.
adTrackOffsetMilestones
= "20,40,60";

不適用

無法使用。

Media.adSegmentByMilestones

s.Media.
adSegmentByMilestones
= true;

不適用

無法使用。

Media.adSegmentByOffsetMilestones

s.Media.
adSegmentByOffsetMilestones
= true;

不適用

無法使用。

媒體模組方法

里程碑

里程碑語法

自訂連結

自訂連結語法

Media.open

s.Media.open(
mediaName,
mediaLength,
mediaPlayerName)

s.tl()

s.linkTrackVars
= 'events,
prop10,
eVar10,
eVar12,
eVar15,
contextData.video.name,
contextData.video.view';
s.linkTrackEvents
= 'event2';
s.prop10
= mediaName;
s.eVar10
= mediaName;
s.eVar12
= "video";
s.eVar15
= mediaPlayerName;
s.events
= 'event2';
s.contextData['video.name']
= mediaName;
s.contextData['video.view']
= 'true';
s.tl(this,'o','Video Start');

mediaName

mediaName：(必填) 您希望在影片報表中顯示的名稱。

在連結呼叫設定 eVar 或內容資料變數。

s.prop10 = mediaName;
s.eVar10 = mediaName;
s.contextData['video.name']
= mediaName;

mediaLength

mediaLength：(必填) 影片長度 (以秒為單位)。

在連結呼叫設定 eVar 或內容資料變數。

s.contextData['video.length']
= "90";

mediaPlayerName

mediaPlayerName：(必填) 觀看影片所使用的媒體播放器名稱，您希望影片報表中顯示的名稱。

在連結呼叫設定 eVar 或內容資料變數。

s.contextData['video.player']
= "CustomPlayer Name";

Media.openAd

s.Media.openAd(
name,
length,
playerName,
parentName,
parentPod,
parentPodPosition,
CPM)

不適用

無法使用。

name

name：(必填) 廣告名稱或 ID。

不適用

無法使用。

length

length：(必填) 廣告長度。

不適用

無法使用。

playerName

playerName：(必填) 觀看廣告所使用的媒體播放器名稱。

不適用

無法使用。

parentName

parentName：嵌入廣告所在主要內容的名稱或 ID。

不適用

無法使用。

parentPod

parentPod：主要內容中播放廣告的位置。

不適用

無法使用。

parentPodPosition

parentPodPosition：Pod 內播放廣告的位置。

不適用

無法使用。

CPM

CPM：此播放作業所採用的 CPM 或加密 CPM (首碼為「~」)。

不適用

無法使用。

Media.click

s.Media.click(name, offset)

s.tl()

使用自訂連結分析呼叫追蹤點擊次數。

Media.close

s.Media.close(mediaName)

不適用

無法使用。

Media.complete

s.Media.complete(
name,
offset)

s.tl()

s.linkTrackVars
= 'events,
prop10,
eVar10,
eVar12,
eVar15,
contextData.video.name,
contextData.video.complete';
s.linkTrackEvents
= 'event3';
s.prop10
= mediaName;
s.eVar10
= mediaName;
s.eVar12
= "video";
s.eVar15
= mediaPlayerName;
s.events
= 'event3';
s.contextData['video.name']
= mediaName;
s.contextData['video.complete']
= 'true';
s.tl(this,'o','Video Complete');

Media.play

s.Media.play(
name,
offset,
segmentNum,
segment,
segmentLength)

不適用

無法使用。

Media.stop

s.Media.stop(
mediaName,
mediaOffset)

不適用

無法使用。

Media.monitor

s.Media.monitor(s, media)

在連結呼叫設定 eVar 或內容資料變數。

s.linkTrackVars
= 'events,
prop10,
eVar10,
eVar12,
eVar15,
contextData.
video.name,
contextData.
video.view';
s.linkTrackEvents = 'event2';

Media.track

s.Media.track(
mediaName)

不適用

無法使用。

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb