1. 环境准备

• Gradle编译环境（Android Studio）

2. 导入SDK

2.1 使用远程引入安装SDK

在project级别的build.gradle文件中添加Maven的仓库地址

示例：

如果需要使用无全埋点的基础版本，只需要引入下面的 Lite 文件，不需要引入插件

在主module的build.gradle文件添加SDK依赖

注意： 6.x 版本开始，app级别的build.gradle,需要添加kotlin相关依赖，如已经添加，可忽略implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.3.61"

2.2 手动安装SDK

如果已经远程引入安装SDK，请忽略此步骤。下载 RangersAppLog Android SDK 解压，将 aar、jar 引入项目libs文件夹。在AndroidStudio项目中，打开project级别的build.gradle，添加：

在app module的build.gradle并在dependencies中添加：

2.3 SDK所需的App权限

SDK需要以下权限：

注：Android 6.0及以上版本，需要在运行时动态检查和申请权限。

3. 初始化SDK

在Application 中 onCreate 中初始化RangersAppLog（初始化需要尽可能早）。提示：本SDK默认支持多进程初始化

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

4.联调管理

此功能是参谋为了配合投放侧的联调，通过对设备加白，解除投放平台联调需要新设备的限制

4.1 启用延迟深度链接

在SDK初始化时，启用延迟深度链接，config.enableDeferredALink();

4.2 SDK集成onAttributionData方法

初始化时，通过在IALinkListener中增加onAttributionData方法来获取每一次安装用户的归因数据。

4.3 注意事项

• 下载应用或者使用本地应用并打开时，需提前开启隐私授权，并保证在SDK初始化之前进行
• 深度事件联调时需真机打开应用并保证触发，用于联调深度事件的设备需预先触发激活，可先联调激活，并于5min内继续联调深度事件
• 监测留存事件，如监测失败，可选择手动上报快速完成联调
• 联调管理加白的did要与实际联调设备的did保持一致，否则加白效果不生效

4.4 抓包验证

以上检查配置项都完成后，可以在窗口期内卸载重装通过抓包确认联调数据是否触发

抓包接口：

1. https://toblog-alink.ctobsnssdk.com/service/2/attribution_data
2. https://alink.volceapplog.com/service/2/attribution_data
3. 或者其他带有alink开头的域名，以上检测到任一一个接口即可

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

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

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

5.1 系统事件

5.2 自定义事件

注：自定义埋点事件设计原则如下：

• event 命名仅支持字母（建议小写）、数字和下划线，不要使用 launch、terminate等系统内置事件名
• param 命名仅支持字母（建议小写）、 数字和下划线
• _param 的值仅支持以下类型（请按实际数据类型填写，便于后续计算分析），不支持数组和对象
• 字符串
• 整型
• 浮点型_
• param 值空的含义，建议用“be_null”，不建议使用""或" "

5.3 BD_DID获取

客户端如需要唯一性ID来处理业务逻辑，可以通过SDK获取，建议使用方式二（获取率比较高）

方式一

注意：请在初始化完成的3秒后开始获取，否则可能返回为空

方式二

SDK提供addDataObserver方法，用以获取各类通知，建议放在 Application 中

设置iid、ssid、did、abconfig从本地加载和server加载成功的回调。 IDataObserver接口方法的参数说明如下：其中 onRemoteIdGet 方法中 s1参数为最新获取的bd_did

6. 埋点上报

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

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

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

7. 埋点验证

客户端埋点后，需要手动触发，并通过Charles抓包确认埋点是真实上报到服务端的

7.1 关闭加密开关

本地验证阶段，为方便抓包验证埋点，需要把加密开关关闭，上线后建议再开启

7.2 验证上报参数

自定义埋点触发后会通过相关接口上报埋点信息，需要确认下是否包括自定义埋点事件

7.2.1 激活上报

抓包接口：https://klink.volceapplog.com/service/2/app_alert_check/

接口返回报文如下代表激活已经成功上报

7.2.2 自定义埋点上报

抓包接口：https://toblog.volceapplog.com/service/2/app_log

检查请求参数中是否携带自定义的事件名称，如有代表自定义事件埋点成功且正常上报

以上激活和相关自定义埋点事件验证成功后，可以跟对应投放平台联调后进行投放