Show Menu
TOPICS×

JavaScript 3.x のセットアップ

前提条件

  • 有効な設定パラメーターを取得
    これらのパラメーターは、Analytics アカウントの設定後、アドビの担当者から取得できます。
  • メディアアプリケーションで、JavaScript 向け
    AppMeasurement
    Experience Cloud Identity Service
    を実装します
    。詳しくは、 JavaScript を使用した Analytics の実装 および Experience Cloud ID サービスの実装 を参照してください。
  • メディアプレーヤーで以下の機能を設定します。
    • プレーヤーイベントをサブスクライブするための API
      - メディア SDK では、プレーヤーでイベントが発生する際に、シンプルな API のセットを呼び出す必要があります。
    • プレーヤー情報を提供する API
      - 現在再生中のメディア、広告、チャプターに関する情報が含まれます。
  1. ダウンロードした ライブラリをプロジェクトに追加します。利便性のために、クラスへのローカル参照を作成します。
    1. ダウンロードした
      MediaSDK-js-v3*.zip
      ファイルを展開します。
    2. libs
      ディレクトリに
      MediaSDK.js
      ファイルが存在することを確認します。
    3. MediaSDK.js
      ファイルをホストします。
      このコア JavaScript ファイルは、サイトのすべてのページから参照可能な Web サーバーでホストする必要があります。次の手順で、これらのファイルへのパス情報が必要になります。
    4. サイトのすべてのページから
      MediaSDK.js
      を参照します。
      各ページの
      <head>
      タグまたは
      <body>
      タグに以下のコードを追加して、JavaScript 用の
      MediaSDK
      を含めます。例:
      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.js"></script>
    5. ライブラリが正常に読み込まれたことをすばやく確認するには、Window オブジェクトで
      ADB.Media
      が書き出されていることを確認します。
      JavaScript SDK は、AMD および CommonJS モジュールの仕様に準拠しており、互換性のあるモジュールローダーと共に
      MediaSDK.js
      を使用することもできます。
  2. AppMeasurement
    のインスタンスを作成し、
    visitor
    を設定します。
    メディア SDK の設定には、
    visitor
    が設定された
    AppMeasurement
    のインスタンスが必要です。
    var appMeasurement = new AppMeasurement(“<rsid>”); appMeasurement.visitor = visitor; appMeasurement.trackingServer = “<visitor_namespace>.sc.omtrdc.net”;
  3. メディア SDK の設定
    メディア SDK は、Web ページごとに 1 回設定する必要があります。設定は、作成されるすべてのトラッカーインスタンスに適用されます。
    Media SDK(3.x)は、メディアコレクション API を使用して、2.x SDK で使用されている HB エンドポイントとは異なるメディアを追跡します。詳細については、アドビの担当者にお問い合わせください。
    MediaConfig
    初期化のサンプル:
    // Create MediaConfig object (same as above) var mediaConfig = new ADB.MediaConfig(); mediaConfig.trackingServer = Configuration.MEDIA_COLLECTION_ENDPOINT; mediaConfig.playerName = Configuration.PLAYER_NAME; mediaConfig.channel = Configuration.CHANNEL; mediaConfig.appVersion = Configuration.APP_VERSION; mediaConfig.debugLogging = false; mediaConfig.ssl = true; ADB.Media.configure(mediaConfig, appMeasurement);
  4. MediaTracker
    インスタンスを作成します。
    メディア SDK の設定後、
    getInstance
    API を使用して、メディアコンテンツを追跡するためのトラッカーインスタンスを作成できます。
    var tracker = ADB.Media.getInstance();
    tracker
    インスタンスがアクセス可能であることと、メディアセッションの終わりまで解放されないことを確認します。このインスタンスは、そのセッションで、その後のイベントをすべて追跡するために使用されます。

JavaScript 2.x から 3.x への移行

2.x から 3.x への移行について詳しくは、 2.x から 3.x への移行 を参照してください。