使用Adobe Experience Platform Web SDK傳送Web資料至Edge
從2.20.0版開始,Adobe Experience Platform Web SDK的streamingMedia
元件可讓您收集與網站上的媒體工作階段相關的資料。 收集的資料可包括關於媒體播放、暫停、完成和其他相關事件的資訊。
收集資料後,您可以將其傳送至Adobe Experience Platform及/或Adobe Analytics以產生報表。 此功能提供全方位的解決方案,可追蹤及瞭解您網站上的媒體使用行為。
對於使用Media JS SDK的客戶,Web SDK提供從Media JS SDK移轉至Web SDK的移轉路徑,同時支援現有的Media JS功能,例如處理媒體事件。
先決條件 prerequisites
若要使用Web SDK的streamingMedia
元件,您必須符合下列必要條件:
- 在將串流媒體資料傳送到Edge之前,請先完成使用Experience PlatformEdge安裝串流媒體收集附加元件中的步驟。
- 確保您有權存取Adobe Experience Platform和/或Adobe Analytics。
- 您必須使用Web SDK 2.20.0版或更新版本。 請參閱Web SDK安裝概述,瞭解如何安裝最新版本。
- 為您使用的資料流啟用 Media Analytics 選項。
- 確定您的資料流使用的結構描述包含媒體收集結構描述欄位。
- 透過標籤擴充功能或透過JavaScript資料庫設定Web SDK組態的串流媒體功能(如本頁所示)。
請依照本頁所述的步驟,將您的串流媒體收集附加元件實作從Media JS移轉至Web SDK。
步驟1:安裝Experience Platform Web SDK
請參閱專屬檔案,瞭解如何在您的Web屬性上安裝Web SDK。
步驟2:設定Web SDK streamingMedia
元件。
範例
以下程式碼片段顯示如何在Media JS中設定媒體收集。
var mediaConfig = new ADB.MediaConfig();
mediaConfig.trackingServer = "company.hb-api.omtrdc.net";
mediaConfig.playerName = "player_name";
mediaConfig.channel = "sample_channel";
mediaConfig.appVersion = "app_version";
mediaConfig.debugLogging = true;
mediaConfig.ssl = true;
ADB.Media.configure(mediaConfig, appMeasurement);
而是必須在Web SDK中設定streamingMedia
元件,如下例所示。
alloy("configure", {
streamingMedia: {
channel: "sample_channel",
playerName: "player_name",
appVersion: "app_version",
mainPingInterval: 10,
adPingInterval: 10
}
});
如需如何設定的完整詳細資訊,請參閱Web SDK streamingMedia
元件檔案。
步驟3:從Media JS SDK移轉時取得媒體追蹤器例項
對於使用Media JS SDK的客戶,Web SDK提供從Media JS SDK移轉至Web SDK的移轉路徑,同時支援現有的Media JS功能,例如處理媒體事件。
Web SDK包含擷取Media Analytics追蹤器的命令。 您可以使用此命令來建立物件執行個體,然後使用與Media JS程式庫提供的相同API來追蹤媒體事件。
請參閱getMediaAnalyticsTracker
檔案,以取得支援方法的完整詳細資料。
以下程式碼片段顯示如何在Media JS中擷取媒體追蹤器例項。
var tracker = ADB.Media.getInstance();
請改用Web SDK中的getMediaAnalyticsTracker
命令來取得相同的結果,如下所示。
// aquire Media Analytics APIs
const Media = await window.alloy("getMediaAnalyticsTracker", {});
// create a media tracker instance
const trackerInstance = Media.getInstance();
所有協助程式方法都可在Media
物件上使用。 追蹤器例項提供追蹤器方法,如下所示。
const mediaInfo = Media.createMediaObject(
"video name",
"player video",
60,
Media.StreamType.VOD,
Media.MediaType.Video
);
const contextData = {
isUserLoggedIn: "false",
tvStation: "Sample TV station",
programmer: "Sample programmer",
assetID: "/uri-reference"
};
// Set standard Video Metadata
contextData[Media.VideoMetadataKeys.Episode] = "Sample Episode";
contextData[Media.VideoMetadataKeys.Show] = "Sample Show";
trackerInstance.trackSessionStart(mediaInfo, contextData);