# WeCode SDK 标准版
华为WeCode小程序 SDK 标准版
华为WeCode小程序 SDK集成前请先下载SDK
>[info]SDK Releases包下载：\
Github地址(推荐)：[https://github.com/analysys/ans-wecode-sdk/releases](https://github.com/analysys/ans-wecode-sdk/releases)\
Gitee地址：[https://gitee.com/Analysys/ans-wecode-sdk/releases](https://gitee.com/Analysys/ans-wecode-sdk/releases)\
Releases中含有更新说明请您阅读，接口使用请参考本文档。
| js文件 | 功能描述 | 是否必须 |
| :----------------------------------------------: | -------- | ---- |
| AnalysysAgent_WeCode_SDK.es6.min.js | 基础模块SDK | 二选一 |
| AnalysysAgent_WeCode_SDK.amd.min.js | 基础模块SDK | 二选一 |
| AnalysysAgent_WeCode_encryption.es6.min.js | 加密模块 | 非必须 |
| AnalysysAgent_WeCode_encryption.amd.min.js | 加密模块 | 非必须 |
| AnalysysAgent_WeCode_PageViewStayTime.es6.min.js | 页面访问时长模块 | 非必须 |
| AnalysysAgent_WeCode_PageViewStayTime.amd.min.js | 页面访问时长模块 | 非必须 |
| AnalysysAgent_WeCode_ExposurePoint.es6.min.js | 曝光点采集模块 | 非必须 |
| AnalysysAgent_WeCode_ExposurePoint.amd.min.js | 曝光点采集模块 | 非必须 |
### 快速集成
如果您是第一次使用易观方舟产品，可以通过阅读本文快速了解此产品
#### 1. 集成SDK
将WeCode SDK引入到小程序项目中。
#### 2. 设置初始化接口
通过初始化代码的配置参数配置您的 AppKey。
#### 3. 设置上传地址
通过初始化代码的配置参数 uploadURL 设置您上传数据的地址。
#### 4. 设置需要采集的页面或事件
通过手动埋点，设置需要采集的页面或事件。
#### 5. 打开Debug模式查看日志
通过设置 Ddebug 模式，开/关 log 查看日志。
通过以上5步您即可验证 SDK 是否已经集成成功。更多接口说明请您查看 API 文档。
## 集成配置
### 集成 SDK
>[info]ES6方式集成
从 npm 获取 SDK ， npm install ans-wecode-sdk。也可以自行下载SDK。
```javascript
// 从 npm 获取 sdk
import AnalysysAgent from 'ans-wecode-sdk'
//自行下载SDK
//import AnalysysAgent from '/*设置为WeCode SDK ES6模块实际存放地址*/'
AnalysysAgent.init({
appkey: '/*设置为实际APPKEY*/',//APPKEY
uploadURL: '/*设置为实际地址*/'
})
```
>[info]AMD 规范集成（以 RequireJS 为例）
自行下载SDK。获取AnalysysAgent_WeCode_SDK.amd.min.js，假设该文件放到与 require.js 同一目录中
```javascript
requirejs(["./AnalysysAgent_WeCode_SDK.amd.min.js"], function(AnalysysAgent) {
AnalysysAgent.init({
appkey: '/*设置为实际APPKEY*/',//APPKEY
uploadURL: '/*设置为实际地址*/',//上传数据的地址
})
});
```
>[info]请不要修改以上初始化代码中的代码逻辑，可能会造成SDK无法正常运行。
### 配置参数
* _`appkey`_(必须) 项目数据的唯一标识，在产品当中_ 数据接入管理 _模块获取的 AppKey
* _`debugMode`_ 设置调试模式
* 0 - 关闭调试模式(默认)；
* 1 - 开启调试模式，数据不入库；
* 2 - 开启调试模式，数据入库
* _`uploadURL`_(必须) 设置上传数据接口，在 _数据接入管理-集成SDK接入数据 _模块获取
* _`name`_ 设置 WeCode SDK 全局对象别名
* _`auto`_ 设置自动采集页面打开事件
* `false` - 关闭自动采集；
* `true` - 开启自动采集(默认)
* _`autoTrack`_ 设置是否启用全埋点功能
* `false` - 不启用全埋点功能(默认)
* `true` - 启用全埋点功能
* _`hash`_ 设置检测 url hash 变化：
* `false` - 关闭监测url hash变化；
* `true` - 开启监测url hash变化(默认)
* _`autoProfile`_ 设置是否追踪新用户的首次属性
* `false` - 不追踪新用户的首次属性；
* `true` - 追踪新用户的首次属性(默认)
* _`encryptType`_ 设置是否对上传数据加密
* 0 - 对上传数据不加密(默认)；
* 1 - 对上传数据进行AES 128位ECB加密；
* 2 对上传数据进行AES 128位CBC加密
* `pageProperty` 设置自动采集时页面自定义属性
* 类型：JSON
* `pageViewBlackList` 设置页面统计黑名单
* 类型：String/内部元素为String或Function的Array/Function
* `heatMapBlackList` 设置热图统计黑名单
* 类型：String/内部元素为String或Function的Array/Function
* `autoClickBlackList` 设置全埋点统计黑名单；
* 类型：String/内部元素为String或Function的Array/Function
* _`sendType`_ 设置上传日志方式
* `img`- 使用image标签的图片链接地址上传日志(默认)；
* `post`-使用Ajax中的post请求上传日志
* _`cross_subdomain` 设置在二级域名下存储cookie_
* _`false` - 在自身域名下存储cookie；_
* _`true` - 在二级域名下存储cookie(默认)_
* `sendDataTimeout`设置上报日志超时时间
* 默认：10000，单位：毫秒
* 类型：Number
* `trackList` 设置除默认可输出元素外的可触控元素列表
* 类型：Array/String（同元素选择器，例如：div、div.className、div#id等）/ Function（返回值为Boolean）
* `user_click_property` 设置全部或某个全埋点元素自定义属性
* 类型：JSON(属性值为返回该元素自定义属性值的Function)/Function（返回值为该元素的自定义属性的JSON）
#### appkey
appkey 为在网站获取的 AppKey。
* value 在网站获取的 AppKey。类型:String。取值长度 1 - 255 字符。
```javascript
// 设置key，77a52s552c892bn442v721为样例数据，请根据实际情况替换相应内容
{
appkey:"77a52s552c892bn442v721"
}
```
#### debugMode
debugMode debug 模式，默认关闭状态。发布版本时 debugMode 模式设置为`0`
* 0 关闭调试模式(默认)。类型：Number。
* 1 开启调试模式，数据不入库。类型：Number。
* 2 开启调试模式，数据入库。类型：Number。
```javascript
//开启调试模式且数据不入库
{
debugMode:1
}
//开启调试模式且数据入库
{
debugMode:2
}
//关闭调试模式
{
debugMode:0 //或删除debugMode参数
}
```
或删除 debugMode 参数。
#### uploadURL
uploadURL 为自定义上传地址，参数设置后，所有事件信息将上传到该地址。
* value 类型：String。数据上传地址，格式为 scheme://host + :port(不包含/后的内容)。scheme 必须以 http:// 或 https:// 开头，host 只支持域名和 IP，取值长度 1 - 255字符，port 端口号必须携带
```javascript
//设置自定义上传地址为 scheme://host + :port
{
uploadURL:"/*设置为实际地址*/"
}
```
#### name
name 为设置 WeCode SDK全局对象的别名。可根据自身所需进行更改。
* value 类型：String。取值长度 1 - 255字符。
```javascript
//设置WeCode全局对象的别名为analysys，之后可在全局使用analysys来调用WeCode SDK所有的API方法。
{
name:"analysys"
}
```
#### auto
auto 为设置打开/关闭自动采集页面的参数。可根据自身需要进行更改。
* true 开启自动采集页面打开事件(默认)。类型：Boolean。
* false 关闭自动采集页面打开事件。类型：Boolean。
```javascript
//关闭自动采集页面打开事件，关闭后可使用WeCode SDK的API中的手动发送页面打开数据方法，来发送页面打开状态的数据。
{
auto:false
}
//开启自动采集页面打开事件。
{
appkey:"77a52s552c892bn442v721",
auto:true//或删除auto参数。
}
```
#### hash
针对单页面网站的 $pageview 的采集，在将 hash 设置 true 后，可以自动监测 URL 的变化，改变时自动上报 $pageview 事件。
* true，默认，类型：Boolean。
* false，默认值，类型：Boolean。
```javascript
//关闭自动采集监测 URL 变化，关闭后可使用WeCode SDK的手动上报页面浏览的方法上报 $pageview 事件。
{
hash:false
}
//开启自动采集监测 URL 变化。
{
hash:true
}
```
#### autoProfile
autoProfile 为设置是否追踪新用户的首次属性。可根据自身需要进行更改。
* true 追踪新用户的首次属性(默认)。类型：Boolean。
* false 不追踪新用户的首次属性。类型：Boolean。
```javascript
//不追踪新用户的首次属性，新用户首次打开网站不上传新用户的首次属性。
{
autoProfile:false
}
//追踪新用户的首次属性，新用户首次打开网站上传新用户的首次属性。
{
autoProfile:true//或删除autoProfile参数。
}
```
#### autoTrack
autoTrack 为设置是否启用全埋点功能。可根据自身需要进行更改。true 启用全埋点功能。类型：Boolean。
* true 启用全埋点功能。类型：Boolean。
* false 不启用全埋点功能(默认)。类型：Boolean。
```
//不启用全埋点功能。
{
autoTrack:false//或删除autoTrack参数。
}
//启用全埋点功能。
{
autoTrack:true
}
```
#### encryptType
encryptType 为设置数据上传时的加密方式,目前只支持 AES 加密，如不设置此参数，数据上传不加密。。可根据自身需要进行更改。
* 0 对上传数据不加密(默认)。类型：Number。
* 1 对上传数据 AES 加密。类型：Number。
* 2 对上传数据进行AES 128位CBC加密。类型：Number。
```javascript
//对上传数据不加密。
{
encryptType:0//或删除encryptType参数。
}
//对上传数据AES加密。
{
encryptType:1
}
//对上传数据AES加密。
{
encryptType:2
}
```
#### pageProperty
pageProperty 为设置自动采集时页面自定义属性。可根据自身需要进行增加。
* 类型：JSON。
```javascript
//设置自动采集时页面自定义属性
{
pageProperty:{
title:'首页'
}
}
```
#### pageViewBlackList
pageViewBlackList 为设置页面统计黑名单。根据设置不在采集设置中的页面内所有的页面事件，包含用户手动调用pageView API。可根据自身需要进行增加。
* 类型：String/内部元素为String或Function的Array/Function。
```javascript
//设置页面地址`url`为https://xxx.xx.com不进行页面事件采集
{
pageViewBlackList:'https://xxx.xx.com'
}
//设置页面地址`url`为https://xxx.xx.com或https://xxx.xx.com/x不进行页面事件采集
{
pageViewBlackList:['https://xxx.xx.com','https://xxx.xx.com/x']
}
//设置页面地址`url`内包含'index'的页面不进行页面事件采集
{
pageViewBlackList: function() {
var url = window.location.href
if(url.indexOf('index') > -1){
return true
}
return false
}
}
//设置页面地址`url`内包含'index'或页面地址`url`为https://xxx.xx.com的页面不进行页面事件采集
{
pageViewBlackList: [
'https://xxx.xx.com',
function() {
var url = window.location.href
if(url.indexOf('index') > -1){
return true
}
return false
}]
}
```
#### autoClickBlackList
autoClickBlackList 为设置全埋点统计黑名单。根据设置不在采集设置中的页面内所有的全埋点事件。可根据自身需要进行增加。
* 类型：String/内部元素为String或Function的Array/Function。
```javascript
//设置页面地址`url`为https://xxx.xx.com不进行全埋点事件采集
{
autoClickBlackList:'https://xxx.xx.com'
}
//设置页面地址`url`为https://xxx.xx.com或https://xxx.xx.com/x不进行全埋点事件采集
{
autoClickBlackList:['https://xxx.xx.com','https://xxx.xx.com/x']
}
//设置页面地址`url`内包含'index'的页面不进行全埋点事件采集
{
autoClickBlackList: function() {
var url = window.location.href
if(url.indexOf('index') > -1){
return true
}
return false
}
}
//设置页面地址`url`内包含'index'或页面地址`url`为https://xxx.xx.com的页面不进行全埋点事件采集
{
autoClickBlackList: [
'https://xxx.xx.com',
function() {
var url = window.location.href
if(url.indexOf('index') > -1){
return true
}
return false
}]
}
```
#### sendType
sendType 为设置日志上传方式。可根据自身需要进行增加。
* 类型：String。
```javascript
//设置为使用image标签的图片链接地址上传日志(默认)。
{
sendType:'img'//或删除sendType参数。
}
//使用Ajax中的post请求上传日志。
{
sendType:'post'
}
```
>[info]img类型支持需要方舟4.2.2版本支持，如您使用的方舟版本低于4.2.2版本请更换发送方式
#### cross_subdomain
cross_subdomain 为_设置在二级域名下存储cookie：false - 在自身域名下存储cookie；true - 在二级域名下存储cookie(默认)。例如：一个用户在_同一浏览器中访问_a.analysys.cn与b.analysys.cn两个域，_cross_subdomain为true时，该用户为一个用户。cross_subdomain为false时，该用户为两个用户。
* 类型：Boolean
```javascript
//在自身域名下存储cookie。
{
cross_subdomain:false//或删除autoWebstay参数。
}
//在二级域名下存储cookie。
{
cross_subdomain:true//或删除cross_subdomain参数。
}
```
#### sendDataTimeout
sendDataTimeout 设置上报日志超时时间 。默认：`10000`。单位：毫秒。类型：`Number` 可根据自身需要进行增加。
* 类型：`Number`
```javascript
//设置为设置上报日志超时时间为500毫秒
{
sendDataTimeout:500
}
```
#### trackList
trackList 设置除默认可输出元素外的可触控元素列表。
* 类型：`Array`/`String（同元素选择器，例如：div、div.className、div#id等）`/ `Function（返回值为Boolean）`
```javascript
//设置已可获取id为banner的元素为可触控元素
{
trackList:[document.getElementById('banner')]
}
//设置元素选择器为#banner的元素为可触控元素
{
trackList:'#banner'
}
//设置当前点击元素的id为banner为可触控元素
{
trackList:function(ele){
if(ele.id === 'banner'){
return true
}
return false
}
}
```
#### user_click_property
user_click_property 设置全部或某个全埋点元素自定义属性。
* 类型：`JSON(属性值为返回该元素自定义属性值的Function)`/`Function（返回值为该元素的自定义属性的JSON）`
```javascript
//设置所有全埋点元素的自定义属性为{'isClickEle':true}
{
user_click_property:{'isClickEle':true}
}
//设置id为banner全埋点元素的自定义属性为{'isClickEle':true}
// 其他全埋点元素自定义属性为{'isClickEle':false}
{
user_click_property:{'isClickEle':function(ele){
if(ele.id === 'banner'){
return true
}
return false
}
}
}
//设置id为banner全埋点元素的自定义属性为{'isClickEle':true}
// 其他全埋点元素不设置自定义属性
{
user_click_property:function(ele){
if(ele.id === 'banner'){
return {'isClickEle':true}
}
return {}
}
}
```
## 基础模块介绍
### 统计页面接口介绍
页面跟踪，SDK 默认设置跟踪所有页面，支持自定义页面信息。接口如下：
```javascript
AnalysysAgent.pageView(pageName);
AnalysysAgent.pageView(pageName, callback);
AnalysysAgent.pageView(pageName, properties);
AnalysysAgent.pageView(pageName, properties, callback);
```
* pageName：页面标识，为字符串，取值长度 1 - 255字符。
* properties：页面信息，为K-V键值对，最多包含100条，且`key`是以字母开头的字符串，**必须由 **字母、数字、下划线组成，字母不区分大小写，**不支持 **乱码、中文、空格等，长度范围1-99字符。value支持类型：String/Number/Boolean/JSON/内部元素为String的Array，若为字符串，长度范围1-255字符。
* callback：数据发送完毕后的回调函数，支持类型：Function
示例：
```javascript
// 正在开展某个活动，需要统计活动页面；
AnalysysAgent.pageView("活动页");
......
// 访问手机活动页面，活动页面内容为优惠出售iPhone手机，手机价格为5000元
var properties ={
"commodityName": "iPhone",
"commodityPrice": 8000,
"commodityType": function(){
return 'phone';
}
}
AnalysysAgent.pageView("商品页", properties);
......
// 访问手机活动页面，活动页面内容为优惠出售iPhone手机，手机价格为5000元，并返回数据发送完毕状态
var properties ={
"commodityName": "iPhone",
"commodityPrice": 8000,
"commodityType": function(){
return 'phone';
}
}
var callback = function(){
console.log('数据发送完毕')
}
AnalysysAgent.pageView("商品页", properties);
```
### 统计事件接口
用户行为追踪，可以设置自定义属性。接口如下：
```javascript
AnalysysAgent.track(eventName);
AnalysysAgent.track(eventName, eventInfo);
AnalysysAgent.track(eventName, eventInfo, callback);
```
* eventName：自定义事件ID标识，以字母开头的字符串，**必须由**字母、数字、下划线组成，`$ `开头为预置事件/属性，**不支持**乱码、中文、空格等，长度范围1-99字符。
* properties：自定义属性，K-V键值对，用于对事件的描述。最多包含100条，且`key`是以字母开头的字符串，**必须由 **字母、数字、下划线组成，字母不区分大小写，**不支持 **乱码、中文、空格等，长度范围1-99字符。value支持类型：String/Number/Boolean/JSON/内部元素为String的Array，若为字符串，长度范围1-255字符。
* callback：数据发送完毕后的回调函数，支持类型：Function
示例：
```javascript
var callback = function() {
console.log('数据发送完毕')
}
// 添加事件
AnalysysAgent.track("back");
......
// 添加事件，并返回数据发送完毕
AnalysysAgent.track("back", callback);
......
// 用户购买手机
var eventInfo = {
"type":"Phone",
"name":"Apple iPhone8",
"money":4000,
"count":1,
"userID": function(){
return '123456'
}
}
AnalysysAgent.track("buy", eventInfo);
......
// 用户购买手机，并返回数据发送完毕
var eventInfo = {
"type":"Phone",
"name":"Apple iPhone8",
"money":4000,
"count":1,
"userID": function(){
return '123456'
}
}
AnalysysAgent.track("buy", eventInfo, callback);
```
### 匿名ID与用户关联
用户关联的主要作用是打通用户登录前后的行为，以及多屏登录后的行为。做过用户关联的用户在登录前后的行为在方舟系统里面会被认为是一个用户。方舟系统目前支持 一台设备只能绑定一个用户 ID，一个用户 ID 只能绑定一台设备。设备和用户 ID 绑定后，就无法再和其他用户或者设备进行绑定。例如一个用户的设备 ID 是 ABC 用户的登录 ID 是 123，绑定成功后会对应同一个 ID，这样在统计或者分析时会被认为是一个用户。**在用户注册成功或者登录成功后客户端需要调用 alias 接口**，建议埋点时观看下 [方舟 SDK 接入视频](https://ark.analysys.cn/video-list.html) 接口描述如下：
用户 id 关联接口。将需要绑定的用户ID 和匿名ID进行关联，计算时会认为是一个用户的行为。接口如下：
```javascript
AnalysysAgent.alias(aliasId);
AnalysysAgent.alias(aliasId, callback);
```
* aliasId：需要关联的用户ID。 取值长度 1 - 255字符,支持类型：String
* callback：数据发送完毕后的回调函数，支持类型：Function
示例：
```javascript
// 登陆账号时调用，只设置当前登陆账号即可和之前行为打通
AnalysysAgent.alias("sanbo");
// 登陆账号时调用，只设置当前登陆账号即可和之前行为打通, 并返回数据发送完毕
var callback = function() {
console.log('数据发送完毕')
}
AnalysysAgent.alias("sanbo", callback);
```
### 用户属性设置
> 用户属性是一个标准的 K-V 结构，K 和 V 均有相应的约束条件，如不符合则丢弃该次操作。
约束条件如下：
> **属性名称**
```
以字母开头的字符串，必须由字母、数字、下划线组成，字母不区分大小写，$ 开头为预置事件/属性，不支持乱码、中文、空格等，长度范围1-99字符。
```
> **属性值**
```
支持部分类型：String/Number/Boolean/JSON/内部元素为String的Array；若为字符串，则取值长度 1 - 255字符；若为 Array 或 JSON，则最多包含 100条，且 key 约束条件与属性名称一致，value 取值长度 1 - 255字符
```
#### 设置用户固有属性
设置用户的固有属性，只在首次设置时有效的属性。 如：应用的激活时间、首次登录时间等。如果被设置的用户属性已存在，则这条记录会被忽略而不会覆盖已有数据，如果属性不存在则会自动创建。接口如下：
```javascript
AnalysysAgent.profileSetOnce(propertyName, propertyValue);
AnalysysAgent.profileSetOnce(propertyName, propertyValue, callbck);
AnalysysAgent.profileSetOnce(property);
AnalysysAgent.profileSetOnce(property, callbck);
```
* propertyName ：属性名称，约束见[属性名称](../js/js.md#1.1)
* propertyValue ：属性值，约束见[属性值](../js/js.md#2.1)
* property ： 属性列表，约束见[属性名称](../js/js.md#1.1)，[属性值](../js/js.md#2.1)
* callback：数据发送完毕后的回调函数，支持类型：Function
示例：
```javascript
var callback = function(){
console.log('数据上报完毕')
}
// 设置用户激活时间
AnalysysAgent.profileSetOnce("activationTime", "2018-06-18 18:18:18.188");
// 设置用户激活时间，并返回数据发送完毕
AnalysysAgent.profileSetOnce("activationTime", "2018-06-18 18:18:18.188", callback);
// 设置用户性别和出生时间
var setOnceProfile = {
"birth": "2018-06-18 18:18:18.188",
"sex": "male",
"userID": function(){
return '123456'
}
}
AnalysysAgent.profileSetOnce(setOnceProfile);
// 设置用户性别和出生时间，并返回数据发送完毕
AnalysysAgent.profileSetOnce(setOnceProfile, callback);
```
#### 设置用户属性
给用户设置单个或多个属性，如果之前不存在，则新建，否则覆盖。接口如下：
```javascript
//设置单个用户属性
AnalysysAgent.profileSet(propertyName, propertyValue);
AnalysysAgent.profileSet(propertyName, propertyValue, callback);
//设置多个用户属性
AnalysysAgent.profileSet(property);
AnalysysAgent.profileSet(property, callback);
```
* propertyName ：属性名称，约束见[属性名称](../js/js.md#1.1)
* propertyValue ：属性值，约束见[属性值](../js/js.md#2.1)
* property ：属性列表，约束见[属性名称](../js/js.md#1.1)，[属性值](../js/js.md#2.1)
* callback ：数据发送完毕后的回调函数，支持类型：Function
示例：
```javascript
var callback = function(){
console.log('数据上报完毕')
}
//设置用户的邮箱地址为yonghu@163.com
AnalysysAgent.profileSet("Email", "yonghu@163.com");
//设置用户的邮箱地址为yonghu@163.com，并返回数据发送完毕
AnalysysAgent.profileSet("Email", "yonghu@163.com", callback);
......
// 设置用户的邮箱和微信
var property = {
"Email" : "yonghu@163.com",
"WeChatID" : "weixinhao",
"userID": function(){
return '123456'
}
}
AnalysysAgent.profileSet(property);
// 设置用户的邮箱和微信，并返回数据发送完毕
AnalysysAgent.profileSet(property, callback);
```
#### 设置用户属性相对变化值
设置用户属性的相对变化值(相对增加，减少)，只能对数值型属性进行操作，如果这个 Profile之前不存在，则初始值为0。接口如下：
```javascript
AnalysysAgent.profileIncrement(propertyName, propertyNumber)
AnalysysAgent.profileIncrement(propertyName, propertyNumber, callback)
AnalysysAgent.profileIncrement(property);
AnalysysAgent.profileIncrement(property, callback);
```
* propertyName：属性名称，约束见[属性名称](../js/js.md#1.1)
* propertyValue：属性值，约束见[属性值](../js/js.md#2.1)
* property：属性列表，约束见[属性名称](../js/js.md#1.1)，[属性值](../js/js.md#2.1)
* callback ：数据发送完毕后的回调函数，支持类型：Function
示例：
```javascript
var callback = function(){
console.log('数据上报完毕')
}
//用户增加一岁
AnalysysAgent.profileIncrement("age", 1);
//用户增加一岁，并返回数据发送完毕
AnalysysAgent.profileIncrement("age", 1, callback);
......
//用户玩某个游戏时间增加一年，游戏等级增加2,游戏金币加1000
var incrementProfile = {
"gameAge":1,
"gameRating":2,
"gageMoney": function(){
return 1000
}
}
AnalysysAgent.profileIncrement(incrementProfile);
//用户玩某个游戏时间增加一年，游戏等级增加2，并返回数据发送完毕
AnalysysAgent.profileIncrement(incrementProfile, callback);
```
#### 增加列表类型的属性
用户列表属性增加元素。接口如下：
```javascript
//增加多个属性
AnalysysAgent.profileAppend(propertyName, propertyValue);
AnalysysAgent.profileAppend(propertyName, propertyValue, callback);
```
* propertyName：属性名称，约束见[属性名称](../js/js.md#1.1)
* propertyValue：属性值，约束见[属性值](../js/js.md#2.1)
示例：
```javascript
//增加多个用户爱好
var list = ["PlayBasketball", "music"];
// var list = function(){
// return ["PlayBasketball", "music"];
// }
AnalysysAgent.profileAppend("hobby", list);
//增加多个用户爱好，并返回数据发送完毕
var callback = function(){
console.log('数据上报完毕')
}
AnalysysAgent.profileAppend("hobby", list, callback);
```
#### 删除设置的属性值
删除已设置的用户属性值。接口如下：
```javascript
// 删除当前用户单个属性值
AnalysysAgent.profileUnset(propertyName);
AnalysysAgent.profileUnset(propertyName, callback);
// 删除当前用户所有属性值
AnalysysAgent.profileDelete();
AnalysysAgent.profileDelete(callback);
```
* propertyName：属性名称，约束见[属性名称](../js/js.md#1.1)
* callback ：数据发送完毕后的回调函数，支持类型：Function
示例：
```javascript
var callback = function(){
console.log('数据上报完毕')
}
// 删除单个用户属性
AnalysysAgent.profileUnset( "age");
// 删除单个用户属性，并返回数据发送完毕
AnalysysAgent.profileUnset( "age", callback);
// 清除所有属性
AnalysysAgent.profileDelete();
// 清除所有属性，并返回数据发送完毕
AnalysysAgent.profileDelete(callback);
```
### 匿名ID设置
唯一匿名ID标识设置，接口如下：
```javascript
AnalysysAgent.identify(xwho);
AnalysysAgent.identify(xwho, callback);
```
* distinctId：自定义设备身份标识，取值长度 1 - 255字符,支持类型：String
* callback ：数据处理完毕后的回调函数，支持类型：Function
示例:
```javascript
var callback = function(){
console.log('数据处理完毕')
}
// 设置匿名ID为`fangke009901`,注意此方法需要在初始化中调用
AnalysysAgent.identify("fangke009901");
// 设置匿名ID为`fangke009901`,注意此方法需要在初始化中调用，并返回数据处理完毕
AnalysysAgent.identify("fangke009901", callback);
```
### 匿名ID获取
获取用户通过identify接口设置或自动生成的id，优先级如下： 用户设置的id > 代码自动生成的id
接口如下：
```javascript
AnalysysAgent.getDistinctId();
AnalysysAgent.getDistinctId(callback);
```
* callback ：数据处理完毕后的回调函数，支持类型：Function
示例:
```javascript
// 获取匿名id
var distinctId = AnalysysAgent.getDistinctId();
// 获取匿名id，并返回数据处理完毕
var callback = function(id){
console.log('数据处理完毕，匿名id:' + id)
}
AnalysysAgent.getDistinctId(callback);
```
### 通用属性
> 通用属性是每次上传事件信息都会带有的属性，通用属性是一个标准的 K-V 结构，K 和 V 均有相应的约束条件，如不符合则丢弃该次操作。
约束条件如下:
> **属性名称**
```
以字母开头的字符串，必须由字母、数字、下划线组成，字母不区分大小写，$ 开头为预置事件/属性，不支持乱码、中文、空格等，长度范围1-99字符。
```
> **属性值**
```
支持部分类型：String/Number/boolean/JSON/内部元素为String的Array；若为字符串，则取值长度 1 - 255字符；若为 Array 或 JSON,则最多包含 100条，且 key 约束条件与属性名称一致，value 取值长度 1 - 255字符
```
#### 注册通用属性
某一个体，在固定范围内，持续拥有的属性，每次数据上传都会携带。接口如下:
```javascript
AnalysysAgent.registerSuperProperty(superPropertyName, superPropertyValue );
AnalysysAgent.registerSuperProperty(superPropertyName, superPropertyValue, callback );
AnalysysAgent.registerSuperProperties(superProperty);
AnalysysAgent.registerSuperProperties(superProperty, callback);
```
* superPropertyName：属性名称，约束见[属性名称](../js/js.md#1)
* superPropertyValue：属性值，约束见[属性值](../js/js.md#2)
* superProperty：属性列表，约束见[属性名称](../js/js.md#1)，[属性值](../js/js.md#2)
* callback ：数据处理完毕后的回调函数，支持类型：Function
示例：
```javascript
var callback = function(id){
console.log('数据处理完毕，匿名id:' + id)
}
// 在某视频平台，购买一年会员，该年内只需设置一次即可
AnalysysAgent.registerSuperProperty("member","VIP");
......
// 在某视频平台，购买一年会员，该年内只需设置一次即可，并返回数据处理完毕
AnalysysAgent.registerSuperProperty("member", "VIP", callback);
......
// 小明在20岁的时候，购买了一年腾讯会员
var property = {
"platform":"TX",
"age":"20",
"member":"VIP",
"user":"xiaoming",
"userID": function(){
return '123456'
}
}
AnalysysAgent.registerSuperProperties(property);
......
// 小明在20岁的时候，购买了一年腾讯会员，并返回数据处理完毕
AnalysysAgent.registerSuperProperties(property, callback);
```
#### 删除通用属性
根据属性名称，删除已设置过的通用属性。接口如下：
```javascript
//删除单个通用属性
AnalysysAgent.unRegisterSuperProperty(superPropertyName);
AnalysysAgent.unRegisterSuperProperty(superPropertyName, callback);
//清除所有通用属性
AnalysysAgent.clearSuperProperties();
AnalysysAgent.clearSuperProperties(callback);
```
* superPropertyName：属性名称，约束见[属性名称](../js/js.md#1)
* callback ：数据处理完毕后的回调函数，支持类型：Function
示例：
```javascript
var callback = function(){
console.log('数据处理完毕')
}
// 删除已经设置的用户年龄属性
AnalysysAgent.unRegisterSuperProperty("age");
......
// 删除已经设置的用户年龄属性，并返回数据处理完毕
AnalysysAgent.unRegisterSuperProperty("age", callback);
......
// 清除所有已经设置的通用属性
AnalysysAgent.clearSuperProperties();
......
// 清除所有已经设置的通用属性，并返回数据处理完毕
AnalysysAgent.clearSuperProperties(callback);
```
#### 获取通用属性
查询获取通用属性。接口如下：
```javascript
// 获取单个通用属性
AnalysysAgent.getSuperProperty(superPropertyName);
AnalysysAgent.getSuperProperty(superPropertyName, callback);
// 获取所有的通用属性
AnalysysAgent.getSuperProperties();
AnalysysAgent.getSuperProperties(callback);
```
* superPropertyName：属性名称，约束见[属性名称](../js/js.md#1)
* callback ：数据处理完毕后的回调函数，支持类型：Function
示例：
```javascript
var callback = function(value){
console.log('数据处理完毕, 获取到的通用属性：', value)
}
// 查看已经设置的"member"的通用属性
AnalysysAgent.getSuperProperty("member");
......
// 查看已经设置的"member"的通用属性，并返回数据处理完毕
AnalysysAgent.getSuperProperty("member", callback);
......
// 查看所有已经设置的通用属性
AnalysysAgent.getSuperProperties();
......
// 查看所有已经设置的通用属性，并返回数据处理完毕
AnalysysAgent.getSuperProperties(callback);
```
### 获取预置属性
获取预置属性。接口如下：
```javascript
AnalysysAgent.getPresetProperties();
AnalysysAgent.getPresetProperties(callback);
```
* callback ：数据处理完毕后的回调函数，支持类型：Function
示例：获取预置属性
```javascript
var callback = function(value){
console.log('数据处理完毕, 获取到的预置属性：', value)
}
// 获取预置属性
var presetProperties = AnalysysAgent.getPresetProperties();
console.log('预置属性:', presetProperties)
// 获取预置属性，并返回数据处理完毕
AnalysysAgent.getPresetProperties(callback);
```
### 清除本地设置
清除本地现有的设置（包括 id 和通用属性）重新开始统计。接口如下：
```javascript
AnalysysAgent.reset();
AnalysysAgent.reset(callback);
```
* callback ：数据处理完毕后的回调函数，支持类型：Function
示例：清除本地现有的设置，包括id和通用属性
```javascript
// 删除设置的id和通用属性
AnalysysAgent.reset();
// 删除设置的id和通用属性，并返回数据处理完毕
var callback = function(){
console.log('数据处理完毕')
}
AnalysysAgent.reset(callback);
```
- 产品简介
- 快速上手
- 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 许可
- 产品试用及采购
- 参与贡献