網絡性能的地域分析如下圖所示，

5.1.2 異常統計

網絡請求無法避免異常情況，在埋點時，如果拋出異常打斷了整個網絡請求的流程，那麼您是需要對此做額外處理的，否則將導致打點數據紊亂。處理的辦法也很簡便，您隻需要在抓獲異常以後選擇網絡默認異常類型和自定義網絡異常類型的任意一種方式來標記這次請求發生了異常：

默認網絡異常類型

請參考以上事例。

使用說明：

ALBBMANNetworkError *networkError = [ALBBMANNetworkError ErrorWithHttpException4];
// 網絡異常附加信息
[networkError setProperty:@"IP" value:@"1.2.3.4"];
[bulider requestEndWithError:networkError];

自定義網絡異常類型

如果默認網絡異常類型無法滿足您的需求，您可以自定義網絡異常類型，但是網絡異常類型編碼要在1001 <= YouErrorCode <= 1010範圍內，如果不進行前端配置將以錯誤編碼(10xx)的形式進行展示，如果在前端配置錯誤編碼對應的信息，就會展示您所配置的信息。

使用說明：

ALBBMANNetworkError *networkError = [[ALBBMANNetworkError alloc] initWithErrorCode:1001];
// 自定義網絡異常附加信息
[networkError setProperty:@"IP" value:@"1.2.3.4"];
[bulider requestEndWithError:networkError];

5.2 自定義性能事件埋點

