1. 用户关联介绍

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

2. API 介绍

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

2.1. 用户登录

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

SensorsDataAPI.sharedInstance().login("登录 ID");

CODE

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

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

2.2. 获取用户 ID

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

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

//获取当前用户的 distinctId
String distinctId = SensorsDataAPI.sharedInstance().getDistinctId();

CODE

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

//获取当前用户的匿名 ID
String AnonymousId = SensorsDataAPI.sharedInstance().getAnonymousId();

CODE

2.3. 自定义匿名 ID

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

//设置自定义匿名 ID，在初始化 SDK 之后立即调用
SensorsDataAPI.sharedInstance().identify(“用户自定义匿名 ID ”);

CODE

对于延迟初始时，可以调用 SAConfigOptions.setAnonymousId(“用户自定义匿名 ID ”) 方法进行替换。