有數種方法可用來追蹤視訊事件,其中2種是舊版Adobe Analytics的舊版選項。 這些舊版選項為:舊版里程碑和舊版秒數。
在繼續之前,請確定您擁有 可播放的視訊 已在AEM中上傳。
為確保您的影片在頁面上播放,請參閱 本教學課程 以取得如何在AEM中轉碼視訊檔案的相關資訊。
使用以下程式,透過每個方法設定視訊追蹤的架構。
若為新實作,建議您 不使用 舊版視訊追蹤選項。 請使用 里程碑 方法取代。
透過拖曳設定網頁 視訊元件 從sidekick新增可播放專案 視訊作為資產 用於元件
在「架構」頁面上,選取RSID並將使用方式設定為「全部」。 (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
從Sidekick的「一般」元件類別中,將「視訊」元件拖曳至框架上。
選取追蹤方法:
當您選取追蹤方法時,CQ變數的清單會隨之變更。 使用下列章節,瞭解如何進一步設定元件,並透過Adobe Analytics屬性對應CQ變數。
Milestones方法可追蹤有關視訊的最多資訊、高度自訂且易於設定。
若要使用「里程碑」方法,請指定以時間為基礎的軌跡位移來定義里程碑。 當視訊播放超過里程碑時,頁面會呼叫Adobe Analytics以追蹤事件。 元件會為您定義的每個里程碑建立CQ變數,以便您對應至Adobe Analytics屬性。 這些CQ變數的名稱會使用以下格式:
eventdata.events.milestoneXX
XX字尾是定義里程碑的軌跡位移。 例如,指定4、8、16、20和28秒的軌跡位移會產生下列CQ變數:
eventdata.events.milestone4
eventdata.events.milestone8
eventdata.events.milestone16
eventdata.events.milestone20
eventdata.events.milestone28
下表說明為Milestones方法提供的預設CQ變數:
CQ變數 | Adobe Analytics屬性 |
---|---|
eventdata.videoName | 對應至此的變數將包含 使用者易記 名稱(標題),若已在DAM中設定;若未設定,則影片的 檔案名稱 將改為傳送。 只傳送一次,在播放視訊開始時傳送。 |
eventdata.videoFileName | 對應至此的變數將包含檔案名稱。 僅與eventdata.events.a.media.view一起傳送 |
eventdata.videoFilePath | 對應至此的變數將包含檔案在伺服器上的路徑。 僅與eventdata.events.a.media.view一起傳送 |
eventdata.events.a.media.segmentView | 每次超過區段里程碑時傳送 |
eventdata.events.a.media.timePlayed | 每次觸發里程碑時都會傳送,使用者觀看指定區段所花費的秒數也會與此事件一併傳送。 例如eventX=21 |
eventdata.events.a.media.view | 在初始化視訊檢視時傳送 |
eventdata.events.a.media.complete | 視訊完成播放時傳送 |
eventdata.events.milestoneX | 當指定的里程碑通過時傳送,X代表里程碑觸發時的秒數。 |
eventdata.a.contentType | 在每個里程碑時傳送;在Adobe Analytics呼叫中顯示為pev3,通常以「視訊」傳送 |
eventdata.a.media.name | 完全符合eventdata.videoName |
eventdata.a.media.segment | 包含已檢視區段的資訊,例如2:O:4-8 |
您可以設定視訊的 使用者易記 透過在DAM中開啟影片以進行編輯,並設定來「命名」 標題 將中繼資料欄位命名為所需的名稱。
選取「里程碑」作為追蹤方法後,在「追蹤位移」方塊中,輸入以逗號分隔的追蹤位移清單(以秒為單位)。 例如,下列值會定義里程碑在視訊開始後的4、8、16、20和28秒:
4,8,16,20,24
位移值必須是大於0的整數。 預設值為 10,25,50,75
。
若要將CQ變數對應至Adobe Analytics屬性,請從ContentFinder拖曳元件上CQ變數旁的Adobe Analytics屬性。
如需最佳化對應的詳細資訊,請參閱 在Adobe Analytics中測量視訊 指南。
新增框架 至頁面。
若要在中測試設定 預覽模式,播放影片以觸發Adobe Analytics呼叫。
以下的Adobe Analytics追蹤資料範例適用於使用4、8、16、20和24的追蹤位移,以及CQ變數的下列對應的里程碑追蹤:
CQ 變數 | Adobe Analytics屬性 |
---|---|
eventdata.videoName | prop2 |
eventdata.videoFileName | prop3 |
eventdata.videoFilePath | prop4 |
eventdata.events.a.media.segmentView | event1 |
eventdata.events.a.media.timePlayed | event2 |
eventdata.events.a.media.view | event3 |
eventdata.events.a.media.complete | event4 |
eventdata.events.milestone4 | event10 |
eventdata.events.milestone8 | event11 |
eventdata.events.milestone16 | event12 |
eventdata.events.milestone20 | event13 |
eventdata.events.milestone24 | event14 |
eventdata.a.contentType | eVar3 |
eventdata.a.media.name | eVar1, prop1 |
eventdata.a.media.segment | eVar2 |
在此範例中,視訊元件在架構頁面上會如下所示:
若要檢視對Adobe Analytics發出的呼叫,請使用適當的工具,例如DigitalPulse Debugger或Fiddler。
使用DigitalPulse Debugger檢視使用所提供範例呼叫Adobe Analytics時,呼叫看起來應該像這樣:
這是第一次呼叫對Adobe Analytics的變更,包含下列值:
這是第三個呼叫製作至Adobe Analytics:
除了使用軌道長度的百分比來定義里程碑以外,「非舊式里程碑」方法類似於「里程碑」方法。 共性如下:
這些CQ變數的名稱會使用以下格式:
XX字尾是定義里程碑的軌道長度的百分比。 例如,指定10、25、50和75的百分比會產生以下CQ變數:
eventdata.events.milestone10
eventdata.events.milestone25
eventdata.events.milestone50
eventdata.events.milestone75
eventdata.events.milestoneXX
選取「非舊版里程碑」作為追蹤方法後,在「追蹤位移」方塊中,輸入以逗號分隔的追蹤長度百分比清單。 例如,下列預設值會定義里程碑為軌跡長度的10%、25%、50%和75%:
10,25,50,75
位移值必須是大於0的整數。
若要將CQ變數對應至Adobe Analytics屬性,請從ContentFinder拖曳元件上CQ變數旁的Adobe Analytics屬性。
如需最佳化對應的詳細資訊,請參閱 在Adobe Analytics中測量視訊 指南。
新增框架 至頁面。
若要在中測試設定 預覽模式,播放影片以觸發Adobe Analytics呼叫。
此方法類似於Milestones方法,差異在於中指定的里程碑 追蹤位移 欄位是視訊中的百分比,而不是設定點。
「追蹤位移」欄位僅接受逗號分隔的清單,其中包含1到100之間的整數。
設定「軌跡位移」。
此外,傳送至Adobe Analytics的資訊可自訂性較低;只有3個變數可用於對應:
eventdata.videoName |
對應至此的變數將包含 使用者易記 名稱(標題);如果未設定「標題」,則影片的 檔案名稱 將改為傳送。 只傳送一次,在播放視訊開始時傳送。 |
eventdata.videoFileName | 對應至此的變數將包含檔案名稱。 只傳送一次,在播放視訊開始時傳送。 |
eventdata.videoFilePath | 對應至此的變數將包含檔案在伺服器上的路徑。 只傳送一次,在播放視訊開始時傳送。 |
您可以設定視訊的 使用者易記 透過在DAM中開啟影片以進行編輯,並設定來「命名」 標題 將中繼資料欄位命名為所需的名稱。 您還需要儲存完成時所做的變更。
將這些變數對應至prop 1至3
此 其他相關資訊 在呼叫中將串連傳送至 一 變數已命名 pev3.
呼叫範例 使用DigitalPulse Debugger檢視時,使用所提供範例前往Adobe Analytics的畫面應如下所示:
此pev3呼叫中傳送的變數包含下列資訊:
名稱 — 視訊檔案的名稱(film.avi)
長度 — 視訊檔案的長度,以秒為單位(100)
播放器名稱 — 用來播放視訊檔案的視訊播放器(HTML5影片)
總播放秒數 — 影片播放的總秒數(25)
開始時間戳記 — 識別視訊播放開始時間的時間戳記(1331035567)
播放工作階段 — 播放工作階段的詳細資料。 此欄位會指出使用者與視訊的互動方式。 這可能包括他們開始播放視訊的位置、他們是否使用視訊滑桿來推進視訊,以及他們停止播放視訊的位置(L10E24S58L58 — 視訊停止於秒。 區段L10的25個,然後略過至秒。 48)
使用legacy seconds方法時,Adobe Analytics呼叫會每隔N秒觸發一次,其中N會在「追蹤位移」欄位中指定。
將「軌跡位移」設定為任何秒數,
「追蹤位移」欄位僅接受大於0的整數
傳送至Adobe Analytics的資訊較不易自訂。 只有3個變數可用於對應:
eventdata.videoName |
對應至此的變數將包含 使用者易記 名稱(標題);如果未設定「標題」,則影片的 檔案名稱 將改為傳送。 只傳送一次,在播放視訊開始時傳送。 |
eventdata.videoFileName | 對應至此的變數將包含檔案名稱。 只傳送一次,在播放視訊開始時傳送。 |
eventdata.videoFilePath | 對應至此的變數將包含檔案在伺服器上的路徑。 只傳送一次,在播放視訊開始時傳送。 |
您可以設定視訊的 使用者易記 透過在DAM中開啟影片以進行編輯,並設定來「命名」 標題 將中繼資料欄位命名為所需的名稱。 您還需要儲存完成時所做的變更。
將這些變數對應至prop1、prop2和prop3
此 其他相關資訊 在呼叫中,將會以串連方式傳送至 一 變數已命名 pev3.
使用DigitalPulse Debugger檢視使用所提供範例呼叫Adobe Analytics時,呼叫看起來應該像這樣:
此呼叫類似於上述舊版里程碑呼叫。 請參閱pev3的相關資訊提供於此.
本教學課程中使用的參考: