快速集成
通过以下方式可以快速完成SDK的集成,更多方式请查SDK集成文档
集成配置
选择集成工具
注意:aar集成方式需要android sdk V4.4.0以上版本才支持,
远程aar配置
dependencies
{
//默认使用最新版本SDK,如需要使用特别版本请指定版本号 implementation('cn.com.analysys:analysys-arkanalysys:4.5.13')
}
获取上报地址
登录易观方舟系统后点击”管理“——”数据接入管理“——”集成SDK接入数据”——“获取数据接收地址”
点击后即可获取您的数据上报地址。
基础模块
以下接口生效依赖于基础SDK模块,
初始化接口
建议在应用 Application 中调用 SDK 初始化接口 init(), 配置 AppKey、Channel,注意:初始化接口为必须调用接口。 接口如下:
context :应用上下文对象
config :为自定义实体 bean,用于设置初始化属性值,目前config支持的属性有:
AppKey:在网站获取的 AppKey
channel:应用下发的渠道
setAutoTrackClick:是否开启全埋点点击事件, 默认值:
false
设置上传地址
自定义上传地址,接口设置后,所有事件信息将上传到该地址。 接口如下:
context:应用上下文对象
url:数据上传地址,格式为
scheme://host + :port
(不包含/
后的内容)。scheme 必须以http://
或https://
开头,host 只支持域名和 IP,取值长度 1 - 255 字符,port 端口号必须携带
Debug 接口
Debug 接口主要用于开发者测试。可以开/关日志,通过logcat查看tag为analysys
的Log日志。 接口如下:
context:应用上下文对象
debugMode:debug 模式,默认关闭状态。发布版本时 debugMode 模式设置为
0
0
:表示关闭 Debug 模式1
:表示打开 Debug 模式,但该模式下发送的数据仅用于调试,不计入平台数据统计2
:表示打开 Debug 模式,该模式下发送的数据可计入平台数据统计注意:若设置其他值则不生效,使用默认值。
初始化示例代码
自定义事件接口
用户行为追踪,可以设置自定义属性。 接口如下:
context:应用上下文对象
eventName:自定义事件ID标识,以字母开头的字符串,必须由字母、数字、下划线组成,$ 开头为预置事件/属性,不支持乱码、中文、空格等,长度范围1-99字符。
eventInfo:自定义属性,K-V键值对,用于对事件的描述。最多包含100条,且
key
是以字母开头的字符串,必须由字母、数字、下划线组成,字母不区分大小写,不支持乱码、中文、空格等,长度范围1-99字符;value
支持类型:String/Number/Boolean/JSON/内部元素为String的Array,若为字符串,长度范围1-255字符。
示例:
账号关联
用户关联的主要作用是打通用户登录前后的行为,做过用户关联的用户在登录前后的行为在方舟系统里面会被认为是一个用户。建议在用户注册成功或者登录成功后客户端需要调用 alias 接口。
接口如下:
context:应用上下文对象
aliasId:需要关联的用户ID。 取值长度 1 - 255 字符
示例:
设置用户属性
给用户设置单个或多个属性,如果之前不存在,则新建,否则覆盖。 接口如下:
示例:
验证数据
开启Debug模式后,用户可以通过AndroidStudio或其他开发工具的控制台中查看tag为[analysys]
的Log日志
检查上报地址是否正确
检查是否发送成功
检查事件名称及内容与预期相同
最后更新于