1. 用户关联介绍

简易用户关联标识用户时，用户 ID 取值有两类：一类是设备 ID（匿名 ID）、一类是登录 ID。无法满足复杂的多触点用户关联。详细介绍参照 SDK 产品功能部分的用户标识介绍。

2. API 介绍

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

2.1. 用户登录

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

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

CODE

为了准确记录登录用户的行为信息，建议在以下时机各调用一次用户登录方法：

· 用户在注册成功时
· 用户登录成功时
· 已登录用户每次启动 App 时

2.2. 获取用户 ID

神策中每个事件都会关联到一个 ID 上，用于标识该事件所对应的用户或设备信息，我们称之为 distinct_id，此值在未调用 SDK 中 login() 方法前，获取的是默认的 SDK 分配的匿名 ID（AndroidId ），调用 login() 方法后获取的是 login() 方法中传入的值。

您可以通过 getDistinctId() 方法获取 distinct_id：

var sensorsApiCloudSdk = api.require('sensorsAnalyticsAPICloudSDK');
var distinctId = sensorsApiCloudSdk.getDistinctId();

CODE

您也可以通过 getAnonymousId() 方法 获取神策分析 SDK 分配的匿名 ID：

var sensorsApiCloudSdk = api.require('sensorsAnalyticsAPICloudSDK');
var anonymousId = sensorsApiCloudSdk.getAnonymousId();

CODE

2.3. 自定义匿名 ID

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

var sensorsApiCloudSdk = api.require('sensorsAnalyticsAPICloudSDK');
var distinctId = sensorsApiCloudSdk.identify({anonymousId:"anonymousId"});

CODE