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