1.环境准备

• iOS 8.0 及以上
• Xcode 10.0+

2. 导入SDK

2.1 使用CocoaPods安装SDK

在Podfile中，添加source源：

2.2 引入SDK

在Podfile中，引入SDK，并执行pod install --repo-update更新Pods。

2.3 手动安装SDK

注意 6.x 版本开始默认不提供 sdk 包，需要的话请联系技术支持。下载 RangersAppLog iOS SDK 并解压缩。将安装包下的文件复制到项目文件夹下，并在XCode中依次添加到项目中。

2.4 添加依赖

如果您使用CocoaPods安装，请跳过这一步。

• libz.tbd
• libsqlite3.tbd
• CoreGraphics.framework
• CoreFoundation.framework
• Foundation.framework
• UIKit.framework
• Security.framework
• CoreTelephony.framework (读取运营商名称)
• SystemConfiguration.framework (判断网络状态)
• JavaScriptCore.framework (不使用全埋点或圈选功能就不需要依赖)
• WebKit.framework(不使用全埋点、圈选功能和H5打通功能就不需要依赖)
• AdSupport.framework (不使用全埋点或圈选功能就不需要依赖)

同时需要添加编译项 other linker flags，如下图：

• -ObjC
• 或者-force_load $(PROJECT_DIR)/yourpath/[RangersAppLog.framework/Versions/A/RangersAppLog](http://RangersAppLog.framework/Versions/A/RangersAppLog)

3. 添加URL Scheme

在应用信息中找到URL Scheme：

将URL Scheme添加到你的项目中：

如果是iOS 13，重写UISceneDelegate的回调方法：

如果iOS版本低于13，则重写UIApplicationDelegate的回调方法

4.初始化SDK

请在App启动完成的时候，就初始化配置（如果在页面展示完毕之后 才初始化配置，会导致部分事件采集有缺失）。

初始化参数说明
appid	channel
为增长参谋应用列表中生成的AppID	自定义，一般为应用市场名称

5. 深度事件回传（可选）

如果在广告投放平台进行投放时只统计激活数，可忽略此步骤。

如果需要此功能，须根据深度事件进行自定义埋点，然后在增长参谋创建推广活动的时候做关联

4.1系统事件

4.2自定义事件

6. 埋点上报

用户行为日志采用事件event + 属性params的形式，事件一般对应多个属性，也可以仅有事件没有属性。代码埋点方案一般由数据分析师或产品运营设计。仅上报事件的代码埋点，示例如下：

Objective-C请参考：

Swift请参考：

上报事件和对应属性的代码埋点，示例如下：

Objective-C请参考：

Swift请参考：

例如上报付费场景，自定义事件名称为pay，以下为两种上报方式示例，选择其中一种即可