1. 全域用户关联介绍

参照 SDK 产品功能部分的标识用户-全域用户关联。

• 本方案为全新的用户关联方案，如需使用，请联系客户成功。
• 小程序版本 >= mini 0.9.0

2. API 介绍

本小节中只介绍全域用户关联的 API 功能。

2.1.  用户登录

用户登录时调用，第一个参数从详细的预置 id key 列表中获取，第二个参数为对应的具体用户 ID。

调用接口后，对应的 key 和 value 会缓存在本地，后续采集的事件，均包含缓存的 ID 信息。

 sensors.loginWithKey(String loginIDKey, String loginId);

2.2. 多用户 ID 关联

用于多个用户 ID 关联时调用，第一个参数从详细的预置 id key 列表中获取，第二个参数为对应的关联用户 ID。

调用接口后，对应的 key 和 value 会缓存在本地，后续采集的事件，均包含缓存的 ID 信息。

sensors.bind("$identity_mobile","187****8991")

2.3. 多用户 ID 取消关联

用于多个用户 ID 取消关联时调用，第一个参数为取消关联的 key，第二个参数为对应的取消关联用户 ID。

调用接口后，会发送相关的解绑事件，同时会将本地缓存的 ID 信息中，对应的 key-value 清除（若存在）。

sensors.unbind("$identity_mobile","187****8991")

2.4. 多用户 ID 关联 Openid

多用户 ID 关联用户 Openid 时调用，参数为对应的关联用户 Openid。（SDK v0.9.0 版本以上支持）

调用接口后，对应的 key 和 value 会缓存在本地，后续采集的事件，均包含缓存的 ID 信息。

小程序 SDK 提供了 bindOpenid 接口将匿名 ID 设置为 OpenID。

sensors.bindOpenid('openid')

此接口只有满足下面两个条件才能支持！

• bindOpenid 仅在 ID-Mapping 3.0 支持，使用前请确认 SA 后端是否支持 ID-Mapping 3.0;
• bindOpenid 小程序 SDK 需要在 v0.9.0 版本上才支持！

2.5. 多用户 ID 取消关联 Openid

多用户 ID 取消关联用户 Openid 时调用，参数为对应的关联用户 Openid。（SDK v0.9.0 版本以上支持）

调用接口后，会发送相关的解绑事件，同时会将本地缓存的 ID 信息中，对应的 key-value 清除（若存在）。

sensors.unbindOpenid('openid')