有數種方法可用來追蹤視訊事件,其中2種是舊版Adobe Analytics的舊版選項。 以下是舊版選項:舊里程碑和舊秒。
繼續之前,請確定已在AEM中上傳可播放視訊。
若要確保您的影片在頁面上播放,請參閱**本教學課程**,以了解如何在AEM中轉碼視訊檔案。
請依照下列步驟,使用每個方法來設定視訊追蹤的架構。
若為新實作,建議您不要使用舊版視訊追蹤選項。 請改用Milestones方法。
從sidekick拖曳視訊元件並新增可播放視訊作為元件的資產,以設定網頁
在架構頁面上,選取RSID並將使用情形設為全部。 (http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
從Sidekick中的「一般」元件類別,將視訊元件拖曳至架構上。
選取追蹤方法:
選取追蹤方法時,CQ變數清單會隨之變更。 請使用下方的區段,了解如何進一步設定元件,以及將CQ變數與Adobe Analytics屬性對應。
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中設定,則對應至此的變數將包含視訊的使用者易記名稱(Title);如果未設定,則會改為傳送視訊的檔案名稱。 播放視訊時,只傳送一次。 |
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,通常以"video" 傳送 |
eventdata.a.media.name | 完全符合eventdata.videoName |
eventdata.a.media.segment | 包含已檢視區段的資訊,例如2:O:4-8 |
您可以開啟視訊以在DAM中進行編輯,並將Title中繼資料欄位設為所需名稱,借此設定視訊的使用者易記名稱。
選取里程碑作為追蹤方法後,在「追蹤位移」方塊中,輸入以逗號分隔的追蹤位移清單(以秒為單位)。 例如,下列值會在視訊開始後的4、8、16、20和28秒定義里程碑:
4,8,16,20,24
偏移值必須是大於0的整數。 預設值為 10,25,50,75
.
若要將CQ變數對應至Adobe Analytics屬性,請從元件上CQ變數旁的ContentFinder拖曳Adobe Analytics屬性。
如需有關最佳化對應的資訊,請參閱在Adobe Analytics中測量視訊指南。
將framework新 增至頁面。
若要在預覽模式中測試設定,請播放視訊以觸發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 |
在此範例中,Video元件會在架構頁面上顯示如下:
若要查看對Adobe Analytics進行的呼叫,請使用適當的工具,例如DigitalPulse除錯程式或Fiddler。
使用提供的範例呼叫Adobe Analytics,在使用DigitalPulse除錯程式檢視時應該看起來像這樣:
這是對Adobe Analytics 發出的第一個呼叫,其中包含下列值:
這是第三次呼叫Adobe Analytics:
a.media.name;
非舊式里程碑方法與里程碑方法類似,但里程碑是使用追蹤長度的百分比定義。 共性如下:
這些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屬性,請從元件上CQ變數旁的ContentFinder拖曳Adobe Analytics屬性。
如需有關最佳化對應的資訊,請參閱在Adobe Analytics中測量視訊指南。
將framework新 增至頁面。
若要在預覽模式中測試設定,請播放視訊以觸發Adobe Analytics呼叫。
此方法與Milestones方法類似,其差異在於Tracking offset欄位中指定的里程碑是百分比,而非視訊中的設定點。
「追蹤位移」欄位只接受以逗號分隔的清單,清單中包含1到100之間的整數。
設定「追蹤偏移」。
此外,傳送至Adobe Analytics的資訊不易自訂;僅有3個變數可供對應:
eventdata.videoName |
若已在DAM中設定,則對應至此的變數將包含視訊的使用者易記名稱(Title);如果未設定標題,則會改為傳送視訊的檔案名稱。 播放視訊時只傳送一次。 |
eventdata.videoFileName | 映射到此變數的變數將包含檔案的名稱。 播放視訊時,只傳送一次。 |
eventdata.videoFilePath | 映射到此變數的變數將包含伺服器上的檔案路徑。 播放視訊時,只傳送一次。 |
您可以在DAM中開啟要編輯的視訊,並將標題中繼資料欄位設為所需名稱,借此設定視訊的使用者易記名稱。 您也需要儲存完成時所做的變更。
將這些變數對應至prop 1至3
呼叫中的其餘相關資訊將會連結至一個變數pev3。
使 用提供的範例呼叫至Adobe Analytics的範例,在使用DigitalPulse除錯程式檢視時應如下所示:
呼叫中傳送的pev3變數包含下列資訊:
使用舊秒方法時,Adobe Analytics呼叫會每隔N秒觸發一次,其中N會在追蹤位移欄位中指定。
將「追蹤位移」設為任何秒數,
「追蹤位移」欄位僅接受大於0的整數
傳送至Adobe Analytics的資訊不易自訂。 只有3個變數可用於對應:
eventdata.videoName |
若已在DAM中設定,則對應至此的變數將包含視訊的使用者易記名稱(Title);如果未設定標題,則會改為傳送視訊的檔案名稱。 播放視訊時只傳送一次。 |
eventdata.videoFileName | 對應至此的變數將包含檔案的名稱。 播放視訊時,只傳送一次。 |
eventdata.videoFilePath | 映射到此變數的變數將包含伺服器上的檔案路徑。 播放視訊時,只傳送一次。 |
您可以開啟視訊以在DAM中進行編輯,並將Title中繼資料欄位設為所需名稱,借此設定視訊的使用者易記名稱。 您也需要儲存完成時所做的變更。
將這些變數對應至prop1、prop2和prop3
呼叫中的其餘相關資訊將會連結至一個變數pev3。
使用提供的範例呼叫Adobe Analytics,在使用DigitalPulse除錯程式檢視時應該看起來像這樣:
呼叫類似於上述的舊版里程碑呼叫。請參閱此處提供的pev3 的相關資訊。.
本教學課程中使用的參考: