里程碑概觀 milestone-overview

視訊量度

變數類型

說明

內容

eVar
預設過期時間：造訪

(必要) 依實作指示收集視訊名稱。

內容類型

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

收集訪客所檢視內容類型的相關資料。視訊測量傳送的點擊會被指派為 video. 的內容類型。
不需專為視訊追蹤保留此變數。使用此相同變數而具有其他內容報表內容類型，可讓您分析不同內容類型中訪客的分佈情況。舉例來說，使用了這個變數，您就可以利用像是 article 或 product page 等值來標記其他內容類型。
從視訊測量觀點，「內容類型」**​可讓您識別視訊訪客，並因此計算視訊轉換率。

內容逗留時間

事件
類型：計數器

計算自上次資料收集程序 (影像要求) 以來，用於觀看視訊的時間 (以秒為單位)。

視訊起始

事件
類型：計數器

指出有訪客檢視了視訊的某部分。但此量度並不會針對訪客所檢視的視訊提供任何關於檢視內容的多少、哪一部分的資訊。

視訊完成

事件
類型：計數器

指出使用者已檢視完整的視訊。預設情況下，完成事件會在視訊結尾之前 1 秒測量。
實作期間，您可以指定想要將距離視訊結尾幾秒視為檢視完成。針對即時視訊和沒有已定義結尾的其他資料流，您可以指定測量完成的自訂點。例如，在特定檢視次數之後。

變數

說明

語法：

s.Media.trackUsingContextData = true;
此選項可啟用整合式視訊追蹤。設為 true 時，媒體模組會為媒體追蹤產生內容資料，而不是舊版 pev3。
使用 Media.contextDataMapping 來對應內容資料至選取的 eVar 和事件。
預設值：false

語法：

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 和事件。物件必須對應下列欄位：

a.media.name：(必要) 以視訊名稱填入變數。提供您選取要儲存視訊名稱的 eVar，以及要用於視訊路徑的「自訂分析視訊」變數 (s.prop)。以逗號分隔的清單提供值。

a.media.segment：(選用) 您要儲存媒體區段名稱的 eVar。a.contentType：(選用) 您要儲存視訊值的 eVar，其包含已啟用的造訪和訪客追蹤，用以產生視訊造訪和訪客報表。您選取的變數似乎已用來儲存文章投影片放映或產品頁面之類的資料

a.media.view：(必要) 您要計算媒體檢視次數的事件。

a.media.segmentView：(選用) 您要計算區段檢視次數的事件。

a.media.complete：(選用) 您要計算完整檢視次數的事件。

a.media.timePlayed：(選用，強烈建議使用) 您要儲存播放的視訊秒數的數值事件。

a.media.milestones：(選用) 將 s.Media.trackMilestones 里程碑與計數器事件對應的物件。如果您定義里程碑，Media.segmentByMilestones 應該設為 true。

廣告追蹤 若要追蹤廣告，可使用下列內容資料變數：
a.media.ad.name：(必要) 以廣告名稱填入變數。提供您選取要儲存廣告名稱的 eVar，以及要用於路徑的「自訂分析視訊」變數 (s.prop)。以逗號分隔的清單提供值。

a.media.ad.pod： ​主要內容中播放廣告的位置。

a.media.ad.podPosition： Pod 內播放廣告的位置。

a.media.ad.CPM： ​套用至此播放的 CPM 或加密的 CPM (首碼為「~」)。

A.media.ad.view： ​與 a.media.view 的作用相同。

a.media.ad.clicked： ​計算廣告點擊次數 (Media.click 呼叫次數)

a.media.ad.timePlayed： ​與 a.media.timePlayed 的作用相同。

a.media.ad.complete： 與 a.media.complete a.media.ad.segment 的作用相同：與 a.media.segment 的作用相同

a.media.ad.segmentView： ​與 a.media.segmentView 的作用相同。

a.media.ad.milestones： 與 a.media.milestones 的作用相同。

a.media.ad.offsetMilestones： 與 a.media.offsetMilestones 的作用相同。

語法：

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

在您的視訊追蹤程式碼中設定的所有變數以逗號分隔的清單。

語法：

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

在您的視訊追蹤程式碼中設定的所有事件以逗號分隔的清單。

變數

說明

語法：

s.Media.autoTrack = true

啟用對支援的播放器的自動追蹤。支援的播放器如下所示：

