ビデオ分析

ビデオ測定の一般的なプロセスは、すべてのAppMeasurementプラットフォームで非常に似ています。 ここでは、開発者タスクの基本的な概要とコードサンプルについて説明します。

For more information about Video measurement, see the Measuring audio and video in Adobe Analytics guide. 次の表に、Analytics に送信されるメディアデータのリストを示します。処理ルールを使用して、Context Data Variable列のコンテキストデータをAnalytics変数にマップします(変数タイプ列を参照)。

プレーヤーイベントの Analytics 変数へのマッピング

  • a.media.name

    (必須)訪問者が何らかの方法でビデオを表示した場合に、実装で指定されているビデオの名前を収集します。この変数に分類を追加できます。

    (オプション) Custom Insight変数はビデオパス情報を提供します。

    • 変数名:eVar
      • デフォルトの有効期限:訪問
      • Custom Insight(s.prop、ビデオパスに使用)
  • a.media.name

    オプション)ビデオパス情報を提供します。この変数に対して、ClientCareでパスを有効にする必要があります。

    • イベントタイプ:カスタムインサイト(s.prop)
    • Custom Insight(s.prop)
  • a.media.segment

    (Required) Collects video segment data, including the segment name and the order in which the segment occurs in the video. この変数を入力するには、プレーヤーイベントを自動的に追跡する場合に segmentByMilestones 変数を有効にするか、プレーヤーイベントを手動で追跡する場合にカスタムセグメント名を設定します。

    For example, when a visitor views the first segment in a video, SiteCatalyst might collect 1:M:0-25 in the Segments eVar. デフォルトのビデオデータ収集方法では、ビデオ開始(再生)、セグメントの開始、ビデオの終了(停止)ポイントでデータが収集されます。

    Analyticsは、訪問者開始が視聴しているときに、最初のセグメント表示をセグメントの開始でカウントします。 後続のセグメント表示は、セグメントの開始時に行われます。

    • 変数型:eVar
    • デフォルトの有効期限:ページビュー
  • a.contentType

    訪問者によって閲覧されたコンテンツのタイプに関するデータを収集します。ビデオ測定によって送信されるヒットには、「ビデオ」のコンテンツタイプが割り当てられます。 この変数は、ビデオ追跡専用に予約する必要はありません。 同じ変数を使用する他のコンテンツレポートコンテンツタイプを使用すると、異なるタイプのコンテンツに対する訪問者の分布を分析できます。 例えば、この変数を使用する「記事」や「製品ページ」などの値を使用して、他のコンテンツタイプにタグを付けることができます。ビデオ測定の見地からすると、コンテンツタイプを使用することによってビデオ訪問者を識別でき、その結果、ビデオのコンバージョン率を計算できます。

    • 変数型:eVar
    • デフォルトの有効期限:ページビュー
  • a.media.timePlayed

    前回のデータ収集プロセス(イメージリクエスト)以降のビデオ視聴秒数をカウントします。

    • 変数型:イベント
    • タイプ:カウンター
  • a.media.view

    訪問者がビデオの一部を視聴したことを示します。ただし、訪問者がビデオを視聴した時間や視聴した部分に関する情報は提供されません。

    • 変数型:イベント
    • タイプ:カウンター
  • a.media.segmentView

    訪問者がビデオセグメントの一部を視聴したことを示します。ただし、訪問者がビデオを視聴した時間や視聴した部分に関する情報は提供されません。

    • 変数型:イベント
    • タイプ:カウンター
  • a .media.complete

    ユーザーがビデオを最後まで視聴したことを示します。デフォルトでは、完了イベントはビデオが終了する 1 秒前に測定されます。導入時に、表示完了と見なすビデオの終わりからの秒数を指定できます。終わりが定義されないライブビデオやその他のストリーミングの場合は、完了を測定するためのカスタムポイントを指定できます。例えば、表示開始から特定の時間が経過したポイントなどです。

    • 変数型:イベント
    • タイプ:カウンター

プレーヤーイベントの追跡

ビデオの再生を測定するには、mediaPlaymediaStop および mediaClose メソッドを適切なときに呼び出す必要があります。例えば、プレーヤーが一時停止した場合は mediaStop が呼び出され、再生が開始または再開された場合は mediaPlay が呼び出されます。

メディア測定クラスとメソッドのリファレンス

  • open

    追跡するビデオを開きます。

    • このメソッドの構文を次に示します。

      void open(QString name, double length, QString playerName, QString playerID = QString()); 
      
    • このメソッドのコードサンプルを次に示します。

        ADBMediaAnalytics::sharedInstance()->open("name", 10.0, "playerName", "playerID"); 
      
  • openAd

    追跡用の MediaSettings オブジェクトを開きます。

    • このメソッドの構文を次に示します。

      void openAd(QString name, double length, QString playerName, QString parentName, QString parentPod, double parentPodPosition, QString CPM); 
      
    • このメソッドのコードサンプルを次に示します。

      ADBMediaAnalytics::sharedInstance()->openAd("name", 10, "playerName", "parentName", "podName", 0, "CPM"); 
      
  • close

    name という名前のメディアアイテムを閉じます。

    • このメソッドの構文を次に示します。

      void close(QString name);
      
    • このメソッドのコードサンプルを次に示します。

      ADBMediaAnalytics::sharedInstance()->close("name");
      
  • play

    Plays the media item named name at the given offset (in seconds).

    • このメソッドの構文を次に示します。

      void play(QString name, double offset);
      
    • このメソッドのコードサンプルを次に示します。

      ADBMediaAnalytics::sharedInstance()->play("name", 0); 
      
  • complete

    Manually mark the media item as complete at the offset provided (in seconds).

    • このメソッドの構文を次に示します。

      void complete(QString name, double offset);
      
    • このメソッドのコードサンプルを次に示します。

      ADBMediaAnalytics::sharedInstance()->complete("name", 0);
      
  • stop

    指定された offset でビデオが停止または一時停止されたことを記録します。

    • このメソッドの構文を次に示します。

      stop(QString name, double offset);
      
    • このメソッドのコードサンプルを次に示します。

      ADBMediaAnalytics::sharedInstance()->stop("name", 0);
      
  • click

    メディアアイテムがクリックされたことを記録します。

    • このメソッドの構文を次に示します。

      void click(QString name, double offset);
      
    • このメソッドのコードサンプルを次に示します。

      ADBMediaAnalytics::sharedInstance()->close("name", 0);
      
  • track

    現在のメディア状態をトラックアクション呼び出し(ページビューがカウントされない方式)で送信します。

    • このメソッドの構文を次に示します。

      track(QString name, QHash<QString, QString> additionalData = QHash<QString, QString>()); 
      
    • このメソッドのコードサンプルを次に示します。

      ADBMediaAnalytics::sharedInstance()->track("name", null);
      

このページ