方舟智能分析
产品功能
SDK指南
API
搜索文档…
方舟智能分析
产品简介
快速上手
产品更新日志
我要反馈
🐱
Part I 产品功能说明
名词解释
指标说明
看板
分析
用户
运营
项目管理
平台管理
🐵
Part II 技术文档
技术接入准备工作
SDK 指南
Android SDK
iOS SDK
JS SDK
微信小程序 SDK
支付宝小程序 SDK
字节跳动小程序 SDK
百度小程序 SDK
钉钉小程序 SDK
QQ小程序 SDK
快应用 SDK
华为WeCode小程序
PhoneGap SDK
mPaaS SDK
ReactNative SDK
Flutter SDK
Java SDK
Python SDK
PHP SDK
C++ SDK
C# SDK
Node JS SDK
Lua SDK
Golang SDK
SDK FAQ
数据验证
数据导入
数据导出
脚本工具
API
第三方登录
GDPR 合规
�� Part III 常见问题
License 许可
产品试用及采购
参与贡献
由
GitBook
提供支持
SDK 指南
易观方舟支持全端数据接入,接入前准备事项详见
《接入前准备》
易观方舟SDK已全部开源,详见:
Github上的易观方舟SDK
客户端 SDK
客户端 SDK 用于客户端,采集用户与应用界面产生交互的行为,这些行为只会在客户端发生,而不会传输到服务器端,常见的比如页面打开、按钮点击等。
客户端 SDK 类型
适用范围
Android SDK
用于 Android 原生和 Hybrid App
iOS SDK
用于 iOS 原生和 Hybrid App
JS SDK
用于 Web 网站和 H5 页面
微信小程序 SDK
用于微信小程序
支付宝小程序 SDK
用于支付宝小程序
百度小程序 SDK
用于百度小程序
字节跳动小程序 SDK
用于字节跳动小程序
钉钉小程序 SDK
用于钉钉小程序
QQ小程序 SDK
用于QQ小程序
快应用 SDK
用于快应用联盟小程序
华为WeCode小程序
用于华为WeCode小程序
Flutter SDK
用与Flutter开发的应用
Reactnative SDK
用与Reactnative开发的应用
服务端 SDK
服务端
SDK 应用于服务端,采集用户行为产生的业务结果数据,比如注册成功、支付成功等,是在程序与数据交互的界面埋点,能够更准确的记录业务数据的改变。
服务端 SDK 类型
适用范围
Java SDK
用于服务端 Java 应用,如 Java Web 应用的后台服务
Python SDK
用于服务端 Python 应用,如 Python Web 应用的后台服务
PHP SDK
用于服务端 PHP 应用,如 PHP Web 应用的后台服务
C++ SDK
用于服务端 C++ (也称CPP、C plus plus)应用,如 C++ 应用的后台服务
C# SDK
用于服务端或客户端 C# 应用
Node JS SDK
用于服务端 Node 应用,如 Node Web 应用的后台服务
Lua SDK
用于服务端 Lua 应用
Golang SDK
用于服务端 Golang 应用
应用场景
1 采集业务结果数据比客户端 SDK 更准确
业务结果数据指注册、订单、支付等,会存在于业务数据库中的数据。相比客户端 SDK 更准确的原因有:1. 网络传输造成的丢数 2. 客户端SDK尚未上送数据时,页面已经跳转,造成一定比例的数据丢失,尤其是支付等会跳转到第三方服务再跳转回来的场景,数据丢失的比例会更大等等。
2 关键业务变动,但用户没有行为
有些数据客户端 SDK 无法采集到,比如货到付款数据、超时不支付订单自动取消数据、物流状态变化数据等,但这些数据对用户行为的业务结果分析至关重要,就可以使用服务端 SDK
3 其他业务系统关键数据的同步
比如CRM中客户跟进状态变化的数据,B2B企业客户付费情况变化的数据等
数据量较小时,可采用服务端SDK,该场景还可使用 Restful-API 或导入工具实现
4 业务系统历史数据导入
比如历史注册、历史订单、历史支付等
数据量较小时,可采用服务端SDK,该场景还可使用 Restful-API 或导入工具实现
另外需注意:历史数据导入要先于通过埋点采集新发生的数据
注意事项
1 基础配置
1.
数据接收地址:
http://host:port
2.
AppKey,确定数据上报的项目
更多具体配置详见各个SDK的文档
2 必报数据
一句话概括:
什么人,在什么时间,从什么地方来,在什么环境下,做了什么事,有什么结果
什么人
1.
isLogin:用户 ID 是否是登录 ID;采集业务结果数据时,该值一般为“是”,即“true”
2.
aliasId:用户注册 ID,长度大于 0,且小于 255字符;需从客户端传递到服务端
3.
distinctId:自定义设备身份标识,长度大于 0 且小于 255字符
在什么时间
xwhen:用户自定义时间戳(带毫秒的13位时间戳)
从什么地方来
session_id:由方舟客户端SDK生成,用于识别流量来源,从客户端传递到服务端后,才能在方舟渠道分析/Session分析等分析模型中,按来源类属性细分时,查看到不同来源下的相关数据
如果分析渠道转化目标的事件比如注册成功等,是在服务端进行埋点的,一定要注意 session_id 的传递
在什么环境下
platform:平台类型,支持自定义
为保证与用户发生行为的平台对应,便于更好的让数据还原真实用户行为,建议内容范围为:JS、WeChat、Android、iOS、Alipay、Baidu、ByteDance、DingTalk、QQMini、Quickapp 方舟客户端 SDK 所支持的平台,此时,需从客户端传递到服务端。
做了什么事
eventName:自定义事件 ID 标识(需与事件设计方案保持一致)
以字母开头的字符串,必须由字母、数字、下划线组成,$ 开头为预置事件/属性,不支持乱码、中文、空格等,长度范围1~100字符
有什么结果
properties:自定义事件属性
最多包含 100条(需与事件设计方案保持一致),且key是以字母开头的字符串,必须由字母、数字、下划线组成,字母不区分大小写,不支持乱码、中文、空格等,长度范围1~100字符;value 类型约束(String/Number/boolean/list/数组),若为字符串,最大长度 255 字符。
所有语言类型的服务端 SDK 使用时,上述字段均为必填字段,并遵循上述使用方法;否则,会出现数据缺失或无法对应的情况,导致数据无法反映真实用户行为,基于这样的数据进行的分析,无法帮助业务成长。
数据导入
数据导入
常见问题
SDK FAQ
以前
分平台上报数据 vs 跨平台打通
下一个
Android SDK
最近更新
1yr ago
复制链接
内容
客户端 SDK
服务端 SDK
应用场景
注意事项
数据导入
常见问题