視頻分析

以下提供一些關於透過視訊測量解決方案在 Android 上測量視訊的資訊。

秘訣

在視訊播放期間，會傳送頻繁的「心率」呼叫給此服務，測量播放時間。這些心率呼叫每 10 秒傳送一次，因此可產生精細的視訊參與量度，以及更精確的視訊流失報表。有關Adobe視頻測量解決方案的詳細資訊，請參閱 測量Adobe Analytics流媒體。

所有平台上測量視訊的一般程序都很相似。本內容提供開發人員作業的基本概覽和程式碼範例。下表列出會傳送至 Analytics 的媒體資料。使用處理規則，將內容資料對應至 Analytics 變數。

將播放器事件對應至 Analytics 變數

  • a.media.name

    • 變數類型: eVar
      • 預設過期時間：造訪
      • 自訂分析 (s.prop，用於視訊路徑)
    • (必要) 訪客以某種方式檢視視訊時，此內容資料變數會收集視訊名稱，如實施中所指定。您可以為此變數新增分類。
    • (選用) 自訂深入分析變數能提供視訊路徑資訊。

  • a.media.name

    • 變數類型: Custom Insight (s.prop)

    • (選用) 提供視訊路徑資訊。

      重要

      必須由 ExpCare 為此變數啟用路徑。

      * 事件類型: 自訂分析 (s.prop)

  • a.media.segment

    • 變數類型: eVar

    • 預設過期時間: 頁面檢視

    • (必要) 收集視訊區段資料，包括區段名稱和視訊中區段發生的順序。

      您可在自動追蹤播放器事件時啟用 segmentByMilestones 變數，或在手動追蹤播放器事件時設定自訂區段名稱，藉此填入此變數。例如，當訪客檢視視訊中的第一個區段時，SiteCatalyst 可能會在區段 eVar 中收集以下資訊: 1:M:0-25.

      系統會於下列時間點，以預設的視訊資料收集方法收集資料：

      • 視訊開始 (播放)
      • 區段開始
      • 視訊結束 (停止)

      當訪客開始觀看時，Analytics 會在區段的開頭計算第一個區段檢視次數。後續區段會在區段開始時計為檢視次數。

  • a.contentType

    • 變數類型: eVar

    • 預設過期時間: 頁面檢視

    • 收集訪客所檢視內容類型的相關資料。

      視訊測量傳送的點擊會被指派為 video 的內容類型。從視訊測量觀點來看，內容類型​可讓您識別視訊訪客，並據此計算視訊轉換率。

  • a.media.timePlayed

    • 變數類型: 事件
    • 類型: 計數器
    • 計算自上次資料收集程序 (影像要求) 以來，用於觀看視訊的時間 (以秒為單位)。

  • a.media.view

    • 變數類型: 事件

    • 類型: 計數器

    • 指出有訪客檢視了視訊的某部分。

      但此變數並不會提供有關訪客檢視視訊時長或觀看部分的任何資訊。

  • a.media.segmentView

    • 變數類型: 事件

    • 類型: 計數器

    • 指出有訪客檢視了視訊區段的某部分。

      但此變數並不會提供有關訪客檢視視訊時長或觀看部分的任何資訊。

  • a .media.complete

    • 變數類型: 事件

    • 類型: 計數器

    • 指出使用者已檢視完整的視訊。

      預設情況下，完成事件會在視訊結尾之前 1 秒測量。實施期間，您可以指定想要將距離視訊結尾幾秒視為檢視完成。對於沒有定義結束點的直播視訊和其他串流，您可以指定自訂時間點來測量完成次數 (例如在訪客檢視一定的時間長度之後測量)。

設定媒體設定

以您要用來追蹤視訊的設定，設定 MediaSettings 物件。

MediaSettings mySettings = Media.settingsWith("name", 10, "playerName", "playerId");

追蹤播放器事件

若要測量視訊播放，必須在適當時間呼叫 mediaPlay、mediaStop 以及 mediaClose 方法。舉例來說，當播放器暫停時，需呼叫 mediaStop；播放開始或繼續時則是呼叫 mediaPlay。

類別

類別: MediaSettings

public String name;
public String playerName;
public String playerID;
public double length;
public String channel;
public String milestones;
public String offsetMilestones;
public boolean segmentByMilestones;
public boolean segmentByOffsetMilestones;
public int trackSeconds = 0;
public int completeCloseOffsetThreshold = 1;

// MediaAnalytics Ad settings
public String parentName;
public String parentPod;
public String CPM;
public double parentPodPosition;
public boolean isMediaAd;

類別: MediaState

public Date openTime = new Date();
public String name;
public String segment;
public String playerName;
public String mediaEvent;
public int offsetMilestone;
public int segmentNum;
public int milestone;
public double length;
public double offset;
public double percent;
public double timePlayed;
public double segmentLength;
public boolean complete = false;
public boolean clicked = false;
public boolean ad;
public boolean eventFirstTime;

媒體測量類別與方法參考

以下是媒體測量類別中的方法:

  • settingsWith

    傳回 MediaSettings 物件以及指定的參數。

    • 以下是此方法的語法:

      public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);

    • 以下是此方法的範例程式碼:

      MediaSettingsmySettings = Media.settingsWith("name", 10, "playerName", "playerId");

  • adSettingsWith

    傳回 MediaSettings 物件以便用於追蹤廣告視訊。

    • 以下是此方法的語法:

      public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);

  • open

    開啟 MediaSettings 物件以供追蹤。

    • 以下是此方法的語法:

      public static void open(MediaSettings settings, MediaCallback callback);

    • 以下是此方法的範例程式碼:

      Media.open(mySettings, new Media.MediaCallback() {
  @Override
  public void call(Object item)
  {//  monitor  callback  if  you  want  to  be  notified  every  second  the  media  is  playing  }
  });

    • close

      關閉命名為​「名稱」​的媒體項目。

      • 此方法的語法如下：
      public static void close(String name);

    • 以下是此方法的範例程式碼:

      Media.close("name");

  • play

    • 在指定的​偏移處 (以秒為單位) 播放命名為​「名稱」​的媒體項目。

    • 以下是此方法的語法:

      publicstatic void play(String name, double offset);

  • complete

    在提供的​偏移處 (以秒為單位) 手動將媒體項目標示為已完成。

    • 以下是此方法的語法:

      public static void complete(String name, double offset);

    • 以下是此方法的範例程式碼:

      Media.complete("name", 0);

  • stop

    通知媒體模組，視訊已在指定的​偏移處​停止或暫停。

    • 以下是此方法的語法:

      public static void stop(String name, double offset);

    • 以下是此方法的範例程式碼:

      Media.stop("name", 0);

  • click

    通知媒體模組，媒體項目已被點按。

    • 此方法的語法如下：

      public static void click(String name double offset);

    • 以下是此方法的範例程式碼:

      Media.click("name", 0);

  • track

    傳送目前媒體狀態的追蹤動作呼叫 (無頁面檢視)。

    • 此方法的語法如下：

      publicstatic void track(String name, Map<String, Object> data);

    • 此方法的程式碼範例如下：

      Media.track("name", null);

本頁內容