Quick Tracking：基礎整合

1. 網域名稱設定

在初始化之前，開發人員需要在調用SDK任意其它介面之前最先調用setCustomDomain介面設定私人化環境收數網域名稱。

介面：

/** 設定上報統計日誌的主網域名稱和備用網域名稱。此函數必須在SDK初始化函數調用之前調用。
*
@param primaryDomain 傳日誌的主網域名稱收數地址,參數不能為null或者空串。
@param standbyDomain 上傳日誌備用網域名稱收數地址,參數可以為null或者空串，若此參數為空白，SDK內部會自動將主網域名稱設定為備用網域名稱。
*/

+ (void)setCustomDomain:(NSString *)primaryDomain standbyDomain:(NSString *)standbyDomain;

參數：

APM穩定性庫相關網域名稱介面：

+ (void)setLogUploadUrl:(NSString* _Nonnull)uploadUrl;

APM效能庫相關網域名稱介面：

+ (void) setLogUploadUrl: (NSString *) uploadUrl;

樣本：

#import <UMAPM/UMAPMConfig.h>
#import <UMAPM/UMCrashConfigure.h>
#import <UMEFS/UMEFS.h>
#import <UMEFS/UMEFSConfig.h>
#import <UMEFS/UMEFSConfigure.h>
#import <QTCommon/QTCommon.h>
#import <UMCommonLog/UMCommonLogManager.h> //引入日誌包時需要添加

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    UMAPMConfig* config = [UMAPMConfig defaultConfig];   
    config.crashAndBlockMonitorEnable = YES;
    [UMCrashConfigure setAPMConfig:config];

    UMEFSConfig* configForEFS = [UMEFSConfig defaultConfig];
    configForEFS.networkEnable = YES;
    configForEFS.launchMonitorEnable = YES;
    configForEFS.memMonitorEnable = YES;
    configForEFS.javaScriptBridgeEnable = YES;
    configForEFS.oomMonitorEnable = YES;
    configForEFS.pageMonitorEnable = YES;
    configForEFS.logCollectEnable = YES;
    configForEFS.logCollectUserId = @"user1";
    configForEFS.initSendPVEnable = YES;
    [UMEFSConfigure setAPMConfig:configForEFS];

    [QTConfigure setCustomDomain:@"您的收數服務網域名稱" standbyDomain:@""];
    [QTConfigure initWithAppkey:@"您的appkey" channel:@"App Store"];
    
    /**
     * 如果需要單獨設定APM收數網域名稱，請通過以下介面設定
     * [UMCrashConfigure setLogUploadUrl:@"您的收數服務網域名稱"]; //v2.1.0 及以上版本支援
     * [UMEFSConfigure setLogUploadUrl:@"您的收數服務網域名稱"]; //v2.1.0 及以上版本支援
     * [QTConfigure initWithAppkey:@"您的appkey" channel:@"App Store" shouldPluginsTrackDomainIndepent:YES]; //v1.5.6.PX 及以上版本支援
     */
  
    return YES;
}

請注意：如果資料統計和效能體驗使用的是一個收數網域名稱，那麼僅需要設定："[QTConfigure setCustomDomain:@"您的收數服務網域名稱" standbyDomain:@""];" 即可。

2. 設定裝置ID標識（可選）

APM SDK使用的是QTCommon SDK產生的裝置ID，但是在APM 中裝置ID有強校正的邏輯，如果您有對裝置ID做自訂動作（自訂方式參考：2.1 裝置ID設定），您傳入的自訂裝置ID需要滿足以下條件：

• 長度：16-34 字元

• 類型：大小寫字母或數字

3. 設定使用者標識（可選）

介面：

+ (void)profileSignInWithPUID:(NSString *)puid;
+ (void)profileSignOff;

參數：

樣本：

[QTMobClick profileSignInWithPUID:@"UserID"];

4. 初始化

4.1 初始化介面

為保證您的App在整合統計SDK之後，能夠滿足工信部相關合規要求，您應確保App首次冷啟動時，在使用者閱讀您的《隱私政策》並取得使用者授權之後，才調用正式初始化函數初始化統計SDK，此時SDK才會真正採集裝置資訊並上報資料。反之，如果使用者不同意《隱私政策》授權，則不能調用初始化函數。

/** 初始化所有組件產品
 @param appKey 開發人員在QT申請的appkey.
 @param channel 渠道標識，可設定nil表示"App Store".
 */
+ (void)initWithAppkey:(NSString *)appKey channel:(NSString *)channel;

一旦App擷取到《隱私政策》的使用者授權，後續的App冷啟動，開發人員應該保證調用到初始化函數。

4.2. Appkey擷取

在產品的 “管理主控台” -> “應用管理” 中，找到您的應用擷取。

5. 開啟日誌

介面：

+ (void)setLogEnable:(BOOL)enable;

如果需要查看SDK初始化階段的日誌，請在初始化之前設定開啟日誌，建議在調用設定收數網域名稱和初始化SDK介面之前開啟。

標頭檔：

#import <UMEFS/WPKLog.h>

樣本：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    [UMCommonLogManager setUpUMCommonLogManager];
    [QTConfigure setLogEnabled:YES];//設定開啟資料統計日誌
    [WPKLog setLogEnable:YES];//設定開啟效能體驗日誌
    [QTConfigure setCustomDomain:@"您的收數服務網域名稱" standbyDomain:nil];//設定收數網域名稱
    [QTConfigure initWithAppkey:@"您的appkey" channel:@"App Store"];
}