設定Adobe Analytics的視訊追蹤

上次更新: 2023-11-07

有數種方法可用來追蹤視訊事件,其中2種是舊版Adobe Analytics的舊版選項。 這些舊版選項為:舊版里程碑和舊版秒數。

注意

在繼續之前,請確定您已擁有 可播放的視訊 已在AEM中上傳。

為確保您的影片在頁面上播放,請參閱 本教學課程 有關如何在AEM中轉碼視訊檔案的資訊。

使用下列程式,以使用每種方法設定視訊追蹤的架構。

注意

若為新實作,建議您 不要使用 視訊追蹤的舊版選項。 使用 里程碑 方法。

常見步驟

  1. 透過拖曳設定網頁 視訊元件 從sidekick加入可玩的 視訊作為資產 適用於元件

  2. 建立Adobe Analytics設定和框架.

    • 後面章節的範例使用名稱 my-sc-configuration 設定和 videofw 用於框架。
  3. 在Framework頁面上,選取RSID並將使用設定為all。 (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. 從Sidekick的「一般」元件類別中,將「視訊」元件拖曳至架構。

  5. 選取追蹤方法:

  6. 當您選取追蹤方法時,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中編輯並設定 標題 中繼資料欄位重新命名為。

  1. 選取「里程碑」作為追蹤方法後,在「追蹤位移」方塊中,輸入以逗號分隔的追蹤位移清單(以秒為單位)。 例如,下列值會定義里程碑在視訊開始後的4、8、16、20和28秒:

    4,8,16,20,24
    

    位移值必須是大於0的整數。 預設值為 10,25,50,75

  2. 若要將CQ變數對應至Adobe Analytics屬性,請將Adobe Analytics屬性從ContentFinder拖曳至元件上CQ變數旁邊。

    如需最佳化對應的詳細資訊,請參閱 在Adobe Analytics中測量視訊 指南。

  3. 新增框架 移至頁面。

  4. 若要在中測試設定 預覽模式,播放視訊以觸發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

在此範例中,視訊元件在架構頁面上如下所示:

video1

注意

若要檢視對Adobe Analytics發出的呼叫,請使用適當的工具,例如DigitalPulse Debugger或Fiddler。

使用DigitalPulse Debugger檢視時,使用所提供範例呼叫Adobe Analytics時看起來會像這樣:

chlimage_1-128

這是​第一次呼叫​向Adobe Analytics發出包含以下值的通知:

  • eventdata.a.media.name的prop1和eVar1,
  • props2-4,以及包含contentType (影片)和segment (1)的eVar2和eVar3:O:1-4)
  • 已對應至eventdata.events.a.media.view的event3。

chlimage_1-129

這是​第三個呼叫​對Adobe Analytics做出:

  • prop1和eVar1包含a.media.name;
  • event1,因為已檢視區段
  • event2已傳送並播放時間= 4
  • event11已傳送,因為已達到eventdata.events.milestone8
  • prop2至4未傳送(因為未觸發eventdata.events.a.media.view)

非舊版里程碑

「非舊版里程碑」方法類似於「里程碑」方法,但里程碑是使用追蹤長度的百分比定義。 共同之處如下:

  • 當視訊播放超過里程碑時,頁面會呼叫Adobe Analytics以追蹤事件。
  • CQ變數的靜態集合 為與Adobe Analytics屬性對應而定義。
  • 元件會為您定義的每個里程碑建立CQ變數,供您對應至Adobe Analytics屬性。

這些CQ變數的名稱會使用以下格式:

XX尾碼是定義里程碑的軌跡長度的百分比。 例如,指定10、25、50和75的百分比會產生下列CQ變數:

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX
  1. 選取「非舊版里程碑」作為追蹤方法後,在「追蹤位移」方塊中,輸入以逗號分隔的追蹤長度百分比清單。 例如,下列預設值會定義里程碑為軌跡長度的10%、25%、50%和75%:

    10,25,50,75
    

    位移值必須是大於0的整數。

  2. 若要將CQ變數對應至Adobe Analytics屬性,請將Adobe Analytics屬性從ContentFinder拖曳至元件上CQ變數旁邊。

    如需最佳化對應的詳細資訊,請參閱 在Adobe Analytics中測量視訊 指南。

  3. 新增框架 移至頁面。

  4. 若要在中測試設定 預覽模式,播放視訊以觸發Adobe Analytics呼叫。

