SDK基本信息
SDK名稱 | 版本號 | md5值 | 包名 |
QuickTracking iOS SDK | 最新版本:1.5.8.PX 更新日志:iOS SDK更新日志 | 637921107a258712aa26d5ba61f3d611 | com.quicktracking.sdk.ios.QTCommon |
1 快速集成
在QuickTracking后臺,為每一個App生成了專屬的集成代碼,可以根據產品內的引導進行集成。注意,需要檢查目前是否已經使用了友盟+SDK,如果已經使用,請及時設置更改SDK文件路徑,具體設置方式請參考本文檔中1.6章節部分內容。
1.1 進入產品后臺
1.2 找到應用歸屬組織
1.3 找到應用
1.4 點擊“去集成”
1.5 點擊后可以獲取專屬集成代碼
1.6 檢查是否與友盟+SDK沖突
注意,需要檢查目前是否已經使用了友盟+SDK,如果已經使用,請務必設置更改SDK文件路徑。
更改SDK文件路徑方式:
已經集成了友盟+SDK,現在需要集成QT SDK:在QT和友盟+的所有代碼最前面增加(至少早于收數域名)[QTConfigure resetStorePath];
已經集成了QT SDK,現在需要集成友盟+SDK:在QT和友盟+的所有代碼最前面(至少早于收數域名)增加[UMConfigure resetStorePath];
如果不按照上述的邏輯調用,則會使友盟+SDK與QT SDK共同使用一個存儲路徑,導致日志混亂。具體邏輯為:先調用的哪個SDK初始化方法,就重新設置另外一個SDK的文件路徑,比如先初始化的友盟+SDK,就調用 [QTConfigure resetStorePath];,如果是先初始化的QT SDK,就需要調用[UMConfigure resetStorePath];
2 集成代碼明細
如果因為特定原因,無法抵達上述頁面,需要觀看文檔才可以進行集成,具體集成代碼如下:
2.1 參數準備
appkey:在應用列表中獲取
收數域名:在“管理控制臺-采集信息”模塊中獲取
2.2 引入SDK
在終端執行pod setup命令,拉取最新pod庫時間較長。
$ pod setup
Cocoapods集成可靈活配置所需SDK,如工程target名為“QuickTrackingDemo”,可選添下面的SDK,如在項目根目錄的Podfile的格式:
target 'QuickTrackingDemo' do
pod '<Quick Tracking SDK名>'
end
說明 :由于 pod search 命令對新增項目可能出現無法找到的情況,建議直接使用 pod update 命令進行直接更新。
Quick Tracking基礎庫
//QuickTracking 統計分析 SDK
pod 'QTCommon', '~> 1.5.8.PX'//需要指定版本號
//可在項目中加入 “基礎庫-日志庫” 中的 UMCCommonLog 進行開發調試。
pod 'UMCCommonLog'
說明:UMCCommonLog 為開發階段進行調試SDK及相關功能使用,可在發布 App 前移除
2.3 手動集成
依賴庫:
CoreTelephony.framework 獲取運營商標識
libz.tbd 數據壓縮
libsqlite3.tbd 數據緩存
SystemConfiguration.framework 判斷網絡狀態
libc++.tbd C++ 標準庫
工程配置:
選擇SDK功能組件并下載,解壓.zip文件得到相應組件包(例如:QTCommon.framework等)。
Xcode
File
—>Add Files to"Your Project"
,在彈出Panel選中所下載組件包->Add
。(注:選中“Copy items if needed”)添加依賴庫,在項目設置
target
-> 選項卡General ->Linked Frameworks and Libraries如下:
Targets->BuildSettings 中, Other Linker Flags增加-ObjC,?定要添加此項,注意是?寫C,不是?寫c。
2.4 引入頭文件
#import <QTCommon/QTCommon.h>
#import <UMCommonLog/UMCommonLogManager.h> //引入日志包時需要添加
3 埋點驗證配置
添加您的 URL Scheme 到項目中,URL Scheme 位于項目設置 target ->選項卡 Info ->URL Types。填入的scheme:atm.yourappkey。在AppDelegate中調用函數[QTMobClick handleUrl:url]來接收 URL
AppDelegate調用:
- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
if ([QTMobClick handleUrl:url]) {
return YES;
}
return YES;
}
SceneDelegate調用:
- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {
for (UIOpenURLContext *context in connectionOptions.URLContexts) {
[QTMobClick handleUrl:context.URL];
}
}
- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
[QTMobClick handleUrl:URLContexts.allObjects.firstObject.URL];
}
4 IDFA說明
【Quick Tracking】SDK默認采集idfa標識,用來更準確的分析核對數據。對于應用本身沒有獲取idfa的情況,建議將應用提交至AppStore時按如下方式配置:(以避免被蘋果以“應用不含廣告功能,但獲取了廣告標識符IDFA”為由拒絕上架。)
Quick Tracking SDK不主動申請IDFA獲取權限,若您的App本身就沒有申請IDFA權限,Quick Tracking是不會觸發客戶端權限申請的彈窗的。