Adobe Medium Analytics (3.x SDK) for Audio and Video擴充功能概觀
本文件主要說明安裝、設定和實作 Adobe Media Analytics (3.x SDK) for Audio and Video 擴充功能 (Media Analytics 擴充功能) 的相關資訊,其中包含使用此擴充功能來建立規則時可用的選項,以及範例和範例連結。
Media Analytics (MA) 擴充功能新增核心 JavaScript Media SDK (Media 3.x SDK)。此擴充功能可將Media
追蹤器執行個體新增至已啟用標籤的網站或專案。 MA 擴充功能需要額外的擴充功能:
在已啟用標籤的專案中納入上述的三個擴充功能後,您可以使用下列兩種方式之一繼續操作:
- 從您的網頁應用程式使用
Media
API - 納入或建立播放器特定的擴充功能,此模組會將特定的媒體播放器事件對應到
Media
追蹤器例項上的 API。此例項會透過 MA 擴充功能公開。
安裝並設定 MA 擴充功能
-
安裝: 若要安裝MA擴充功能,請開啟您的擴充功能屬性,選取 擴充功能>目錄,將游標暫留在 Adobe Medium Analytics (3.x SDK) for Audio and Video 擴充功能上,然後選取 安裝。
-
設定: 若要設定MA擴充功能,請開啟擴充功能標籤,將游標暫留在擴充功能上,然後選取[設定] :
設定選項:
window
物件下 Media Analytics API 的變數提醒: MA 擴充功能需有 Analytics 和 Experience Cloud ID 擴充功能,才能正常運作。您也必須將這些擴充功能新增至擴充功能屬性並加以設定。
使用 MA 擴充功能
從網頁/JS 應用程式使用
MA擴充功能會啟用設定頁面中的「匯出視窗物件API」設定,匯出全域視窗物件中的Media API。 這會以設定的變數名稱匯出 API。例如,如果變數名稱設為 ADB
,則可使用 window.ADB.Media
來存取 Media API。
window["CONFIGURED_VARIABLE_NAME"]
未定義時匯出 API,不會覆寫現有變數。-
Media API:
window["CONFIGURED_VARIABLE_NAME"].Media
Media SDK 的所有 API 和常數都會公開:https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html
-
建立 Media 追蹤器例項:
window["CONFIGURED_VARIABLE_NAME"].Media.getInstance
傳回值:追蹤媒體工作階段的 一種
Media
追蹤器例項。code language-javascript var Media = window["CONFIGURED_VARIABLE_NAME"].Media; var tracker = Media.getInstance();
-
使用媒體追蹤器例項,並按照 JS API 文件所述來實作媒體追蹤功能。
範例播放器可從這裡取得:MA 範例播放器。範例播放器可作為參考,以示範如何使用 MA 擴充功能直接從網路應用程式支援 Media Analytics。
從其他擴充功能使用
MA擴充功能會將media
公開為其他擴充功能的共用模組。 (如需共用模組的其他資訊,請參閱共用模組文件)。
turbine
(請參閱以下程式碼範例)。-
Media API:
media
共用模組Media SDK 的所有 API 和常數都會公開:https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html
-
建立 Media 追蹤器例項,如下所示:
傳回值:追蹤媒體工作階段的 一種
Media
追蹤器例項。code language-javascript var Media = turbine.getSharedModule('adobe-media-analytics', 'media'); var tracker = Media.getInstance();
-
使用媒體追蹤器例項,並按照 JS API 文件所述來實作媒體追蹤功能。