快速集成
通过以下方式可以快速完成SDK的集成,更多方式请查SDK集成文档
集成配置
将以下JS代码复制到您所需分析页面中的<head>
和</head>
标签之间。只要保证在以下代码之下即可。无需等待window.onload
之后再执行。
获取上报地址
登录易观方舟系统后点击”管理“——”数据接入管理“——”集成SDK接入数据”——“获取数据接收地址”
点击后即可获取您的数据上报地址。
基础模块介绍
初始化方法
appkey(必须) 在网站获取的 AppKey
debugMode 设置调试模式:0 - 关闭调试模式(默认);1 - 开启调试模式,数据不入库;2 - 开启调试模式,数据入库
uploadURL(必须) 设置上传数据接口
autoTrack 设置是否启用全埋点功能:false - 不启用全埋点功能(默认);true - 启用全埋点功能(SDK 版本 4.4.0 及以后支持)
初始化示例代码
自定义事件接口
用户行为追踪,可以设置自定义属性。接口如下:
eventName:事件ID,以字母或
$
开头,包含字母、数字、下划线和$
,字母不区分大小写,$
开头为预置事件/属性,不支持乱码和中文,取值长度 1 - 99字符properties:自定义属性,用于对事件描述。properties 最多包含 100条,且 key 以字母或
$
开头,包含字母、数字、下划线和$
,字母不区分大小写,$
开头为预置事件/属性,不支持乱码和中文,取值长度 1 - 99字符,value 支持类型:String/Number/boolean/JSON/内部元素为String的Array,若为字符串,取值长度 1 - 255字符callback:数据发送完毕后的回调函数,支持类型:Function(需SDK版本4.4.1及以后支持)
代码示例:
账号关联
用户关联的主要作用是打通用户登录前后的行为,做过用户关联的用户在登录前后的行为在方舟系统里面会被认为是一个用户。
建议在用户注册成功、登录成功后、或在检测登录状态的业务代码中需要调用 alias 接口。
接口如下:
aliasId:需要关联的用户ID。 取值长度 1 - 255字符,支持类型:String
callback:数据发送完毕后的回调函数,支持类型:Function(需SDK版本4.4.1及以后支持)
示例:
设置用户属性
给用户设置单个或多个属性,如果之前不存在,则新建,否则覆盖。接口如下:
callback :数据发送完毕后的回调函数,支持类型:Function(需SDK版本4.4.1及以后支持)
示例:
验证数据
开启Debug模式后,可以通过在浏览器的开发者工具中查看相应上报日志
检查上报地址是否正确
检查是否发送成功
检查事件名称及内容与预期相同
最后更新于
这有帮助吗?