スタンドアロンの Media SDK から Adobe Launch - Web（JS）への移行

メモ

Adobe Experience Platform Launch は、Experience Platform のデータ収集テクノロジースイートとしてリブランドされています。その結果、製品ドキュメント全体でいくつかの用語の変更がロールアウトされました。用語の変更点の一覧については、次のドキュメントを参照してください。

機能の違い

  • Launch - Launch は、Web ベースのメディアトラッキングソリューションの設定、構成およびデプロイの手順を示す UI を提供します。Launch は、Dynamic Tag Management（DTM）を改善したものです。
  • Media SDK - Media SDK は、特定のプラットフォーム向けに設計されたメディアトラッキングライブラリ（例：Android、iOSなど）を提供します。モバイルアプリケーションでのメディア使用状況を追跡する際には、Media SDK をお勧めします。

設定

スタンドアロンの Media SDK

スタンドアロンの Media SDK では、アプリケーションでトラッキング設定をおこない、トラッカーを作成する際に SDK に渡します。

//Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.trackingServer = "namespace.hb.omtrdc.net";
mediaConfig.playerName = "html5-player";
mediaConfig.channel = "sample-channel";
mediaConfig.ovp = "video-provider";
mediaConfig.appVersion = "v2.0.0"
mediaConfig.ssl = true;
mediaConfig.debugLogging = true;

メディアトラッキングが正しく機能するには、MediaHeartbeat 設定に加えて、ページで AppMeasurement インスタンスと VisitorAPI インスタンスを設定して渡す必要があります。

Launch 拡張機能

  1. Experience Platform Launch　で Web プロパティの「拡張機能」タブをクリックします。

  2. 「カタログ」タブでオーディオおよびビデオ用 Adobe Media Analytics 拡張機能を探し、「インストール」をクリックします。

  3. 拡張機能の設定ページで、トラッキングパラメーターを設定します。メディア拡張機能では、設定済みのパラメーターをトラッキングに使用します。

Launch ユーザーガイド - メディア各ｋ長機能のインストールと設定

トラッカーの作成の違い

メディア SDK

  1. 開発プロジェクトに Media Analytics ライブラリを追加します。
  2. 設定オブジェクト（MediaHeartbeatConfig）を作成します。
  3. getQoSObject() および getCurrentPlaybackTime() を公開する delegate プロトコルを実装します。
  4. メディアハートビートインスタンス（MediaHeartbeat）を作成します。
// Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
...
// Configuration settings
mediaConfig.trackingServer = Configuration.HEARTBEAT.TRACKING_SERVER;
...
// Implement Media Delegate (Quality of Service and Playhead)
var mediaDelegate = new MediaHeartbeatDelegate();
...
mediaDelegate.getQoSObject = function() {
    return MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
    ...
}
...
// Create your tracker
this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);

Launch

Launch は、トラッキングインフラストラクチャを作成する 2 つの方法を提供します。いずれの方法でも、Media Analytics Launch 拡張機能を使用します。

  1. Web ページからメディアトラッキング API を使用します。

    このシナリオでは、Media Analytics 拡張機能が、グローバルウィンドウオブジェクトの設定済み変数にメディアトラッキング API をエクスポートします。

    window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance

  2. 別の Launch 拡張機能のメディアトラッキング API を使用します。

    このシナリオでは、get-instance および media-heartbeat 共有モジュールで公開されているメディアトラッキング API を使用します。

    メモ

    共有モジュールは Web ページでは使用できません。他の拡張機能の共有モジュールのみを使用できます。

    get-instance 共有モジュールを使用して MediaHeartbeat インスタンスを作成します。
    delegate オブジェクトを、getQoSObject() および getCurrentPlaybackTime()　関数を公開する get-instance に渡します。

    var getMediaHeartbeatInstance =
turbine.getSharedModule('adobe-video-analytics', 'get-instance');

    media-heartbeat共有モジュールを使用して MediaHeartbeat 定数にアクセスします。

関連ドキュメント

メディア SDK

Launch

このページ