有數種可追蹤視訊事件的方法,其中2種是舊版Adobe Analytics的舊版選項。 這些舊版選項包括:舊里程碑和舊秒數。
在繼續之前,請確定您已在AEM中上傳可播放的視訊。
若要確保您的影片在頁面上播放,請參閱**本教學課程**,以取得如何在AEM中轉碼影片檔案的詳細資訊。
請依照下列步驟,使用每個方法來設定視訊追蹤的架構。
對於新實作,建議您不要使用舊版視訊追蹤選項。 請改用Milestones方法。
從側腳拖曳視訊元件並新增可播放視訊作為元件的資產,以設定網頁
在框架頁面上,選擇一個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中設定,映射到此變數的變數將包含視訊的使用者友好名稱(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中編輯,並將標題中繼資料欄位設定為所需名稱,以設定視訊的使用者友好名稱。
選擇里程碑作為追蹤方法後,在「追蹤偏移」方塊中,以秒為單位輸入以逗號分隔的追蹤偏移清單。 例如,下列值定義視訊開始後4、8、16、20和28秒的里程碑:
4,8,16,20,24
偏移值必須是大於0的整數。 預設值為10,25,50,75
。
若要將CQ變數對應至Adobe Analytics屬性,請從元件上CQ變數旁的ContentFinder拖曳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 |
在此範例中,視訊元件會如下顯示在架構頁面上:
若要查看對Adobe Analytics的呼叫,請使用適當的工具,例如DigitalPulse除錯程式或Fiddler。
使用提供範例的Adobe Analytics呼叫在使用DigitalPulse除錯程式檢視時,應如下所示:
這是對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屬性,請從元件上CQ變數旁的ContentFinder拖曳Adobe Analytics屬性。
將framework添 加到頁面。
若要在預覽模式中測試設定,請播放影片以取得要觸發的Adobe Analytics呼叫。
此方法與Milestones方法類似,其差異在於追蹤偏移欄位中指定的里程碑是百分比,而非視訊中的設定點。
「追蹤偏移」欄位只接受逗號分隔的清單,清單中包含1到100之間的整數。
設定「軌跡偏移」。
此外,傳送至Adobe Analytics的資訊可自訂性較低;僅有3個變數可用於映射:
eventdata.videoName |
若在DAM中設定,映射到此變數的變數將包含視訊的使用者友好名稱(Title);如果未設定「標題」,則會改為傳送影片的檔案名稱。 播放視訊時,只傳送一次。 |
eventdata.videoFileName | 映射到此變數的變數將包含檔案的名稱。 播放視訊時,只傳送一次。 |
eventdata.videoFilePath | 映射到此變數的變數將包含檔案在伺服器上的路徑。 播放視訊時,只傳送一次。 |
您可以開啟視訊以在DAM中編輯,並將標題中繼資料欄位設定為所需名稱,以設定視訊的使用者友好名稱。 您還需要保存完成時所做的更改。
將這些變數對應至prop 1至3
呼叫中的其餘相關資訊將被發送到名為 pev3 的一個變數。
使用 提供範例的Adobe Analytics範例呼叫在使用DigitalPulse除錯程式檢視時應如下所示:
在呼叫中傳送的pev3變數包含下列資訊:
Name —— 視訊檔案的名稱(film.avi)
長度 -視訊檔案的長度,以秒為單位(100)
播放器名稱 -用來播放視訊檔案的視訊播放器(HTML5視訊)
播放秒數總計 -影片播放的秒數總計(25)
開始時間戳記 -識別視訊播放開始時間的時間戳記(1331035567)
播放作業 -播放作業的詳細資訊。此欄位指出使用者與視訊的互動方式。 這可能包括資料,例如他們開始播放視訊的位置、他們是否使用視訊滑桿來推進視訊,以及他們停止播放視訊的位置(L10E24S58L58 —— 視訊在秒內停止。 第10節的25節,然後跳至秒。 48)
使用舊版秒數方法時,Adobe Analytics呼叫會每隔N秒觸發一次,其中N會在「追蹤偏移」欄位中指定。
將「追蹤偏移」設為任意秒數,
「追蹤偏移」欄位只接受大於0的整數
傳送至Adobe Analytics的資訊無法自訂。 僅有3個可用於映射的變數:
eventdata.videoName |
若在DAM中設定,映射到此變數的變數將包含視訊的使用者友好名稱(Title);如果未設定「標題」,則會改為傳送影片的檔案名稱。 播放視訊時,只傳送一次。 |
eventdata.videoFileName | 映射到此變數的變數將包含檔案的名稱。 播放視訊時,只傳送一次。 |
eventdata.videoFilePath | 映射到此變數的變數將包含檔案在伺服器上的路徑。 播放視訊時,只傳送一次。 |
您可以開啟視訊以在DAM中編輯,並將標題中繼資料欄位設定為所需名稱,以設定視訊的使用者友好名稱。 您還需要保存完成時所做的更改。
將這些變數對應至prop1、prop2和prop3
呼叫中的其餘相關資訊將被聯合到名為 pev3 的一個變數中。
使用提供範例的Adobe Analytics呼叫在使用DigitalPulse除錯程式檢視時,應如下所示:
*此呼叫類似於上述的舊式里程碑呼叫。請參閱此處提供的pev3 相關資訊。*
本教學課程中使用的參考:
[0 ] https://docs.adobe.com/content/help/zh-Hant/media-analytics/using/media-overview.html