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

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

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

Media JS SDKを使用しているお客様の場合、Web SDKは、Media JS SDKから Web SDKに移行するための移行パスを提供すると同時に、メディアイベントの処理などの既存の 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 トラッカーインスタンスを取得する

Media JS SDKを使用しているお客様の場合、Web SDKは、Media JS SDKから Web SDKに移行するための移行パスを提供すると同時に、メディアイベントの処理などの既存の Media JS 機能のサポートを含みます。

Web SDK には、Media Analytics トラッカーを取得するコマンドが含まれています。 このコマンドを使用してオブジェクトインスタンスを作成し、Media JS ライブラリ ​ で提供される API と同じ 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);