1. 全域用户关联介绍

2. API 介绍

本小节中只介绍全域用户关联的 API 功能，其他埋点接口参照基础 API 功能介绍。

ID-Mapping 3.0 的最低支持版本

Android SDK v6.3.0
iOS SDK v4.3.0

2.1. 用户登录

当用户注册成功或登录成功时，需要调用 SDK 的 login() 方法。

var sensorsApiCloudSdk = api.require('sensorsAnalyticsAPICloudSDK');
sensorsApiCloudSdk.login({
    loginId: '123456',
    properties:{
        age:18,
        name:'sensors'
    }
});

JAVA

2.2. 多用户 ID 关联

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

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

var sensorsApiCloudSdk = api.require('sensorsAnalyticsAPICloudSDK');
sensorsApiCloudSdk.bind({key:'mobile',value:'133XXXXXXXX');

JAVA

2.3. 多用户 ID 取消关联

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

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

var sensorsApiCloudSdk = api.require('sensorsAnalyticsAPICloudSDK');
sensorsApiCloudSdk.unbind({key:'mobile',value:'133XXXXXXXX');

JAVA

2.4. 获取用户 ID

获取全域用户的 ID。

var sensorsApiCloudSdk = api.require('sensorsAnalyticsAPICloudSDK');
var identities = sensorsApiCloudSdk.getIdentities();

JAVA