舊版里程碑

此方法類似於Milestones方法,不同之處在於 追蹤位移 欄位是百分比而不是視訊中的設定點。

注意

「追蹤位移」欄位僅接受逗號分隔的清單,其中包含1到100之間的整數。

  1. 設定軌跡位移。

    • 例如,10,50,75,100

    此外,傳送至Adobe Analytics的資訊不易自訂;只有3個變數可用於對應:

事件資料。視訊名稱
對應至此的變數將包含 使用者易記 名稱(標題)中,若已在DAM中設定;若未設定「標題」,則視訊的 檔案名稱 將改為傳送。 只傳送一次,在播放視訊開始時傳送。
eventdata.videoFileName 對應至此的變數將包含檔案名稱。 只傳送一次,在播放視訊開始時傳送。
eventdata.videoFilePath 對應至此的變數將包含檔案在伺服器上的路徑。 只傳送一次,在播放視訊開始時傳送。
注意

您可以設定視訊的 使用者易記 透過開啟影片以在DAM中編輯並設定 標題 中繼資料欄位重新命名為。 完成時,您還需要儲存所做的變更。

  1. 將這些變數對應至prop 1至3

    其他相關資訊 在呼叫中將串連傳送到 變數已命名 pev3.

    呼叫範例 使用提供的範例前往Adobe Analytics,在使用DigitalPulse Debugger檢視時應該如下所示:

    lmilestones1

    此​pev3​呼叫中傳送的變數包含下列資訊:

    • 名稱 — 視訊檔案的名稱(film.avi)

    • 長度 — 視訊檔案的長度,以秒為單位(100)

    • 播放器名稱 — 用來播放視訊檔案的視訊播放器(HTML5視訊)

    • 總播放秒數 — 影片播放的總秒數(25)

    • 開始時間戳記 — 識別視訊播放開始時間的時間戳記(1331035567)

    • 播放工作階段 — 播放工作階段的詳細資料。 此欄位指出使用者與視訊的互動方式。 這可能包括他們開始播放視訊的位置、他們是否使用視訊滑桿來推進視訊,以及他們停止播放視訊的位置(L10E24S58L58 — 視訊停止於秒。 L10區段的25個,然後略過到秒。 48)

舊版秒數

使用​舊版秒​方法時,Adobe Analytics呼叫會每隔N秒觸發一次,其中N會在「追蹤位移」欄位中指定。

  1. 將追蹤位移設為任何秒數,

    • 例如, 6
    注意

    「追蹤位移」欄位僅接受大於0的整數

    傳送至Adobe Analytics的資訊較不易自訂。 只有3個變數可用於對應:

事件資料。視訊名稱
對應至此的變數將包含 使用者易記 名稱(標題)中,若已在DAM中設定;若未設定「標題」,則視訊的 檔案名稱 將改為傳送。 只傳送一次,在播放視訊開始時傳送。
eventdata.videoFileName 對應至此的變數將包含檔案名稱。 只傳送一次,在播放視訊開始時傳送。
eventdata.videoFilePath 對應至此的變數將包含檔案在伺服器上的路徑。 只傳送一次,在播放視訊開始時傳送。
注意

您可以設定視訊的 使用者易記 透過開啟影片以在DAM中編輯並設定 標題 中繼資料欄位重新命名為。 完成時,您還需要儲存所做的變更。

  1. 將這些變數對應至prop1、prop2和prop3

    其他相關資訊 在呼叫中,將會以串連方式傳送至 變數已命名 pev3.

    使用DigitalPulse Debugger檢視時,使用所提供範例呼叫Adobe Analytics時看起來會像這樣:

    秒

    此呼叫類似於上述舊版里程碑呼叫。 請參閱pev3的相關資訊​提供於此處.

本教學課程中使用的參考:

[0] https://experienceleague.adobe.com/docs/media-analytics/using/media-overview.html?lang=zh-Hant

本頁內容