Show Menu
トピック×

ビデオ分析

ビデオ分析に役立つ情報です。
Video measurement is described in detail in the Measuring video and audio in Adobe Analytics guide. ビデオ測定の一般的なプロセスは、AppMeasurement のすべてのプラットフォームでほぼ同一です。このクイックスタートでは、開発者のタスクに関する基本的な概要とコード例を示します。
次の表に、Analytics に送信されるメディアデータのリストを示します。処理ルールを使用して、コンテキストデータをAnalytics変数にマップします。
  • a.media.name
    ( Required ) Collects the name of the video, as specified in the implementation, when a visitor views the video in some way.You can add classifications for this variable.
    オプション )カスタムインサイト変数は、ビデオパス情報を提供します。
    • 変数型:eVar
    • デフォルトの有効期限:訪問
    • カスタムインサイト(s.prop、ビデオパスに使用)
  • a.media.name
    オプション )ビデオパス情報を提供します。この変数に対して、ClientCare でパスを有効にする必要があります。
    • イベントタイプ:カスタムインサイト(s.prop)。
    • 変数型:カスタムインサイト(s.prop)
  • a.media.segment
    必須 )セグメント名や、ビデオ内でのセグメントの発生順序を含め、ビデオセグメントデータを収集します。
    この変数を入力するには、プレーヤーイベントを自動的に追跡する場合に segmentByMilestones 変数を有効にするか、プレーヤーイベントを手動で追跡する場合にカスタムセグメント名を設定します。For example, when a visitor views the first segment in a video, SiteCatalyst might collect the following in the 1:M:0-25 segments eVar.
    デフォルトのビデオデータ収集方法では、ビデオの開始(再生)時、セグメントの開始時およびビデオの終了(停止)時にデータが収集されます。Analytics は、訪問者が視聴を開始したときに最初のセグメントビューをセグメントの先頭としてカウントします。後続のセグメントビューは、セグメントの開始としてカウントされます。
    • 変数型:eVar
    • デフォルトの有効期限:ページビュー
  • a.contentType
    訪問者によって閲覧されたコンテンツのタイプに関するデータを収集します。ビデオ測定によって送信されるヒットには、「ビデオ」のコンテンツタイプが割り当てられます。この変数は、ビデオ追跡専用に予約する必要はありません。同じ変数を使用する他のコンテンツレポートコンテンツタイプを使用することにより、異なるコンテンツのタイプでの訪問者の分布を分析できます。例えば、この変数を使用する「記事」や「製品ページ」などの値を使用して、他のコンテンツタイプにタグを付けることができます。
    ビデオ測定の見地からすると、コンテンツタイプを使用することによってビデオ訪問者を識別でき、その結果、ビデオのコンバージョン率を計算できます。
    • 変数型:eVar
    • デフォルトの有効期限:ページビュー
  • a.media.timePlayed
    前回のデータ収集プロセス(イメージリクエスト)以降のビデオ視聴秒数をカウントします。
    • 変数型:イベント
    • タイプ:カウンター
  • a.media.view
    訪問者がビデオの一部を視聴したことを示します。ただし、訪問者がビデオを視聴した時間や視聴した部分に関する情報は提供されません。
    • 変数型:イベント
    • タイプ:カウンター
  • a.media.segmentView
    訪問者がビデオセグメントの一部を視聴したことを示します。ただし、訪問者がビデオを視聴した時間や視聴した部分に関する情報は提供されません。
    • 変数型:イベント
    • タイプ:カウンター
  • a .media.complete
    ユーザーがビデオを最後まで視聴したことを示します。デフォルトでは、完了イベントはビデオが終了する 1 秒前に測定されます。導入時に、表示完了と見なすビデオの終わりからの秒数を指定できます。終わりが定義されないライブビデオやその他のストリーミングの場合は、完了を測定するためのカスタムポイントを指定できます。例えば、表示開始から特定の時間が経過したポイントなどです。
    • 変数型:イベント
    • タイプ:カウンター

Configure media settings

ビデオの追跡に使用したい設定で MediaSettings オブジェクトを設定します。
var mySettings = ADB.Media.settingsWith("name", 10, "playerName", "playerId");

Track player events

