文档中心

Android SDK调试及数据验证

最近更新时间：2023.07.07 13:55:04

首次发布时间：2022.11.29 15:38:19

1. 检查项验证

（1）SDK是否引入，可以通过远程引入和离线引入两种方式引入，推荐远程引入，如果是远程引入检查下app级别的gradle文件是否在dependencies里引入SDK
（2）检查project级别gradle中allprojects的repositories中是否添加maven仓库
（3）如果使用全埋点功能，确定project级别gradle中buildscript的repositories中是否添加maven仓库及dependencies是否增加plugin
（4）如果使用实时埋点监测或者圈选功能，需要做以下验证https://www.volcengine.com/docs/6285/106883
（5）验证plugin，sdk，scheme的版本号是否一致
（6）检查是否集成初始化代码
（7）检查appid是否为想上传应用的appid
（8）检查appid后面的channel字段是否有值，这个字段必填，含义渠道，比如oppo、vivo、huawei等渠道
（9）检查数据上报地址是否设置正确，saas使用默认即可，如果是私有部署需要配置私有部署的数据上传地址，在做数据上报的时候需要保证手机和电脑访问这个地址是通的，本机可以ping下域名
（10）检查ab开关是否开启：config.setAbEnable(true)
（11）检查实验代码是否调用getabcofig方法
（12）以上检查验证完之后就可以调用相关api，比如分流、用户、事件等api上报

2. 实验调试

2.1 为什么要调试实验

实验上线前需要保证前面的集成过程无误，上线后才能保证实验结果的科学和有效！

2.2 开启调试状态

参照创建实验，使实验处于“调试中” 状态，如下图所示：

实验状态一共分三种：调试中、运行中、已结束。

2.3 开始调试验证

（1）看到图片标注的两个Applog相关日志，证明sdk初始化成功（前提需要在初始化打开日志开关）

（2）通过获取ssid api获取ssid，由于sdk初始化之后会去id服务请求ssid，因此请在初始化完成3秒后获取；

// 请在初始化完成的3秒后开始获取，否则可能返回为空
String ssid = AppLog.getSsid(); // 获取SSID

（3）获取到ssid后，将ssid添加到白名单的任意版本做测试，并在右下角点击"保存"按钮。如下：

白名单功能说明（详情请参考此文档：https://www.volcengine.com/docs/6287/65824）
【1】白名单功能主要是用于测试调试实验/feature，添加白名单的用户会被强制命中实验，方便在测试的过程中可以测试实验版本和对照版本的效果。
【2】白名单需要添加分流id，客户端实验分流id是ssid，服务端实验分流id使用的decisionid（也就是代码的第一个id），一般我们建议使用uuid，所以我们也会看到有些白名单是uuid。
（4）运行app，看日志中实验参数是否为添加白名单对应的版本value，未命中实验会返回默认值。

如果返回的是默认值，需要检查
【1】ssid添加后是否做保存
【2】ssid添加的是否正确，运行的ssid是否为添加白名单的ssid
【3】abtest_config接口返回是否为200

【4】如果以上都不是，确定下获取实验参数的代码是否在初始化前执行
（5）如果实验参数获取正常，那么整个实验调试就完成了。