基础 API 介绍（LayaAir）

用户登录

当用户注册成功或者登录成功时，需要调用 login() 方法传入登录 ID：

sensors.login("登录 ID");

对于自动登录的用户，可以在 SDK 初始化前，获取登录 ID 并调用 login() 方法。

自定义匿名 ID

默认情况下，SDK 会生成匿名 ID 并可以保证该 ID 的唯一性，如果需要替换神策默认分配的匿名 ID ，可以在初始化 SDK 之后立即调用 identify(“用户自定义匿名 ID ”) 方法进行替换。

sensors.identify("登录 ID");

切换回匿名 ID

SDK 提供 logout 接口切换回调用 login 接口之前的匿名 ID。

sensors.logout();

清空本地缓存事件

可以通过 deleteAll() 方法，删除 App 本地存储的所有事件。

如果不是特殊要求，请不要调用此方法

sensors.deleteAll();

deleteAll API 仅支持原生。

立即发送缓存中的所有日志

如果追求数据采集的时效性，可以调用 flush 方法，强制将数据发送到神策分析，例如：

sensors.flush();

flush API 仅支持原生。

记录激活事件

可以调用 trackAppInstall 方法记录激活事件，多次调用此方法只会在第一次调用时触发激活事件：

var properties = {};
sensors.trackAppInstall(properties);

trackAppInstall API 仅支持原生。

代码埋点追踪事件

可通过 track() 方法追踪用户行为事件，并为事件添加自定义属性：

sensors.track(
	'click', //事件名称
	{
		name: '点击' //事件属性
	}
);

设置用户属性

sensors.setProfile({
	email:'xxx@xx',
	favoriteFruits: ['苹果', '油桃'],
	subscribers: 7277
});

保留初次属性

对于需要保证只有首次设置时有效的属性，如用户首次充值金额、首次设置的昵称等，可以使用 setOnceProfile 接口进行记录。与 setProfile 方法不同的是，如果被设置的用户属性已存在，则这条记录会被忽略而不会覆盖已有数据，如果属性不存在则会自动创建。

// 设置用户属性 subscribers 为 7277
sensors.setOnceProfile({
	email:'xxx@xx',
	favoriteFruits: ['苹果', '油桃'],
	subscribers: 7277
});

// 再次设置用户属性 subscribers 为 7278 不生效，属性值仍然是 7277
sensors.setOnceProfile({
    subscribers: 7278