1. 用户关联介绍

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

2. API 介绍

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

2.1. 用户登录

当用户注册成功或者进行登录时，需要调用 SDK 的 login() 接口。

[[SensorsAnalyticsSDK sharedInstance] login:@"<#登录 ID#>"];

SensorsAnalyticsSDK.sharedInstance()?.login("<#登录 ID#>")

2.2. 多用户 ID 关联

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

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

[[SensorsAnalyticsSDK sharedInstance] bind:@"$identity_mobile" value:@"187****8991"];

2.3. 多用户 ID 取消关联

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

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

[[SensorsAnalyticsSDK sharedInstance] unbind:@"$identity_mobile" value:@"187****8991"];

2.4. 重置匿名 ID

用于重置匿名 iD，可以生成一个新的匿名 ID，也可以传入指定的匿名 ID。

注意：必须在匿名状态下才能使用（也就是 logout 后，或者没有 login 前），否则调用无效。

这个方法和 identify 的区别在于这个除了会修改 IDM 2.0 中的 distinct_id 外，还会修改 IDM 3.0 identities 里的 $identity_idfv 或者 $identity_ios_uuid 的值。

// 重置匿名 ID 
[[SensorsAnalyticsSDK sharedInstance] resetAnonymousIdentity:nil];

// 修改为指定的匿名 ID
[[SensorsAnalyticsSDK sharedInstance] resetAnonymousIdentity:@"id-xxxxxxx-xxxxx"];

2.5. 获取用户 ID

• Objective-C 全域用户关联
• Swift 全域用户关联

SDK 版本需要 >=4.3.0

获取全域用户关联的 ID 

// 获取事件的 ID 
NSDictionary *SDKProperties = [[SensorsAnalyticsSDK sharedInstance] identities];

CODE

SDK 版本需要 >=4.3.0

获取全域用户关联的 ID 

// 获取事件的 ID 
NSDictionary *SDKProperties = SensorsAnalyticsSDK.sharedInstance?.identities;

CODE