セットアップの概要

重要

2021 年 8 月 31 日にバージョン 4 のモバイル SDK のサポートが終了するのに伴い、iOS および Android 向けの Media Analytics SDK のサポートも終了します。詳しくは、Media Analytics SDK のサポート終了に関する FAQ を参照してください。

以下の手順は、メディア SDK 2.x に適用されます。メディア SDK の 1.x バージョンを実装する場合は、メディア SDK 1.x のドキュメントを参照してください。 Primetime のインテグレーターの場合は、後述の Primetime メディア SDK のドキュメント​を参照してください。

サポートされる最小プラットフォームバージョン

次の表に、2019 年 2 月 19 日より各 SDK でサポートされている最小プラットフォームバージョンを示します。

OS/ブラウザー 必要な最小バージョン
iOS iOS 6 以降
Android Android 5.0 Lollipop 以降
Chrome v22 以降
Mozilla v27 以降
Safari v7 以降
IE v11 以降

一般的な実装のガイドライン

メディアトラッキングには、3 つの主な SDK コンポーネントが関与しています。

  • メディアハートビート設定 - 設定には、レポートの基本設定が含まれています。
  • メディアハートビートデリゲート - このデリゲートは再生時間と QoS オブジェクトを制御します。
  • メディアハートビート - メンバーとメソッドを含むプライマリライブラリ。

次の実装手順を実行します。

  1. MediaHeartbeatConfig インスタンスを作成し、設定パラメーター値を設定します。

    変数名 説明 必須 デフォルト値
    trackingServer メディア分析用のトラッキングサーバー。Analytics トラッキングサーバーとは異なります。 空の文字列
    channel チャネル名 × 空の文字列
    ovp コンテンツの配布に使用するオンラインメディアプラットフォームの名前。 × 空の文字列
    appVersion メディアプレーヤーアプリケーション/SDK のバージョン。 × 空の文字列
    playerName 使用中のメディアプレーヤーの名前(例:「AVPlayer」、「HTML5 Player」、「My Custom Player」)。 × 空の文字列
    ssl 呼び出しを HTTPS 経由でおこなう必要があるかどうかを示します。 × false
    debugLogging デバッグのログが有効になっているかどうかを示します。 × false
  2. MediaHeartbeatDelegate を実装します。

    メソッド名 説明 必須
    getQoSObject() 現在の QoS 情報を含む MediaObject インスタンスを返します。このメソッドは、再生セッション中に複数回呼び出されます。プレーヤー実装は、常に、利用可能な最新の QoS データを返す必要があります。
    getCurrentPlaybackTime() 再生ヘッドの現在の位置を返します。VOD 追跡の場合は、メディアアイテムの開始時からの時間(秒)を返します。線形追跡またはライブ追跡の場合は、プログラムの開始時からの時間(秒)を返します。
    ヒント

    サービス品質(QoS)オブジェクトはオプションです。プレーヤーで QoS データが使用可能であり、そのデータを追跡する場合は、以下の変数が必要です。

    変数名 説明 必須
    bitrate ビット/秒(bps)単位のメディアのビットレート。
    startupTime メディアの起動時間(ミリ秒)。
    fps 1 秒あたりの表示フレーム数。
    droppedFrames それまでのドロップフレームの数。
  3. MediaHeartbeat インスタンスを作成します。

    MediaHertbeatConfig および MediaHertbeatDelegate を使用して、MediaHeartbeat インスタンスを作成します。

    重要

    MediaHeartbeat インスタンスがアクセス可能であることと、セッションの終わりまで解放されないことを確認します。このインスタンスは、以下のすべてのメディアトラッキングイベントに使用されます。

    ヒント

    MediaHeartbeat が Adobe Analytics に呼び出しを送信するためには、AppMeasurement のインスタンスが必要です。

  4. すべての要素を組み合わせます。

    以下のサンプルコードでは HTML5 ビデオプレーヤー用の JavaScript 2.x SDK を使用しています。

    // Create local references to the heartbeat classes
    var MediaHeartbeat = ADB.va.MediaHeartbeat;
    var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
    var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;
    
    //Media Heartbeat Config
    var mediaConfig = new MediaHeartbeatConfig();
    mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net";
    mediaConfig.playerName = "HTML5 Basic";
    mediaConfig.channel = "Video Channel";
    mediaConfig.debugLogging = true;
    mediaConfig.appVersion = "2.0";
    mediaConfig.ssl = false;
    mediaConfig.ovp = "";
    
    // Media Heartbeat Delegate
    var mediaDelegate = new MediaHeartbeatDelegate();
    
    // Set mediaDelegate CurrentPlaybackTime
    mediaDelegate.getCurrentPlaybackTime = function() {
        return video.currentTime;
    };
    
    // Set mediaDelegate QoSObject - OPTIONAL
    mediaDelegate.getQoSObject = function() {
        return MediaHeartbeat.createQoSObject(video.bitrate,  
                                              video.startuptime,  
                                              video.fps,  
                                              video.droppedframes);
    }
    // Create mediaHeartbeat instance      
    this.mediaHeartbeat =  
      new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);  
    

検証

Media Analytics トラッキング実装は、2 つのタイプのトラッキングコールを生成します。

  • メディア開始および広告開始の呼び出しは Adobe Analytics(AppMeasurement)サーバーに直接送信されます。

  • ハートビート呼び出しは、Media Analytics(ハートビート)トラッキングサーバーに送信され、そこで処理されて、Adobe Analytics サーバーに渡されます。

  • Adobe Analytics(AppMeasurement)サーバー トラッキングサーバーオプションについて詳しくは、trackingServer および trackingServerSecure 変数の適切な設定を参照してください。

    重要

    Experience Cloud 訪問者 ID サービスを使用するには、RDC トラッキングサーバーまたは RDC サーバーに解決される CNAME が必要です。

    Analytics トラッキングサーバーは「.sc.omtrdc.net」で終わるか CNAME である必要があります。

  • ** Media Analytics(ハートビート)サーバー** これは、常に「[your_namespace].hb.omtrdc.net」形式になります。「[your_namespace]」の値は会社を指定し、アドビによって提供されます。

メディアトラッキングはあらゆるプラットフォーム、デスクトップ、モバイルで同じように動作します。オーディオトラッキングは、現在、モバイルプラットフォームで動作します。すべてのトラッキングコールに共通する、検証が必要な主要ユニバーサル変数がいくつかあります。

SDK 1.x ドキュメント

Video Analytics 1.x SDK 開発者ガイド(PDF のみ)
Android Android 向け設定
Apple TV Apple TV 向け設定
Chromecast Chromecast 向け設定
iOS iOS 向け設定
JavaScript JavaScript 向け設定
Primetime
TVML TVML 向け設定

Primetime メディア SDK のドキュメント

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free