To measure video playback, The Play , Stop , and Close methods need to be called at the appropriate times. 例えば、プレーヤーが一時停止した場合は Stop が呼び出され、再生が開始または再開された場合は Play が呼び出されます。

クラス

クラス:MediaSettings

property Platform::String ^name; 
property Platform::String ^playerName; 
property Platform::String ^playerID; 
property double length; 
property Platform::String ^channel; 
property Platform::String ^milestones; 
property Platform::String ^offsetMilestones; 
property bool segmentByMilestones; 
property bool segmentByOffsetMilestones; 
property int trackSeconds; 
property int completeCloseOffsetThreshold; 
 
// MediaAnalytics Ad settings 
property Platform::String ^parentName; 
property Platform::String ^parentPod; 
property Platform::String ^CPM; 
property double parentPodPosition; 
property bool isMediaAd;

Media measurement class and method reference

  • SettingsWith (winJS:settingsWith)
    指定したパラメーターと共に MediaSettings オブジェクトを返します。
    • このメソッドの構文を次に示します。
      static MediaSettings ^SettingsWith(Platform::String ^name,  double length, Platform::String ^playerName, Platform::String  ^playerID); 
      
      
    • このメソッドのコードサンプルを次に示します。
      var  mySettings  =  ADB.Media.settingsWith("name", 10,  "playerName", "playerId"); 
      
      
  • AdSettingsWith (winJS:adSettingsWith)
    広告ビデオの追跡に使用する MediaSettings オブジェクトを返します。
    • このメソッドの構文を次に示します。
      static MediaSettings ^AdSettingsWith(Platform::String ^name,  double length, Platform::String ^playerName, Platform::String  ^parentName, Platform::String ^parentPod, double parentPosition,  Platform::String ^CPM);
      
      
    • このメソッドのコードサンプルを次に示します。
      var  myAdSettings = ADB.Media.adSettingsWith("name", 10,  "playerName", "parentName", "parentPod", 5, "myCPM");
      
      
  • 開く(winJS:開く)
    Tracks a media open using the settings defined in settings .
    • このメソッドの構文を次に示します。
      static void Open(MediaSettings ^settings);
      
      
    • このメソッドのコードサンプルを次に示します。
      ADB.Media.open(mySettings);
      
      
  • 閉じる(winJS:終了)
    Tracks a media close for the media item named name .
    • このメソッドの構文を次に示します。
      static  void  Close(Platform::String  ^name);
      
      
    • このメソッドのコードサンプルを次に示します。
      ADB.Media.close("mediaName"); 
      
      
  • 再生(winJS:再生)
    指定された offset name (秒)で指定された ** のメディアアイテムの再生を追跡します。
    • このメソッドの構文を次に示します。
      static  void  Play(Platform::String ^name, double offset);
      
      
    • このメソッドのコードサンプルを次に示します。
      ADB.Media.play("mediaName",  0);
      
      
  • 完了(winJS:完了)
    指定された​ オフセット ​でメディアアイテムが再生完了されたことを手動で記録します。
    • このメソッドの構文を次に示します。
      static  void  Complete(Platform::String ^name, double offset);
      
      
    • このメソッドのコードサンプルを次に示します。
      ADB.Media.complete("mediaName", 8);
      
      
  • 停止(winJS:停止)
    指定された offset でビデオが停止または一時停止されたことを記録します。
    • このメソッドの構文を次に示します。
      static void Stop(Platform::String ^name, double offset);
      
      
    • このメソッドのコードサンプルを次に示します。
      ADB.Media.stop("mediaName",  4);
      
      
  • (winJS:クリック)
    メディアアイテムがクリックされたことを記録します。
    • このメソッドの構文を次に示します。
      static void Click(Platform::String ^name, double  offset);
      
      
    • このメソッドのコードサンプルを次に示します。
      ADB.Media.click("mediaName",  3); 
      
      
  • 追跡(winJS:トラック)
    現在のメディア状態をトラックアクション呼び出し(ページビューがカウントされない方式)で送信します。
    • このメソッドの構文を次に示します。
      static void Track(Platform::String ^name, Windows::Foundation::Collections::IMap<Platform::String^,  Platform::Object> ^contextData); 
      
      
    • このメソッドのコードサンプルを次に示します。
      ADB.Media.track("mediaName",  null);