引入&配置SDK

1 快速集成

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

1.1 进入产品后台

image

1.2 找到应用归属组织

image

1.3 找到应用

image

1.4 点击“去集成”

image

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

image

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  判断网络状态

工程配置:

  1. 选择SDK功能组件并下载,解压.zip文件得到相应组件包(例如:UMCommon.framework等)。

  2. XcodeFile—>Add Files to"Your Project",在弹出Panel选中所下载组件包->Add。(注:选中“Copy items if needed”)1615343030211-98b36cd1-0f77-4bb6-9ee4-2dd5eb0bf1bf

  3. 添加依赖库,在项目设置target -> 选项卡General ->Linked Frameworks and Libraries

    如下:1615343052184-db860bef-a753-494f-92da-243a8c136b2d

  4. Targets->BuildSettings 中 , Other Linker Flags增加-ObjC,⼀定要添加此项,注意是⼤写C,不是⼩写c。

3 IDFA说明

  1. 【Quick Tracking】SDK默认采集idfa标识,用来更准确的分析核对数据。对于应用本身没有获取idfa的情况,建议将应用提交至AppStore时按如下方式配置:(以避免被苹果以“应用不含广告功能,但获取了广告标示符IDFA”的而拒绝其上架。)1612266822165-29c8614c-00ce-4dd0-958e-76f02754d244

  2. 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;
}

阿里云首页 全域采集与增长分析 相关技术圈