Show Menu
主題×

Adobe Media 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 追蹤器例項新增至 Launch 網站或專案的功能。MA 擴充功能需要額外的擴充功能:
此擴充功能會與 Media 3.x SDK 一併部署,且無法向下相容於 Media 2.x SDK。如果您的頁面已使用 Media 2.x SDK,請改用 Adobe Media Analytics for Audio and Video Extension ,而非此擴充功能。
在您的 Launch 專案中納入上述的三個擴充功能後,您可以使用下列兩種方式之一繼續操作:
  • 從您的網頁應用程式使用 Media API
  • 納入或建立播放器特定的擴充功能,此模組會將特定的媒體播放器事件對應到 Media 追蹤器例項上的 API。此例項透過 MA 會擴充功能公開。

安裝並設定 MA 擴充功能

  • 安裝: ​若要安裝 MA 擴充功能,請開啟擴充功能屬性,按一下「 Extensions > Catalog 」,接著將游標停留在「 Adobe Media Analytics (3.x SDK) for Audio and Video 擴充功能」上方,然後按一下「 Install 」。
  • 設定: ​若要設定 MA 擴充功能,請開啟「Extensions」索引標籤、將游標停留在擴充功能上方,然後按一下「 Configure 」。

設定選項:

選項
說明
Collection API Server
定義 Media Collection API 伺服器 (請連絡您的 Adobe 代表以取得此伺服器)
Application Version
媒體播放器應用程式/SDK 的版本
Player Name
使用的媒體播放器名稱 (例如:「AVPlayer」、「HTML5 播放器」、「我的自訂視訊播放器」)
Channel
管道名稱屬性
Debug Logging
啟用或停用記錄
Enable SSL
啟用或停用透過 HTTPS 傳送 Ping
Export APIs to Window Object
啟用或停用將 Media Analytics API 匯出至全域範圍
Variable Name
用來匯出 window 物件下 Media Analytics API 的變數
提醒: MA 擴充功能需有 Analytics Experience Cloud ID 擴充功能,才能正常運作。您也必須將這些擴充功能新增至擴充功能屬性並加以設定。

使用 MA 擴充功能

從網頁/JS 應用程式使用

MA 擴充功能會啟用「Configuration」頁面中的「匯出視窗物件 API」設定,匯出全域視窗物件的 Media API。這會以設定的變數名稱匯出 API。例如,如果變數名稱設為 ADB ,則可使用 window.ADB.Media 來存取 Media API。
MA 擴充功能僅會在 window["CONFIGURED_VARIABLE_NAME"] 未定義時匯出 API,不會覆寫現有變數。
  1. Media API:   window["CONFIGURED_VARIABLE_NAME"].Media
  2. 建立 Media 追蹤器例項:   window["CONFIGURED_VARIABLE_NAME"].Media.getInstance
    傳回值:追蹤媒體工作階段的 ​一種 Media 追蹤器例項。
    var Media = window["CONFIGURED_VARIABLE_NAME"].Media;
    
    var tracker = Media.getInstance();
    
    
  3. 使用媒體追蹤器例項,並按照 JS API 文件 所述來實作媒體追蹤功能。
範例播放器可從這裡取得: MA 範例播放器 。範例播放器可作為參考,以示範如何使用 MA 擴充功能直接從網路應用程式支援 Media Analytics。

從其他擴充功能使用

MA 擴充功能會公開 media ,作為其他擴充功能的共用模組(如需共用模組的其他資訊,請參閱 共用模組文件 )。
共用模組只能從其他擴充功能存取。也就是說,網頁/JavaScript 應用程式無法存取共用模組,或在擴充功能之外使用 turbine (請參閱以下程式碼範例)。
  1. Media API: media 共用模組
  2. 建立 Media 追蹤器例項,如下所示:
    傳回值:追蹤媒體工作階段的 ​一種 Media 追蹤器例項。
    var Media =
      turbine.getSharedModule('adobe-media-analytics', 'media');
    
    var tracker = Media.getInstance();
    
    
  3. 使用媒體追蹤器例項,並按照 JS API 文件 所述來實作媒體追蹤功能。
測試: ​若要在這個版本中測試擴充功能,您必須將其上傳至 Adobe Experience Platform Launch ,以便在其中存取所有相依的擴充功能。