macOS SDK合規
合規聲明
工信部的合規要求應用APP在使用者同意隱私政策前不可以擷取任何個人資訊,因此您需要在您的應用初次開機時彈出《隱私政策》徵得使用者同意。
您務必告知您的使用者,您APP整合了QuickTracking SDK服務,並在《隱私政策》中增加如下參考條款:
我們的產品整合Quick Tracking SDK,Quick Tracking SDK需要收集您的OS/OSVERSION/TIMEZONE/LANGUAGE/RESOLUTION/裝置廠商/裝置型號/裝置品牌/網路以提供統計分析服務。
您務必確保您的使用者同意了《隱私政策》後,再初始化QuickTracking SDK,否則如果使用者不同意《隱私政策》授權,則不能初始化QuickTracking SDK。
SDK 初始化
注意:需要在 程式入口主線程 初始化 SDK,否則可能會丟失部分事件數目據。
擷取appkey
在初始化SDK時,需要填寫參數appkey。appkey是在QuickTracking中代表應用的唯一ID,在建立應用時產生,其擷取或查看方法詳見文檔:應用管理
擷取收數網域名稱
收數網域名稱是SDK上報日誌的網域名稱伺服器地址,在 "QuickTracking管理後台--管理主控台--採集資訊--收數網域名稱" 擷取
SDK 初始化
#import <QuickTrackingSDK/QuickTrackingSDK.h>
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
QTSDKConfig *sdkConfig;
// 初始化SDK配置
sdkConfig = [[QTSDKConfig alloc] initWithAppkey:@"您的應用唯一標識"
trackDomain:@"https://您的收數網域名稱"
launchOptions:nil];
// 設定應用發布渠道,例如:appstore
sdkConfig.channel = @"您的應用發布渠道";
// 設定批量發送最小時間間隔(毫秒),預設3s
sdkConfig.batchSendInterval = 3000;
// 開啟 SDK日誌列印,預設關閉
sdkConfig.enableLog = YES;
// 確保 SDK 不被禁用,預設為 NO
// sdkConfig.disableSDK = NO;
// App 進入後台時等待資料發送結果,預設為 NO
// sdkConfig.enableSendLogsBeforeEnterBackground = YES;
// “QuickTracking管理後台--資料擷取--埋點驗證--PC應用驗證” 標識
// sdkConfig.debugKey = @"97052112091876_xxxxx";
// 設定本機快取事件條數上限,預設值為10000條,超過部分刪除處理
// sdkConfig.maxCacheSize = 10000;
// 是否開啟H5橋接事件監聽,預設關閉
// sdkConfig.enableJSBridge = YES;
// 初始化 SDK
[QuickTrackingSDK initWithConfig:sdkConfig];
}QTSDKConfig參數說明
參數 | 類型 | 描述 | 是否必填 |
appkey | nonnull NSString | 應用的唯一編碼,即應用的 appkey。 | 是 |
trackDomain | nonnull NSString | 資料收集的網域名稱,用於確定資料發送的目的地。 | 是 |
launchOptions | nullable id | 啟動選項,這通常包含應用啟動時的配置屬性(可以為 nil)。 | 否 |
QTSDKConfig屬性列表
參數 | 類型 | 描述 | 是否必填 |
batchSendInterval | NSInteger | 兩次資料發送的最小時間間隔,單位毫秒。預設值為 3 秒,最小值為3秒。 | 否 |
maxCacheSize | NSInteger | 本機快取事件條數上限,預設值為10000條,超過部分刪除處理。 | 否 |
batchSendQueueSize | NSInteger | 觸發上傳的緩衝日誌上限,預設值為 100,注意設定的值過大會導致網路請求丟包。 | 否 |
enableLog | BOOL | 是否開啟日誌列印。預設值為 NO。 | 否 |
disableSDK | BOOL | 是否禁用 SDK,預設值為 NO。禁用後SDK 將不會觸發事件,也不會發送網路請求。 | 否 |
enableSendLogsBeforeEnterBackground | BOOL | App 進入後台時是否等待資料發送結果。預設值為 NO。設定 YES 會等待資料發送結果。 | 否 |
cacheFilePath | NSString | 自訂埋點資料存放區路徑。此路徑僅適用於 macOS 開發環境。 | 否 |
channel | NSString | 應用發布渠道,用於標識應用的發布渠道資訊。 | 否 |
debugKey | NSString | 埋點驗證標識,用於在驗證資料流程中提供確認標識。 | 否 |
enableJSBridge | Boolean | H5橋接開關,用於監聽H5橋接事件,預設關閉 | 否 |