微信小程序通用框架版(2)

示例:

// 手动采集
Page({
    onShareAppMessage:function(){
        let toShareProperties = {
          title: '自定义转发标题',
          path: '/page/user?id=123'
        }
        let trackProperties = {
            custom:'weChat'
        }
        return AnalysysAgent.share(toShareProperties,trackProperties);
    }
})

与用户ID相关的界面. 将需要绑定的用户ID与匿名ID相关联，在计算时将被视为用户的行为. 界面如下:

AnalysysAgent.alias(aliasId);

示例:

// 登陆账号时调用，只设置当前登陆账号即可和之前行为打通
AnalysysAgent.alias("sanbo");

唯一的匿名ID标识设置，界面如下:

AnalysysAgent.identify(distinctId);

示例:

// 设置匿名ID为`fangke009901`,注意此方法需要在初始化之后优先调用
AnalysysAgent.identify("fangke009901");

通过识别界面获取用户设置或自动生成的ID，优先级如下: 用户设置ID>代码自动生成的ID

界面如下:

AnalysysAgent.getDistinctId();

示例:

// 获取匿名id
var distinctId = AnalysysAgent.getDistinctId();

用户属性是标准的K-V结构. K和V都有相应的约束. 如果没有，则该操作将被丢弃.

约束如下:

属性名称

以字母或`$`开头，包含字母、数字、下划线和`$`，字母不区分大小写，`$`开头为预置事件/属性，则取值长度 1 - 99 字符，不支持乱码和中文

属性值

支持部分类型：String/Number/Boolean/内部元素为String的Array；若为字符串，则取值长度 1 - 255字符；若为 Array 或 JSON，则最多包含 100条，且 key 约束条件与属性名称一致，value 取值长度 1 - 255字符

设置用户的固有属性微信通用版本，这些属性仅在第一次有效. 例如: 应用程序激活时间，首次登录时间等. 如果已设置用户属性，则该记录将被忽略，而不会覆盖现有数据. 如果该属性不存在，它将自动创建. 界面如下:

AnalysysAgent.profileSetOnce(propertyName, propertyValue);
​
AnalysysAgent.profileSetOnce(property);

示例:

// 设置用户激活时间
AnalysysAgent.profileSetOnce("activationTime",1521280551929);
​
// 设置用户性别和出生时间
var setOnceProfile = {
    "birth": 548798705000,
    "sex": "male"
}
AnalysysAgent.profileSetOnce(setOnceProfile);

为用户设置单个或多个属性. 如果以前不存在，则创建一个新的，否则覆盖. 界面如下:

//设置单个用户属性
AnalysysAgent.profileSet(propertyName, propertyValue);
//设置多个用户属性
AnalysysAgent.profileSet(property);

示例:

//设置用户的邮箱地址为yonghu@163.com
AnalysysAgent.profileSet("Email", "yonghu@163.com");
​
......
​
// 设置用户的邮箱和微信
var property = {
    "Email" : "yonghu@163.com",
    "WeChatID" : "weixinhao"
}
AnalysysAgent.profileSet(property);

设置用户属性的相对变化值（相对增加，减少），只能对数字属性进行操作. 如果此配置文件以前不存在，则初始值为0. 接口如下:

AnalysysAgent.profileIncrement(propertyName, propertyNumber)
​
AnalysysAgent.profileIncrement(property);

示例:

//用户增加一岁
AnalysysAgent.profileIncrement("age",1);
​
......
​
//用户玩某个游戏时间增加一年，游戏等级增加2
var incrementProfile = {
    "gameAge":1,
    "gameRating":2
}
AnalysysAgent.profileIncrement(incrementProfile);

将元素添加到用户列表属性. 界面如下:

//增加单个属性
AnalysysAgent.profileAppend(propertyName, propertyValue);
//增加多个属性
AnalysysAgent.profileAppend(propertyValue);
//增加多个属性
AnalysysAgent.profileAppend(propertyName, propertyValue);

示例:

// 增加用户爱好 music
AnalysysAgent.profileAppend("hobby", "Music");
​
// 增加多个用户属性
var map = {
    "hobby": "PlayBasketball",
    "sports": "Run"
};
AnalysysAgent.profileAppend(mContext, map);
​
//增加多个用户爱好
var list = ["PlayBasketball", "music"];
AnalysysAgent.profileAppend("hobby", list);

删除设置的用户属性值. 界面如下:

AnalysysAgent.profileUnset(propertyName);
AnalysysAgent.profileDelete();

示例:

//  删除当前用户单个属性值
AnalysysAgent.profileUnset( "age");
​
//  删除当前用户所有属性值
AnalysysAgent.profileDelete();

常规属性是随事件信息的每次上载一起携带的属性. 一般属性是标准的K-V结构. K和V都有相应的约束. 如果它们不匹配，则该操作将被丢弃.

约束如下:

属性名称

以字母或`$`开头，包含字母、数字、下划线和`$`，字母不区分大小写，`$`开头为预置事件/属性，则取值长度 1 - 99 字符，不支持乱码和中文

属性值

支持部分类型：String/Number/boolean/内部元素为String的Array；若为字符串，则取值长度 1 - 255字符；若为 Array 或 JSON,则最多包含 100条，且 key 约束条件与属性名称一致，value 取值长度 1 - 255字符

在固定范围内的某个人将继续拥有将随每次数据上传一起携带的属性. 界面如下:

AnalysysAgent.registerSuperProperty(superPropertyName , superPropertyValue );
​
AnalysysAgent.registerSuperProperties(superProperty);

示例:

// 在某视频平台，购买一年会员，该年内只需设置一次即可
AnalysysAgent.registerSuperProperty("member","VIP");
​
......
​
// 小明在20岁的时候，购买了一年腾讯会员
var property = {
    "platform":"TX",
    "age":"20",
    "member":"VIP",
    "user":"xiaoming"
}
AnalysysAgent.registerSuperProperties(property);

删除根据属性名称设置的公共属性. 界面如下:

//删除单个通用属性
AnalysysAgent.unRegisterSuperProperty(superPropertyName);
//清除所有通用属性
AnalysysAgent.clearSuperProperties();

示例:

// 删除已经设置的用户年龄属性
AnalysysAgent.unRegisterSuperProperty("age");
​
......
​
// 清除所有已经设置的通用属性
AnalysysAgent.clearSuperProperties();

查询以获取公共属性. 界面如下:

// 获取单个通用属性
AnalysysAgent.getSuperProperty(superPropertyName);
// 获取所有的通用属性
AnalysysAgent.getSuperProperties();

示例:

// 查看已经设置的"member"的通用属性
AnalysysAgent.getSuperProperty("member");
​
......
​
// 查看所有已经设置的通用属性
AnalysysAgent.getSuperProperties();

获取预设属性. 界面如下:

AnalysysAgent.getPresetProperties();

示例: 获取预设属性

// 获取预置属性
var presetProperties = AnalysysAgent.getPresetProperties();
​
console.log('预置属性:', presetProperties)

清除现有的本地设置（包括id和通用属性）并重新启动统计信息. 界面如下:

AnalysysAgent.reset();

示例: 清除现有的本地设置，包括id和通用属性

本文来自电脑杂谈，转载请注明本文网址：
http://www.pc-fly.com/a/sanxing/article-207489-2.html