iOSSDK如何引入和配置_全域采集与增长分析-阿里云帮助中心

1 快速集成

在QuickTracking后中，为每一个App生成了专属的集成代码，可以根据产品内的引导进行集成。注意，需要检查目前是否已经使用了友盟+SDK，如果已经使用，请及时查看文档。

1.1 进入产品后台

1.2 找到应用归属组织

1.3 找到应用

1.4 点击“去集成”

1.5 点击后可以获取专属集成代码

1.6 检查是否与友盟+SDK冲突

注意，需要检查目前是否已经使用了友盟+SDK，如果已经使用，请及时查看文档。

2 集成代码明细

如果因为特定原因，无法抵达上述页面，需要观看文档才可以进行集成，具体集成代码如下：

2.1 参数准备

appkey：在应用列表中获取

收数域名：在“管理控制台-采集信息”模块中获取

SDK链接：在“管理控制台-采集信息”模块中获取

2.2 引入SDK

在终端执行pod setup命令，拉取最新pod库时间较长。

$ pod setup

Cocoapods集成可灵活配置所需SDK，如工程target名为QTPlusDemo，可选添下面的SDK，如在项目根目录的Podfile的格式：

target 'QTPlusDemo' do     
pod '<Quick Tracking SDK名>' 
end

说明：由于 pod search 命令对新增项目可能出现无法找到的情况，建议直接使用 pod update 命令进行直接更新。

Quick Tracking基础库

//新用户或者使用友盟+时，请使用PX系列SDK
pod 'QTCommon', '~> 1.4.1.PX'
  
//历史用户可继续使用P系列SDK
pod 'UMCommon', '~> 1.4.1.P'  

//从1.3.9.P开始，需要删除SPM SDK
//pod 'UMSPM' 
 
//可在项目中加入 “基础库-日志库” 中的 UMCCommonLog 进行开发调试。
pod 'UMCCommonLog'

说明：UMCCommonLog 为开发阶段进行调试SDK及相关功能使用，可在发布 App 前移除

2.3 手动集成

依赖库：

CoreTelephony.framework    获取运营商标识
    
    libz.tbd  数据压缩
    
    libsqlite3.tbd  数据缓存
     
    SystemConfiguration.framework  判断网络状态

工程配置：

选择SDK功能组件并下载，解压.zip文件得到相应组件包（例如：UMCommon.framework等）。
XcodeFile—>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。

3 IDFA说明

【Quick Tracking】SDK默认采集idfa标识，用来更准确的分析核对数据。对于应用本身没有获取idfa的情况，建议将应用提交至AppStore时按如下方式配置：（以避免被苹果以“应用不含广告功能，但获取了广告标示符IDFA”的而拒绝其上架。）
Quick Tracking SDK不主动申请IDFA获取权限，若您的App本身就没有申请IDFA权限，Quick Tracking是不会触发客户端权限申请的弹窗的。

4 埋点验证配置

添加您的 URL Scheme 到项目中，URL Scheme 位于项目设置 target ->选项卡 Info ->URL Types。填入的scheme：atm.yourappkey。在AppDelegate中调用函数[MobClick handleUrl:url]来接收 URL

- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
    if ([QTMobClick handleUrl:url]) {
        return YES;
    }

    return YES;
}