• Open Source Media Framework (OSMF)
• FLVPlayback (透過 Flash Professional 中的匯入視訊精靈建立的視訊播放器)
• Silverlight
• MediaDisplay
• MediaPlayback
• Brightcove API 版本 2 與 3 (請參閱 Brightcove
• 使用 JavaScript 的 Windows Media Player、Quicktime 或 Real Player

如果您未使用以上任一個播放器，則可以使用 Media.open Media.play Media.stop Media.close 來追蹤播放器事件。

語法：

s.Media.autoTrackNetStreams = true

Flash 10.3 推出 NetStream 元件的新功能，可啟用進階視訊追蹤。如果您使用自訂 Flash NetStream 播放器，則可以啟用此變數以啟用類似於 autoTrack 的功能。此方法要求在 Flash 10.3 或更新版本中檢視視訊。

語法：



s.Media.completeByCloseOffset = true

此設定可讓您在視訊實際結束之前幾秒計算所完成的視訊檢視。

會根據 completeCloseOffsetThreshold 中指定的秒數來傳送事件。這可讓您在從不會報告等於視訊長度的位移的視訊播放器中測量完成。

預設情況下，此值會設為 true，而臨界值設為 1 秒。有了這些預設值，完成事件會在視訊結尾之前 1 秒傳送。

語法：

s.Media.completeCloseOffsetThreshold = 1

此臨界值可讓您在視訊實際結束之前幾秒計算所完成的視訊檢視。必須將 Media.completeByCloseOffset 設為 true，才能使用此臨界值。

您提供的整數值會決定位移可以距離視訊長度關閉處，仍被計為完成的秒數。這可讓您在從不會報告等於視訊長度的位移的視訊播放器中測量完成。

預設臨界值為 1 秒。

語法：

s.Media.playerName = "Custom Player Name"

指定自訂視訊播放器名稱。

語法：

s.Media.trackSeconds = 15

以秒數定義間隔，用於在視訊播放時傳送視訊追蹤資料至 Adobe 資料收集伺服器。值必須設定為 5 秒的增量。

僅對 Media.trackSeconds 中定義的事件啟用 Media.contextDataMapping 觸發。除了為視訊測量指定的這些以外，若要傳送其他變數，您必須使用 Media.monitor。

以視訊長度的百分比追蹤里程碑。

語法：

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

以視訊長度的百分比定義間隔，用於傳送視訊追蹤資料至 Adobe 資料收集伺服器。以整數、逗號分隔的清單指定里程碑。例如：10 = 10%，23 = 23%。

因為這些里程碑在視訊中是固定的點，如果訪客檢視超過 10% 里程碑，然後倒轉並再次超過 10% 里程碑，媒體模組會傳送多次追蹤資料。類似地，如果訪客快轉超過某個里程碑，媒體模組不會為該里程碑傳送追蹤資料。

僅對 Media.trackMilestones 中定義的事件啟用 Media.contextDataMapping 觸發。除了為視訊測量指定的這些以外，若要傳送其他變數，您必須使用 Media.monitor。

以從視訊開始的經過秒數來追蹤里程碑。

語法：

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

以從視訊開始的經過秒數定義間隔，用於傳送視訊追蹤資料至 Adobe 資料收集伺服器。以整數、逗號分隔的清單指定里程碑。例如：20 = 20 秒，40 = 40 秒。

因為這些里程碑在視訊中是固定的點，如果訪客檢視超過里程碑 20 秒，然後倒轉並再次超過 20 秒里程碑，媒體模組會傳送多次追蹤資料。類似地，如果訪客快轉超過某個里程碑，媒體模組不會為該里程碑傳送追蹤資料。

僅對 Media.trackOffsetMilestones 中定義的事件啟用 Media.contextDataMapping 觸發。除了為視訊測量指定的這些以外，若要傳送其他變數，您必須使用 Media.monitor。

語法：

s.Media.segmentByMilestones = true;

根據 Media.trackMilestones 中指定的媒體和里程碑的長度，自動產生區段名稱、區段號碼和區段長度資料。

使用 autoTrack 時，依里程碑劃分是定義區段的唯一方式。

預設值：false

語法：

s.Media.segmentByOffsetMilestones = true;

根據 Media.trackOffsetMilestones 中指定的媒體和里程碑的長度，自動產生區段名稱、區段號碼和區段長度資料。

使用 autoTrack 時，依里程碑劃分是定義區段的唯一方式。

預設值：false

變數

說明

語法：

s.Media.adTrackSeconds = 15;

以秒數定義間隔，用於在視訊播放時傳送視訊廣告追蹤資料至 Adobe 資料收集伺服器。值必須設定為 5 秒的增量。

僅對 Media.adTrackSeconds 中定義的事件啟用 Media.contextDataMapping 觸發。除了為視訊測量指定的這些以外，若要傳送其他變數，您必須使用 Media.monitor。

以廣告長度的百分比追蹤廣告里程碑。

語法：

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

以廣告長度的百分比定義間隔，用於傳送廣告追蹤資料至 Adobe 資料收集伺服器。以整數、逗號分隔的清單指定里程碑。例如：10 = 10%，23 = 23%。

因為這些里程碑在廣告中是固定的點，如果訪客檢視超過 10% 里程碑，然後倒轉並再次超過 10% 里程碑，媒體模組會傳送多次追蹤資料。類似地，如果訪客快轉超過某個里程碑，媒體模組不會為該里程碑傳送追蹤資料。

僅對 Media.adTrackMilestones 中定義的事件啟用 Media.contextDataMapping 觸發。除了為視訊測量指定的這些以外，若要傳送其他變數，您必須使用 Media.monitor。

以從廣告開始的經過秒數來追蹤廣告里程碑。

語法：

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

以從廣告開始的經過秒數定義間隔，用於傳送廣告追蹤資料至 Adobe 資料收集伺服器。以整數、逗號分隔的清單指定里程碑。例如：20 = 20 秒，40 = 40 秒。

因為這些里程碑在廣告中是固定的點，如果訪客檢視超過里程碑 20 秒，然後倒轉並再次超過 20 秒里程碑，媒體模組會傳送多次追蹤資料。類似地，如果訪客快轉超過某個里程碑，媒體模組不會為該里程碑傳送追蹤資料。

僅對 Media.adTrackOffsetMilestones 中定義的事件啟用 Media.contextDataMapping 觸發。除了為視訊測量指定的這些以外，若要傳送其他變數，您必須使用 Media.monitor。

語法：

s.Media.adSegmentByMilestones = true;

根據 Media.adTrackMilestones 中指定的媒體和里程碑的長度，自動產生區段名稱、區段號碼和區段長度資料。

使用 autoTrack 時，依里程碑劃分是定義區段的唯一方式。

預設值：false

語法：

s.Media.adSegmentByOffsetMilestones = true;

根據 Media.adTrackOffsetMilestones 中指定的媒體和里程碑的長度，自動產生區段名稱、區段號碼和區段長度資料。

使用 autoTrack 時，依里程碑劃分是定義區段的唯一方式。

預設值：false

方法

說明

語法：

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

準備用來收集視訊追蹤資料的媒體模組。此方法會採用下列參數：

• mediaName：(必要) 您要其顯示在視訊報表中的名稱。
• mediaLength：(必要) 視訊的長度 (以秒為單位)。
• mediaPlayerName：(必要) 用來檢視視訊的媒體播放器名稱，您要其顯示在視訊報表中的名稱。

語法：

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

準備用來收集廣告追蹤資料的媒體模組。此方法會採用下列參數：

• name：(必要) 廣告的名稱或 ID。
• length：(必要) 廣告的長度。
• playerName：(必要) 用來檢視廣告的媒體播放器的名稱。
• parentName： ​內嵌廣告所在主要內容的名稱或 ID。
• parentPod： ​主要內容中播放廣告的位置。
• parentPodPosition： Pod 內播放廣告的位置。
• CPM： ​套至用此播放的 CPM 或加密的 CPM (首碼為 "~")。

語法：

s.Media.click(name, offset)

追蹤何時在視訊中點按了廣告。此方法會採用下列參數：

• name： ​廣告的名稱。這必須符合 Media.openAd 中使用的名稱。
• offset： ​發生按一下時進入廣告的位移。

語法：

s.Media.close(mediaName)

結束視訊資料收集並傳送資訊至 Adobe 資料收集伺服器。在視訊結束時呼叫此方法。此方法會採用下列引數：

mediaName： ​視訊的名稱。這必須符合 Media.open 中使用的名稱。

語法：

s.Media.complete(name, offset)

此方法會手動追蹤完成的事件。當您需要觸發無法使用Media.completeByCloseOffset 處理的特殊邏輯事件時，會使用此方法。

例如，如果您要測量未定義結尾的即時資料流，則可以在使用者檢視即時資料流 X 秒後觸發完成。您可能會根據內容的長度和類型，使用百分比計算來測量完成情形。此方法會採用下列參數：

• mediaName： ​視訊的名稱。這必須符合 Media.open 中使用的名稱。
• mediaOffset： ​視訊中應該傳送完成事件的秒數。根據從零秒開始的視訊指定位移。
  
  如果您的媒體播放器使用毫秒追蹤，在呼叫 Media.complete 之前，請確定值轉換為秒。

如果您計劃手動呼叫完成，請設定

s.Media.completeByCloseOffset = false。

語法：

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

在視訊開始播放對隨時可呼叫此方法。使用手動視訊測量時，您可以在傳送視訊測量資料時提供目前的區段資料。

如果您的播放器因任何原因從一個區段變更為另一個，則應呼叫 Media.stop Media.play。

此方法會採用下列參數：

mediaName： ​視訊的名稱。這必須符合Media.open中使用的名稱。

mediaOffset： ​視訊中開始播放的秒數。根據從零秒開始的視訊指定位移。如果您的媒體播放器使用毫秒追蹤，在呼叫Media.play之前，請確定值轉換為秒。

segmentNum：(選用) 目前的區段號碼，行銷報表用來在報表中排序顯示區段。segmentNum引數必須大於零。

segment：(選用) 目前的區段名稱。

segmentLength：(選用)

目前的區段長度 (以秒為單位)。

例如：

s.Media.play("My Video", 1800, 2,"Second Quarter", 1800)

s.Media.play("My Video", 0, 1,"Preroll", 30)

語法：

s.Media.stop(mediaName, mediaOffset)

追蹤指定的視訊的停止事件 (停止、暫停等等)。此方法會採用下列參數：

• mediaName： ​視訊的名稱。這必須符合 Media.open 中使用的名稱。
• mediaOffset： ​視訊中發生停止或暫停事件的秒數。根據從零秒開始的視訊指定位移。

語法：

s.Media.monitor(s, media)

Silverlight 語法：

s.Media.monitor =
   new AppMeasurement_Media_Monitor(myMediaMonitor);

Silverlight 應用程式媒體監視會實作 Objective-C 委派設計模式。myMediaMonitor 類別方法採用 s 和 media 參數。

使用此方法來傳送其他視訊測量。您可以設定其他變數 (Prop、eVar、事件)，並在播放視訊時根據視訊的目前狀態，使用 Media.track 傳送它們。

請參閱使用 Media.monitor 測量其他度量。

此方法會採用下列參數：

s：AppMeasurement 例項 (或 JavaScript s 物件)。

media： ​物件，其成員提供視訊的狀態。這些成員包括：

• media.name: 視訊的名稱。這必須符合 Media.open 中使用的名稱；
• media.length: 在對 Media.open 的呼叫中提供的視訊的長度 (以秒為單位)；
• media.playerName: 在對 Media.open 的呼叫中指定的媒體播放器名稱；
• media.openTime: 包含呼叫 Media.open 時資料的 NSDate 物件；
• media.offset: 進入視訊的目前位移 (以秒為單位) (視訊中的實際點)。位移從零開始 (視訊的第一個秒數為 0 秒)；
• media.percent: 目前已播放視訊的百分比，根據視訊長度和目前的位移；
• media.timePlayed: 目前播放的總秒數；
• media.eventFirstTime: 指出這是否為第一次為此視訊呼叫此媒體事件；
• media.mediaEvent: 包含造成監控呼叫的事件名稱的字串。

media.mediaEvent events：

• OPEN: 透過 Media.autoTrack 或對 Media.play 呼叫第一次觀察到播放時；
• CLOSE: 當播放透過 Media.autoTrack 或對 Media.close 的呼叫在完成視訊結束時；
• PLAY: 當播放在暫停或擦除之後，透過 Media.autoTrack 或對 Media.play 的第二個呼叫繼續；
• STOP: 當播放由於透過 Media.autoTrack 或對 Media.stop 呼叫的擦除開始的暫停而停止時；
• MONITOR: 我們的自動監視在播放視訊時檢查視訊的狀態時 (每秒)；
• SECONDS: 以 Media.trackSeconds 變數定義的秒數間隔；
• MILESTONE: 在 Media.trackMilestones 變數定義的里程碑；

語法：

s.Media.track(mediaName)

立即傳送目前的視訊狀態，以及您定義的任何 Media.trackVars 和 Media.trackEvents。此方法是在 Media.monitor 內使用。

請參閱使用 Media.monitor 測量其他度量。

在呼叫此方法之前，在視訊上呼叫 Media.open 和 Media.play。此方法會採用下列參數：

• mediaName：視訊的名稱。這必須符合 Media.open 中使用的名稱。

此方法是在播放視訊時傳送其他變數的唯一方式。此方法會將秒數間隔和百分比里程碑計數器重設為零，以避免多個追蹤點擊。