# 快速集成
通过以下方式可以快速完成SDK的集成,更多方式请查SDK集成文档
## 集成配置
### 选择集成工具
1、AndroidStudio SDK 集成
**注意:aar集成方式需要android sdk V4.4.0以上版本才支持,**
**远程aar配置**
```
{
//默认使用最新版本SDK,如需要使用特别版本请指定版本
implementation('cn.com.analysys:analysys-arkanalysys:4.5.13')
}
```
2、Eclipse SDK 集成
将需要的 jar 包拷贝到本地工程 libs 子目录下;在Eclipse中右键工程根目录,选择 `property —> Java Build Path —> Libraries` ,然后点击 Add External JARs... 选择指向 jar 的路径,点击 OK,即导入成功。(ADT17 及以上不需要手动导入)
## 获取上报地址
登录易观方舟系统后点击”管理“——”数据接入管理“——”集成SDK接入数据”——“获取数据接收地址”
点击后即可获取您的数据上报地址。

## 基础模块
以下接口生效依赖于基础SDK模块,
### 初始化接口
建议在应用 Application 中调用 SDK 初始化接口 init(), 配置 AppKey、Channel,注意:初始化接口为必须调用接口。 接口如下:
```java
public static void init(Context context, AnalysysConfig config);
```
* context :应用上下文对象
* config :为自定义实体 bean,用于设置初始化属性值,目前config支持的属性有:
1. AppKey:在网站获取的 AppKey
2. channel:应用下发的渠道
3. setAutoTrackClick:是否开启全埋点点击事件, 默认值:`false`
### 设置上传地址
自定义上传地址,接口设置后,所有事件信息将上传到该地址。 接口如下:
```java
public static void setUploadURL(Context context, String url);
```
* context:应用上下文对象
* url:数据上传地址,格式为 `scheme://host + :port`(不包含`/`后的内容)。**scheme** 必须以 `http://` 或 `https://` 开头,**host** 只支持域名和 IP,取值长度 1 - 255 字符,**port** 端口号必须携带
### Debug 接口
Debug 接口主要用于开发者测试。可以开/关日志,通过logcat查看tag为`analysys`的Log日志。 接口如下:
```java
public static void setDebugMode(Context context, int debugMode);
```
* context:应用上下文对象
* debugMode:debug 模式,默认关闭状态。发布版本时 debugMode 模式设置为`0`
* `0`:表示关闭 Debug 模式
* `1`:表示打开 Debug 模式,但该模式下发送的数据仅用于调试,不计入平台数据统计
* `2`:表示打开 Debug 模式,该模式下发送的数据可计入平台数据统计
注意:若设置其他值则不生效,使用默认值。
### 初始化示例代码
```java
public class AnalysysApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// 设置 打开 debug 模式,上线时请屏蔽
AnalysysAgent.setDebugMode(this, 2);
// 对SDK开始初始化
AnalysysConfig config = new AnalysysConfig();
// 设置key,77a52s552c892bn442v721为样例数据,请根据实际情况替换相应内容
config.setAppKey("77a52s552c892bn442v721");
// 设置渠道
config.setChannel("豌豆荚");
// 设置控件点击自动上报总开关
config.setAutoTrackClick(true);
// 调用SDK初始接口
AnalysysAgent.init(this, config);
// 设置上传地址,http://example.com:port为您上报地址
AnalysysAgent.setUploadURL(mContext,"http://example.com:port");
}
}
```
## 自定义事件接口
用户行为追踪,可以设置自定义属性。 接口如下:
```java
public static void track(Context context, String eventName);
public static void track(Context context, String eventName, Map<String, Object> eventInfo);
```
* context:应用上下文对象
* eventName:自定义事件ID标识,以字母开头的字符串,**必须由**字母、数字、下划线组成,$ 开头为预置事件/属性,**不支持**乱码、中文、空格等,长度范围1-99字符。
* eventInfo:自定义属性,K-V键值对,用于对事件的描述。最多包含100条,且`key`是以字母开头的字符串,**必须由**字母、数字、下划线组成,字母不区分大小写,**不支持**乱码、中文、空格等,长度范围1-99字符;`value`支持类型:String/Number/Boolean/JSON/内部元素为String的Array,若为字符串,长度范围1-255字符。
示例:
```java
// 添加事件
AnalysysAgent.track(mContext, "back");
......
// 用户购买手机
Map<String, Object> info = new HashMap<>();
info.put("type", "Phone");
info.put("name","Apple iPhone8");
info.put("money", 4000);
info.put("count",1);
AnalysysAgent.track(mContext, "buy", info);
```
## 账号关联
用户关联的主要作用是打通用户登录前后的行为,做过用户关联的用户在登录前后的行为在方舟系统里面会被认为是一个用户。**建议在用户注册成功或者登录成功后客户端需要调用 alias 接口。**
接口如下:
```java
public static void alias(Context context, String aliasId);
```
* context:应用上下文对象
* aliasId:需要关联的用户ID。 取值长度 1 - 255 字符
示例:
```java
// 登陆账号时调用,只设置当前登陆账号即可和之前行为打通
AnalysysAgent.alias(mContext,"sanbo");
```
## 设置用户属性
给用户设置单个或多个属性,如果之前不存在,则新建,否则覆盖。 接口如下:
```java
//设置单个用户属性
public static void profileSet(Context context, String propertyName, Object propertyValue);
//设置多个用户属性
public static void profileSet(Context context, Map<String, Object> property);
```
* context:应用上下文对象
* propertyName:属性名称
* propertyValue:属性值
* property:属性列表
示例:
```java
//设置用户的邮箱地址为yonghu@163.com
AnalysysAgent.profileSet(mContext,"Email","yonghu@163.com");
......
// 设置用户的邮箱和微信
Map<String, Object> info = new HashMap<>();
info.put("Email", "yonghu@163.com");
info.put("WeChatID", "weixinhao");
AnalysysAgent.profileSet(mContext, info);
```
## 验证数据
开启Debug模式后,用户可以通过AndroidStudio或其他开发工具的控制台中查看tag为`[analysys]`的Log日志

