Adobe Experience Platform Web SDKを使用したEdgeへのweb データの送信

バージョン 2.20.0以降、Adobe Experience Platform Web SDKのstreamingMedia コンポーネントを使用すると、web サイト上のメディアセッションに関連するデータを収集できます。 収集されたデータには、メディアの再生、一時停止、完了、その他の関連イベントに関する情報が含まれます。

データを収集した後、それをAdobe Experience PlatformやAdobe Analyticsに送信してレポートを生成できます。 この機能は、web サイトでのメディア消費行動を追跡および把握するための包括的なソリューションを提供します。

Media JS SDKを使用しているお客様に対しては、Web SDKは、Media JS SDKからWeb SDKへの移行パスを提供しますが、Media イベントの処理などの既存のMedia JS機能のサポートも含まれています。

前提条件 prerequisites

Web SDKのstreamingMedia コンポーネントを使用するには、次の前提条件を満たす必要があります。

このページで説明する手順に従って、ストリーミングメディアサービスの実装を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 Tracker インスタンスを取得する

Media JS SDKを使用しているお客様に対しては、Web SDKは、Media JS SDKからWeb SDKへの移行パスを提供しますが、Media イベントの処理などの既存のMedia JS機能のサポートも含まれています。

Web SDKには、getMediaAnalyticsTracker コマンドが含まれており、これを使用してオブジェクトインスタンスを作成できます。 次に、3.x Media SDKが提供するAPIと同じAPIを使用して、メディアイベントを追跡できます。

以下のスニペットは、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);