Show Menu
トピック×

セットアップの概要

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
Apple TV
Chromecast
iOS
JavaScript
Primetime
TVML

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