Adobe Media Analytics (3.x SDK) for Audio and Video 拡張機能

このドキュメントには、Adobe Media Analytics (3.x SDK) for Audio and Video 拡張機能（Media Analytics 拡張機能）のインストール、設定および実装に関する情報が含まれています。この拡張機能を使用してルールを作成し、サンプルやサンプルへのリンクを作成する場合に使用できるオプションについても説明します。

Media Analytics（MA）拡張機能は、コアe JavaScript Media SDK（Media 3.x SDK）を追加します。この拡張機能は、Adobe Experience Platform Launch サイトまたはプロジェクトに Media トラッカーインスタンスを追加する機能を提供します。MA 拡張機能には、次の 2 つの拡張拡張機能が必要です。

• Analytics 拡張機能
• Experience Cloud ID 拡張機能

Platform Launch プロジェクトに前述の 3 つの拡張機能をすべて含めたら、次の 2 つの方法のいずれかを実行できます。

• Web アプリケーションから Media API を使用する
• 特定のメディアプレイヤーイベントを Media トラッカーインスタンス上の API にマッピングする、プレーヤー固有の拡張機能を含めたりビルドしたりします。このインスタンスは、MA 拡張機能を通じて公開されます。

MA 拡張機能のインストールと設定

• インストール：MA拡張機能 をインストールするには、拡張機能のプロパティを開き、を選択し Extensions > Catalog、 Adobe Media Analytics (3.x SDK) for Audio and Video 拡張機能の上にマウスポインターを置いて、を選択し Install​ます。

• 設定：MA拡張 を設定するには、 Extensions タブを開き、拡張機能の上にマウスポインターを置いて、次を選択し Configure​ます。

設定オプション：

リマインダー： MA 拡張機能には、 Analytics および Experience Cloud ID 拡張機能が必要です。また、拡張機能プロパティにこれらの拡張機能を追加して設定する必要があります。

MA 拡張機能の使用

webpage/JS-app からの使用

MA 拡張機能は、Configuration ページ内の「Export APIs to Window Object」設定を有効にして、Media API をグローバルウィンドウオブジェクトにエクスポートします。設定された変数名の下に API をエクスポートします。例えば、変数名を ADB に設定している場合、window.ADB.Media によって Media 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. Media トラッカーインスタンスを使用し、JS API ドキュメントに従ってメディアトラッキングを実装します。

サンプルプレイヤーは、MA サンプルプレイヤーで入手できます。サンプルプレイヤーは、Web アプリケーションから直接 Media Analytics をサポートするために、MA 拡張機能を使用する方法を紹介しています。

他の拡張機能からの使用

MA 拡張は、共有モジュールとして media を他の拡張機能に公開します。（共有モジュールについて詳しくは、共有モジュールのドキュメント/を参照してください。）

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. Media トラッカーインスタンスを使用し、JS API ドキュメントに従ってメディアトラッキングを実装します。