以下提供一些關於透過視訊測量解決方案在 Android 上測量視訊的資訊。
在視訊播放期間,會傳送頻繁的「心率」呼叫給此服務,測量播放時間。這些心率呼叫每 10 秒傳送一次,因此可產生精細的視訊參與量度,以及更精確的視訊流失報表。有關Adobe視頻測量解決方案的詳細資訊,請參閱 測量Adobe Analytics流媒體。
所有平台上測量視訊的一般程序都很相似。本內容提供開發人員作業的基本概覽和程式碼範例。下表列出會傳送至 Analytics 的媒體資料。使用處理規則,將內容資料對應至 Analytics 變數。
a.media.name
a.media.name
變數類型: Custom Insight (s.prop)
(選用) 提供視訊路徑資訊。
必須由 ExpCare 為此變數啟用路徑。
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);