* 检查上报地址是否正确
* 检查是否发送成功
* 检查事件名称及内容与预期相同
- 产品简介
- 快速上手
- Step 1 安装部署
- Step 2 激活系统创建项目
- Step 3 开启您的分析旅程
- 1. 集成 SDK
- 2. 可视化埋点
- 3. 创建分析模型
- 附:埋点方案设计
- 附:数据分析思路
- 产品更新日志
- V5.5 新增LTV分析功能等
- V5.3 UI 升级、分布分析重构、维度表动态更新、细节优化等
- V5.2 新增归因分析、消息中心、重构埋点方案、优化看数据体验……
- V5.1.0317 体验优化& Bug修复
- V5.1 升级可视化埋点、增强权限控制……
- Part I 产品功能说明
- 名词解释
- 指标说明
- 看板
- 5.3.3 看板 UI 重构
- 分析
- 事件分析
- 渠道分析
- 渠道相关名词解释
- 来源识别规则
- 搜索引擎
- 社交媒体
- 小程序场景值
- Session 分析
- Session 规则
- 实时分析
- 留存分析
- 转化漏斗
- 智能路径
- 归因分析
- 热图分析
- Web/H5 热图
- APP 热图
- 分布分析
- 间隔分析
- 属性分析
- LTV 分析
- 多主体分析
- 自定义查询
- 用户
- 用户分群
- 用户探查
- 用户标签
- 标签体系应用概览
- 标签体系
- 标签生命周期管理
- 标签加工
- 如何自定义SQL创建标签
- 单用户档案
- 运营
- 广告跟踪
- 微信小程序渠道追踪
- 预置广告媒介和渠道
- App 推广监测(Beta)
- 电子邮件
- 短信
- 消息通知
- 项目管理
- 项目概览
- 项目角色管理
- 项目成员管理
- 数据接入管理
- 埋点方案
- 可视化埋点
- 集成SDK接入数据
- 数据验证
- 用户数据导入
- 微信小程序全埋点事件定义
- 元数据管理
- 元事件
- 虚拟事件
- 事件属性
- 用户属性
- Session 管理
- 页面组管理
- 维度表
- 服务集成配置
- 监控告警
- 智能监控
- 自定义监控
- 平台管理
- 企业概览
- 项目管理
- 成员管理
- 安全设置
- 企业设置
- 日志管理
- 帐号设置
- Part II 技术文档
- 技术接入准备工作
- 部署环境检测工具
- 数据模型
- 数据格式
- 预置事件和属性
- App预置事件/属性
- JS 预置事件/属性
- 如何准确识别用户
- 如何设计埋点方案
- 分平台上报数据 vs 跨平台打通
- SDK 指南
- Android SDK
- 快速集成
- 全埋点模块
- 消息推送模块
- Android Hybrid模式
- SDK Gradle集成方式
- 多渠道打包
- 易观小工具
- 合规相关
- iOS SDK
- 快速集成
- 全埋点介绍
- iOS Hybrid模式
- 消息推送模块
- JS SDK
- 快速集成
- JS SDK基础版
- JS SDK插件
- uni-app SDK
- 快速集成
- 打包原生APP
- 开启移动端全埋点
- uni-app SDK标准版
- 微信小程序 SDK
- 快速集成
- 微信小程序标准版
- 微信小程序插件版
- 微信小程序通用框架版
- 支付宝小程序 SDK
- 支付宝小程序标准版
- 支付宝小程序通用框架版
- 字节跳动小程序 SDK
- 字节跳动小程序标准版
- 字节跳动小程序通用框架版
- 百度小程序 SDK
- 百度小程序标准版
- 百度小程序通用框架版
- 钉钉小程序 SDK
- 钉钉小程序标准版
- 钉钉小程序通用框架版
- QQ小程序 SDK
- QQ小程序标准版
- QQ小程序通用框架版
- 快应用 SDK
- 华为WeCode小程序
- WeCode SDK 标准版
- WeCode SDK插件
- 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
- identify与alias的区别
- 爬虫数据如何识别?
- 页面停留如何获取时间?
- 如果获取SDK及更新日志
- 代码埋点和无埋点有什么区别
- Web页面中发现丢失某一个事件
- 自研 SDK 注意事项
- 页面时长统计功能
- 飞书小程序 SDK
- 飞书小程序标准版
- 飞书小程序通用框架版
- Unreal Engine SDK
- 数据验证
- 客户端埋点验证
- Debug 数据验证
- 数据入库验证
- 数据导入
- 接口导入
- JAVA工具包
- 标准json文件导入
- csv格式导入
- 数据导入FAQ
- 数据导出
- JAVA工具包
- 事件数据导出
- 用户数据导出
- 直接从Kafka中消费数据
- 使用程序访问数据库
- 脚本工具
- API
- 分析API
- 事件分析
- 留存分析
- 自定义查询
- 转化漏斗
- 属性分析
- Session分析
- 渠道分析
- 分布分析
- 用户API
- 分群查询
- 用户档案
- 分群管理
- 管理API
- 权限管理
- 元数据管理
- 埋点方案管理
- 维度表管理
- 运营API
- 广告跟踪
- APP推广监测
- 平台管理API
- 项目管理
- 成员管理
- 第三方登录
- OAuth2.0登录
- LDAP登录
- GDPR 合规
- Part III 常见问题
- License 许可
- 产品试用及采购
- 参与贡献