設定Adobe Analytics的視訊追蹤

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

注意

繼續之前,請確定已在AEM中上傳​可播放視訊

若要確保您的影片在頁面上播放,請參閱​**本教學課程**,以了解如何在AEM中轉碼視訊檔案。

請依照下列步驟,使用每個方法來設定視訊追蹤的架構。

注意

若為新實作,建議您​不要使用​舊版視訊追蹤選項。 請改用​Milestones​方法。

常見步驟

  1. 從sidekick拖曳​視訊元件​並新增可播放​視訊作為元件的資產,以設定網頁

  2. 建立Adobe Analytics設定和架構

    • 後續各節中的範例針對設定使用名稱​my-sc-configuration,框架使用​videow
  3. 在架構頁面上,選取RSID並將使用情形設為全部。 (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

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

  5. 選取追蹤方法:

  6. 選取追蹤方法時,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​中繼資料欄位設為所需名稱,借此設定視訊的​使用者易記​名稱。

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

    4,8,16,20,24
    

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

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

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

  3. 將framework新 增至頁面。

  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

在此範例中,Video元件會在架構頁面上顯示如下:

video1

注意

若要查看對Adobe Analytics進行的呼叫,請使用適當的工具,例如DigitalPulse除錯程式或Fiddler。

使用提供的範例呼叫Adobe Analytics,在使用DigitalPulse除錯程式檢視時應該看起來像這樣:

chlimage_1-128

這是對Adobe Analytics 發出​的第一個呼叫,其中包含下列值:

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

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以追蹤事件。
  • 為與Adobe Analytics屬性對應而定義的CQ變數🔗靜態集。
  • 元件會針對您定義的每個里程碑建立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屬性,請從元件上CQ變數旁的ContentFinder拖曳Adobe Analytics屬性。

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

  3. 將framework新 增至頁面。

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

舊式里程碑

此方法與Milestones方法類似,其差異在於​Tracking offset​欄位中指定的里程碑是百分比,而非視訊中的設定點。

注意

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

  1. 設定「追蹤偏移」。

    • e.g.10,50,75,100

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

eventdata.videoName
若已在DAM中設定,則對應至此的變數將包含視訊的使用者易記名稱(Title);如果未設定標題,則會改為傳送視訊的檔案名稱。 播放視訊時只傳送一次。
eventdata.videoFileName 映射到此變數的變數將包含檔案的名稱。 播放視訊時,只傳送一次。
eventdata.videoFilePath 映射到此變數的變數將包含伺服器上的檔案路徑。 播放視訊時,只傳送一次。
注意

您可以開啟視訊以在DAM中進行編輯,並將​Title​中繼資料欄位設為所需名稱,借此設定視訊的​使用者易記​名稱。 您也需要儲存完成時所做的變更。

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

    呼叫中的​其餘相關資訊​將串連至​one​變數​pev3

    使 用提供的範例呼叫至Adobe Analytics的範例,在使用DigitalPulse除錯程式檢視時應如下所示:

    lmilestones1

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

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

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

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

    • 播放的總秒數 — 視訊播放的總秒數(25)

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

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

舊秒

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

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

    • 例如6
    注意

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

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

eventdata.videoName
若已在DAM中設定,則對應至此的變數將包含視訊的使用者易記名稱(Title);如果未設定標題,則會改為傳送視訊的檔案名稱。 播放視訊時只傳送一次。
eventdata.videoFileName 對應至此的變數將包含檔案的名稱。 播放視訊時,只傳送一次。
eventdata.videoFilePath 映射到此變數的變數將包含伺服器上的檔案路徑。 播放視訊時,只傳送一次。
注意

您可以開啟視訊以在DAM中進行編輯,並將​Title​中繼資料欄位設為所需名稱,借此設定視訊的​使用者易記​名稱。 您也需要儲存完成時所做的變更。

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

    呼叫中的​其餘相關資訊​將會連結至​一個​變數​pev3

    使用提供的範例呼叫Adobe Analytics,在使用DigitalPulse除錯程式檢視時應該看起來像這樣:

    lseconds

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

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

[0] https://docs.adobe.com/content/help/zh-Hant/media-analytics/using/media-overview.html

本頁內容