全部產品
Search
文件中心

Quick Tracking:基礎整合

更新時間:Jun 20, 2025

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橋接事件,預設關閉