基础 API 介绍(LayaAir)
|
收藏
1. 用户登录
当用户注册成功或者登录成功时,需要调用 login() 方法传入登录 ID:
sensors.login("登录 ID");
JS
对于自动登录的用户,可以在 SDK 初始化前,获取登录 ID 并调用 login() 方法。
2. 自定义匿名 ID
默认情况下,SDK 会生成匿名 ID 并可以保证该 ID 的唯一性,如果需要替换神策默认分配的匿名 ID ,可以在初始化 SDK 之后立即调用 identify(“用户自定义匿名 ID ”) 方法进行替换。
sensors.identify("登录 ID");
JS
3. 切换回匿名 ID
SDK 提供 logout 接口切换回调用 login 接口之前的匿名 ID。
sensors.logout();
JS
4. 清空本地缓存事件
可以通过 deleteAll() 方法,删除 App 本地存储的所有事件。
如果不是特殊要求,请不要调用此方法
sensors.deleteAll();
JS
deleteAll API 仅支持原生。
5. 立即发送缓存中的所有日志
如果追求数据采集的时效性,可以调用 flush 方法,强制将数据发送到神策分析,例如:
sensors.flush();
JS
flush API 仅支持原生。
6. 记录激活事件
可以调用 trackAppInstall 方法记录激活事件,多次调用此方法只会在第一次调用时触发激活事件:
var properties = {};
sensors.trackAppInstall(properties);
JS
trackAppInstall API 仅支持原生。
7. 代码埋点追踪事件
可通过 track() 方法追踪用户行为事件,并为事件添加自定义属性:
sensors.track(
'click', //事件名称
{
name: '点击' //事件属性
}
);
JS
8. 设置用户属性
sensors.setProfile({
email:'xxx@xx',
favoriteFruits: ['苹果', '油桃'],
subscribers: 7277
});
CODE
9. 保留初次属性
对于需要保证只有首次设置时有效的属性,如用户首次充值金额、首次设置的昵称等,可以使用 setOnceProfile 接口进行记录。与 setProfile 方法不同的是,如果被设置的用户属性已存在,则这条记录会被忽略而不会覆盖已有数据,如果属性不存在则会自动创建。
// 设置用户属性 subscribers 为 7277
sensors.setOnceProfile({
email:'xxx@xx',
favoriteFruits: ['苹果', '油桃'],
subscribers: 7277
});
// 再次设置用户属性 subscribers 为 7278 不生效,属性值仍然是 7277
sensors.setOnceProfile({
subscribers: 7278
JS
注:本文档内容为神策产品使用和技术细节说明文档,不包含适销类条款;具体企业采购产品和技术服务内容,以商业采购合同为准。