Adobe MediumAnalytics(3.x SDK)for Audio and Video擴充功能概觀

注意

Adobe Experience Platform Launch在Adobe Experience Platform中已重新命名為一套資料收集技術。 因此，所有產品文件中出現了幾項術語變更。 如需術語變更的彙整參考資料，請參閱以下文件。

本文件主要說明安裝、設定和實作 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 3.x SDK 一併部署，且無法向下相容於 Media 2.x SDK。自2.x已淘汰，請更新至3.x。

在您的標籤啟用專案中納入上述的三個擴充功能後，您可以透過下列兩種方式之一繼續操作：

  • 從您的網頁應用程式使用 Media API
  • 納入或建立播放器特定的擴充功能，此模組會將特定的媒體播放器事件對應到 Media 追蹤器例項上的 API。此例項會透過 MA 擴充功能公開。

安裝並設定 MA 擴充功能

  • 安裝： 若要安裝MA擴充功能，請開啟您的擴充功能屬性，選取 擴充功能>目錄，將游標暫留在 Adobe MediumAnalytics(3.x SDK)for Audio and Video 擴充功能，然後選取 安裝.

  • 配置： 若要設定MA擴充功能，請開啟 擴充功能 標籤，將游標暫留在擴充功能上，然後選取 設定:

MA 擴充功能設定

設定選項：

選項 說明
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擴充功能會啟用「將API匯出至視窗物件」設定，匯出全域視窗物件中的媒體API。 設定 頁面。 這會以設定的變數名稱匯出 API。例如，如果變數名稱設為 ADB，則可使用 window.ADB.Media 來存取 Media API。

重要

MA 擴充功能僅會在 window["CONFIGURED_VARIABLE_NAME"] 未定義時匯出 API，不會覆寫現有變數。

  1. Media API： window["CONFIGURED_VARIABLE_NAME"].Media

    Media SDK 的所有 API 和常數都會公開：https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

  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共用模組

    Media SDK 的所有 API 和常數都會公開：https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

  2. 建立 Media 追蹤器例項，如下所示：

    傳回值：追蹤媒體工作階段的​一種Media追蹤器例項。

    var Media =
  turbine.getSharedModule('adobe-media-analytics', 'media');

var tracker = Media.getInstance();

  3. 使用媒體追蹤器例項，並按照 JS API 文件所述來實作媒體追蹤功能。

注意

測試：​若要在這個版本中測試擴充功能，您必須將其上傳至 Platform 以便在其中存取所有相依的擴充功能。

本頁內容