自定義性能事件埋點可滿足用戶對定製化的性能事件進行實時監控的需求(比如，Cache的讀寫耗時，私有網絡協議的RPC耗時，客戶端算法的耗時等）。在進行正確的客戶端埋點後，您可通過阿裏雲控製台進行數據的多維度實時監控。

自定義性能事件可包含以下幾部分內容：

1.事件名稱（event_label）,隻能為字母、數字和下劃線組成【必選】

2.事件從開始到完成消耗的時長【必選】

3.事件所攜帶的屬性【可選】

【注意】 自定義性能事件用於監控用戶事件的時間開銷，請參考下述代碼實例正確傳遞參數。

例子：

ALBBMANCustomPerformanceHitBuilder *customPerfBuilder = [[ALBBMANCustomPerformanceHitBuilder alloc] init:@"HomeActivityInit"];
// 記錄事件時間方式1，自定義性能事件開始
[customPerfBuilder hitStart];
...
// 自定義性能事件結束
[customPerfBuilder hitEnd];
// 設置定義性能事件持續時間，方式2
// [customPerfBuilder setDurationIntervalInMillis:1234];
// 設置擴展參數
[customPerfBuilder setProperty:@"Page" value:@"Home"];
// 組裝日誌並發送
ALBBMANTracker *traker = [[ALBBMANAnalytics getInstance] getDefaultTracker];
[traker send:[customPerfBuilder build]];

完成上述埋點後您可以在控製台【性能分析】中的【自定義性能事件】子頁麵進行自定義性能事件的實時監控，如下圖所示。

5.3 crashHandler

Mobile Analytics 初始化的時候默認會打開 crashHandler，即自動捕獲應用 crash，然後發送 crash 日誌事件。

【注意】如果您的程序中設置了crash捕獲，您的crash捕獲設置會和Mobile Analytics中的crashHandler相互覆蓋，覆蓋結果因兩者運行的先後順序的不同而異。

5.3.1 關閉 crashHandler

接口:

- (void)turnOffCrashHandler;

功能: 關閉 Mobile Analytics 的自動捕獲應用 crash

是否必須調用: 否

調用時機: 初始化SDK時調用

5.3.2 設置 crash 回調方法

接口:

- (void)setCrashCaughtListener:(id<ALBBMANICrashCaughtListener>)aListener;

功能: 設置 crash 發生時的回調函數，使得 MAN 發送的 crash 日誌可以攜帶用戶自定義的擴展信息參數

入參: 實現了 ALBBMANICrashCaughtListener protocol 的類實例，protocol 中需要實現的函數為

- (NSDictionary *)onCrashCaught:(NSString *)pCrashReason CallStack:(NSString *)callStack

該函數在應用發生 crash 時由 Mobile Analytics 來回調，即 Mobile Analytics 會將獲取的 crash 原因以及 crash 時的堆棧信息傳給該回調函數，回調函數經過處理後返回一個字典，Mobile Analytics 得到該字典後，會將該字典裏麵的 kv 對放到 crash 事件日誌中。

是否必須調用: 否

調用時機: 初始化SDK時調用

5.3.3 代碼示例

調用實例:

創建ALBBMANICrashCaughtListener實例：

@implementation TestCrashCaught
- (NSDictionary *)onCrashCaught:(NSString *)pCrashReason CallStack:(NSString *)callStack {
    NSMutableDictionary *ltmpDict = [NSMutableDictionary dictionary];
    [ltmpDict setObject:callStack forKey:pCrashReason];
    return ltmpDict;
}

初始化crash handler：

ALBBMANAnalytics *man = [ALBBMANAnalytics getInstance];
TestCrashCaught *ltestCrashCaught = [[TestCrashCaught alloc] init];
[man setCrashCaughtListener:ltestCrashCaught];

禁止crash handler：

ALBBMANAnalytics *man = [ALBBMANAnalytics getInstance];
[man turnOffCrashHandler];

使用了crash采集功能之後，就可以在前端頁麵看到實時的crash信息，如下圖所示，可以實時查看Crash用戶占比、Crash率、Crash次數和Crash用戶數。

6. 自定義事件

自定義事件埋點可用於滿足用戶的定製化需求。

6.1 設置自定義事件的標簽

接口：

- (void)setEventLabel:(NSString *)pEventId;

功能： 區分不同自定義事件的標簽，同一種自定義事件的 pEventId 相同

入參： 自定義事件標簽，相當於自定義事件的業務 ID，不能為空

是否必須調用： 是

調用時機： 創建 ALBBMANCustomHitBuilder 後，必須調用 setEventLabel，否則調用 build 後返回為 nil

備注： 對於自定義事件，必須設置標簽，pEventId需要事先在wdm上申請

6.2 設置自定義事件的頁麵名稱

接口：

- (void)setEventPage:(NSString *)pPageName;

功能： 設置該自定義事件發生在哪個頁麵

入參： 自定義事件的頁麵名稱，可以為空，這種情況日誌中默認頁麵名稱為 “UT”

是否必須調用： 否

調用時機： 需要明確該自定義事件發生時的頁麵，不調用情況下默認為 “UT”

6.3 設置自定義事件停留時間

接口：

- (void)setDurationOnEvent:(long long)durationOnEvent;

功能： 設置自定義事件持續時間，跟 ALBBMANPageHitBuilder 中的頁麵停留時間類似

入參： 自定義事件停留時間

是否必須調用： 否

調用時機： 需要記錄自定義事件的停留時間

6.4 設置自定義事件擴展參數

接口：

- (void)setProperty:(NSString *)pKey value:(NSString *)pValue;

功能：給單條日誌添加一個擴展參數

入參：key 和 value 都不能為 nil，其中 key 不能為PAGE/EVENTID/ARG1/ARG2/ARG3/ARGS，否則 build 返回 nil

是否必須調用：否

調用時機：需要給ALBBMANCustomHitBuilder實例添加擴展參數時

6.5 代碼示例

ALBBMANCustomHitBuilder *customBuilder = [[ALBBMANCustomHitBuilder alloc] init];
// 設置自定義事件標簽
[customBuilder setEventLabel:@"test_event_label"];
// 設置自定義事件頁麵名稱
[customBuilder setEventPage:@"test_Page"];
// 設置自定義事件持續時間
[customBuilder setDurationOnEvent:12345];
// 設置自定義事件擴展參數
[customBuilder setProperty:@"ckey0" value:@"value0"];
[customBuilder setProperty:@"ckey1" value:@"value1"];
[customBuilder setProperty:@"ckey2" value:@"value2"];
ALBBMANTracker *traker = [[ALBBMANAnalytics getInstance] getDefaultTracker];
// 組裝日誌並發送
NSDictionary *dic = [customBuilder build];
[traker send:dic];

自定義事件擴展參數在控製台【自定義事件】-【詳細數據】-【參數分析】中可查看，但查看之前請在【管理設置】-【自定義事件管理】中添加要在控製台顯示的事件ID。 如果您需要對自定義事件進行實時監控，請參考【5.3 自定義性能事件】章節。

7. 如何實時驗證數據是否正常上報

您當前可以通過以下兩種方式進行驗證：

• 打開移動數據分析log，查看是否會出現如***** UTMCEngine <info> ***** UTMCUploader:upload :: upload response:{"t":1464532326870,"ret":"","success":"success"}的日誌；

  注意：SDK的日誌上報會有緩存和聚合，因此上報時機會比API調用時機滯後一些，可耐心等待30-60s或將應用切到後台查看。

• 登錄控製台查看活躍用戶等實時報表；

  注意：活躍用戶的統計依賴頁麵埋點，移動數據分析後台會將零星的頁麵埋點處理為噪點，進行過濾，因此請確保您有足量的頁麵埋點事件上報（>5），另外控製台的實時報表大概會有5min的延遲。

最後更新：2016-12-20 21:18:46

  上一篇： 指標說明__快速開始_移動數據分析-阿裏雲

  下一篇： 功能使用常見問題__幫助手冊_移動數據分析-阿裏雲