重要提示:
在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"
如果已经远程引入安装SDK,请忽略此步骤。下载 RangersAppLog Android SDK 解压,将 aar、jar 引入项目libs文件夹。在AndroidStudio项目中,打开project级别的build.gradle,添加:
在app module的build.gradle并在dependencies中添加:
SDK需要以下权限:
序 号 | 权限 | 说明 |
1 | android.permission.READ_PHONE_STATE | 读取 IMEI等设备信息等作为设备标识 |
2 | android.permission.ACCESS_WIFI_STATE android.permission.ACCESS_NETWORK_STATE android.permission.INTERNET | 网络访问相关,wifi,获取网络状态 |
注:Android 6.0及以上版本,需要在运行时动态检查和申请权限。
在Application 中 onCreate 中初始化RangersAppLog(初始化需要尽可能早)。提示:本SDK默认支持多进程初始化
初始化参数说明 | |
appid | channel |
为增长参谋应用列表中生成的AppID | 自定义,一般为应用市场名称 |
此功能是参谋为了配合投放侧的联调,通过对设备加白,解除投放平台联调需要新设备的限制
在SDK初始化时,启用延迟深度链接,config.enableDeferredALink();
初始化时,通过在IALinkListener中增加onAttributionData方法来获取每一次安装用户的归因数据。
以上检查配置项都完成后,可以在窗口期内卸载重装通过抓包确认联调数据是否触发
抓包接口:
如果在广告投放平台进行投放时只统计激活数,可忽略此步骤。
如果需要此功能,须根据深度事件进行自定义埋点,然后在增长参谋创建推广活动的时候做关联
系统深度事件 | ||
事件类型 | 事件名称(自定义) | 上报时机 |
激活(系统自带,可以不用埋点) | activation | - |
留存(系统自带,可以不用埋点) | app_launch | - |
自定义深度事件 | ||
事件类型(固定) | 事件名称(自定义) | 上报时机(自定义) |
注册 | 例:register | 根据业务场景 |
付费 | 例:pay | 根据业务场景 |
订单 | 例:order | 根据业务场景 |
关键行为 | 例:key_behavior | 根据业务场景 |
下载 | 例:download | 根据业务场景 |
注:自定义埋点事件设计原则如下:
客户端如需要唯一性ID来处理业务逻辑,可以通过SDK获取,建议使用方式二(获取率比较高)
注意:请在初始化完成的3秒后开始获取,否则可能返回为空
SDK提供addDataObserver方法,用以获取各类通知,建议放在 Application 中
设置iid、ssid、did、abconfig从本地加载和server加载成功的回调。 IDataObserver接口方法的参数说明如下:其中 onRemoteIdGet 方法中 s1参数为最新获取的bd_did
用户行为日志采用事件event + 属性params的形式,事件一般对应多个属性,也可以仅有事件没有属性。代码埋点方案一般由数据分析师或产品运营设计。 仅上报事件的代码埋点,示例如下:
上报事件和对应属性的代码埋点,示例如下:
例如上报付费场景,自定义事件名称为pay
,以下为两种上报方式示例,选择其中一种即可
客户端埋点后,需要手动触发,并通过Charles抓包确认埋点是真实上报到服务端的
本地验证阶段,为方便抓包验证埋点,需要把加密开关关闭,上线后建议再开启
自定义埋点触发后会通过相关接口上报埋点信息,需要确认下是否包括自定义埋点事件
抓包接口:https://klink.volceapplog.com/service/2/app_alert_check/
接口返回报文如下代表激活已经成功上报
抓包接口:https://toblog.volceapplog.com/service/2/app_log
检查请求参数中是否携带自定义的事件名称,如有代表自定义事件埋点成功且正常上报
以上激活和相关自定义埋点事件验证成功后,可以跟对应投放平台联调后进行投放
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点