Show Menu
主題×

Video Analytics

以下提供一些關於透過視訊測量解決方案在 Android 上測量視訊的資訊。
在視訊播放期間,會傳送頻繁的「心率」呼叫給此服務,測量播放時間。這些心率呼叫每 10 秒傳送一次,因此可產生精細的視訊參與量度,以及更精確的視訊流失報表。如需 Adobe 視訊測量解決方案的詳細資訊,請參閱 在 Adobe Analytics 中測量音訊和視訊
所有平台上測量視訊的一般程序都很相似。本內容提供開發人員作業的基本概覽和程式碼範例。下表列出會傳送至 Analytics 的媒體資料。使用處理規則,將內容資料對應至 Analytics 變數。

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

  • a.media.name
    • 變數類型: eVar
      • 預設過期時間: 造訪
      • Custom Insight (s.prop,用於視訊路徑)
    • ( 必要 ) 當訪客以某種方式檢視視訊時,這個內容資料變數會按照實施中指定的方式來收集視訊的名稱。您可以新增此變數的分類。
    • ( 選用 ) Custom Insight 變數可提供視訊路徑資訊。
  • 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);