1. 全域用户关联介绍

ID-Mapping 即用户关联,ID-Mapping 3.0 实现全域用户关联,将同一用户的不同 ID 打通,以便贯通所有用户行为数据,方便系统地进行用户行为分析,支持用户标识之间的自由关联和解绑。

以下是一些各业务端用户 ID 的示例:

2. ID key 获取

查找合适的 id-key 使用,可以按照以下图示在神策分析平台查找合适的 id key 使用,比如要绑定手机号,使用 $identity_mobile

若找不到满足要求的合适 ID key,可以新建。

ID-Mapping 3.0 明确标识 ID 的语义,那就需要明确哪些 ID 参与用户关联,所以需要先将 ID key 确定,类似于强校验的先定义事件/属性。如果数据中带了没有定义的 ID ,整条事件会拒绝入库。

详细的预置 id key 列表 

3. API 说明


SDK 升级 3.0 之后不能回退到 2.0 的版本

3.1. Web

ID-Mapping 3.0 的各端最低支持版本

Web JS SDK v1.22.3 

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

Web JS SDK

sensors.loginWithKey('key','value')
JS

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

Web JS SDK

sensors.bind('$identity_mobile','187****8991')
CPP

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

Web JS SDK

sensors.unbind('$identity_mobile','187****8991')
JS


3.2. 小程序

ID-Mapping 3.0 的各端最低支持版本

微信小程序 SDK v1.17.6

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

小程序 SDK

sensors.loginWithKey('key','value')
JS

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

小程序

sensors.bind('$identity_mobile','187****8991')
CPP

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

小程序

sensors.unbind('$identity_mobile','187****8991')
JS

3.3. Android

ID-Mapping 3.0 的各端最低支持版本

Android SDK v6.3.0

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

android SDK

 SensorsDataAPI.sharedInstance().loginWithKey(String loginIDKey, String loginId);
JAVA

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

Android SDK

SensorsDataAPI.sharedInstance().bind("$identity_mobile","187****8991")
JAVA

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

Android SDK

SensorsDataAPI.sharedInstance().bind("$identity_mobile","187****8991")
JAVA

3.4. iOS

ID-Mapping 3.0 的各端最低支持版本

iOS SDK v4.3.0

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

iOS SDK

 [[SensorsAnalyticsSDK sharedInstance] loginWithKey:@"key" loginId:@"value"];
CPP

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

iOS SDK

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

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

iOS SDK

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


3.5. Java

ID-Mapping 3.0 的各端最低支持版本

Java SDK v3.4.3

用户登录时调用,第一个参数为用户登录 ID,第二个参数为对应的用户匿名 ID

Java SDK

SensorsAnalytics.trackSignUp('登录 ID', '匿名 ID');
JAVA

多用户 ID 关联时调用,参数 key 从详细的预置 id key 列表中获取,value 为对应的关联用户 ID

Java SDK

SensorsAnalyticsIdentity identity = new SensorsAnalyticsIdentity(SensorsAnalyticsIdentity.MOBILE, "187****8991");
SensorsAnalytics.bind(identity);
JAVA

多用户 ID 取消关联时调用,参数 key 为取消关联的 key,value 为对应的取消关联用户 ID

Java SDK

SensorsAnalyticsIdentity identity = new SensorsAnalyticsIdentity(SensorsAnalyticsIdentity.MOBILE, "187****8991");
SensorsAnalytics.unbind(identity);
JAVA