全域用户关联（HarmonyOS）

介绍

相较于简易用户关联模式只能使用 2 个业务 ID 参与用户关联，在此模式下，若您的实际业务与场景需要区别多个用户业务 ID 的实际语义，则可通过自定义业务 ID 并赋值上传参与用户关联。关于自定义业务 ID 的方式。

接口介绍

更改匿名 ID

调用时机

匿名 ID 默认由神策 SDK 自动采集或生成。绝大多数场景下，您无需主动更改匿名 ID 的值。

在鸿蒙系统下，匿名 ID 的取值默认为 UUID。若您需要自定义匿名 ID 的值，则可通过调用此接口来实现。

使用准备

使用该接口前，请确保您对于神策的接口与用户关联概念有深入的了解。

接口说明

identify(anonymousId: string): void,

参数名称	类型	是否必须	说明
anonymousId	String	是	匿名用户 ID，非空字符串，需要保证唯一性，不然会影响用户关联

使用示例：

sensors.identify('your_customized_anonymous_id');

调用此接口后，神策 SDK 将会修改事件上报数据中的 anonymous_id、$identity_anonymous_id 的值。

若在未调用 用户登录 接口前，即还未对 login_id 和 $identity_login_id 赋值时（一般称这类用户为匿名状态用户）。SDK 还会同步修改 distinct_id 的值。

例如，调用此接口前，一个处于匿名状态的用户触发了控件点击事件（$AppClick），则事件上报数据示例如下：

{
	"identities": {
		"$identity_harmony_uuid": "62d5af0c-f667-4d03-ae2f-837da2d5140e",   
        "$identity_anonymous_uuid": "62d5af0c-f667-4d03-ae2f-837da2d5140e" // SDK 默认采集的匿名 ID，默认为 UUID
    },
	"anonymous_id": "62d5af0c-f667-4d03-ae2f-837da2d5140e",   // 匿名 ID  
	"distinct_id": "62d5af0c-f667-4d03-ae2f-837da2d5140e",    // 神策用户标识 distinct_id，在匿名状态下是匿名 ID 
	"lib": {
		"$lib": "HarmonyOS",
		"$lib_method": "code",
		"$lib_version": "0.0.5",
		"$app_version": "0.0.3"
	},
	"properties": {
		"$timezone_offset": -480,
		"$screen_height": 2772,
		"$screen_width": 1344,
		"$app_id": "com.sensorsdata.sensorsdatasdk",
		"$app_name": "神策分析 SDK",
		"$app_version": "0.0.3",
		"$manufacturer": "HUAWEI",
		"$brand": "HUAWEI",
		"$model": "NOH-AN00",
		"$os_version": "2.1.7.1",
		"$network_type": "WiFi",
		"$screen_orientation": "PORTRAIT",
		"$screen_name": "Index",
		"$lib": "HarmonyOS",
		"$lib_method": "code",
		"$lib_version": "1.0.0",
		"$data_ingestion_source": [
			"HarmonyOS"
		],
		"$os": "HarmonyOS",
		"$is_first_day": true,
		"$is_first_time": false
	},
	"type": "track",
	"event": "$AppClick",
	"time": 1712825022595,
	"_track_id": 659542613
}

若此时，调用 更改匿名 ID(identify) 接口传入一个自定义的匿名 ID 值，例如 your_customized_anonymous_id，则后续发生的事件数据中的匿名 ID 都会更改，事件上报数据示例如下：

{
    "identities": {
        "$identity_anonymous_uuid": "your_customized_anonymous_id",   
        "$identity_harmony_uuid": "204ccdb8-7fc3-4aa0-8012-72fac26518d0" // SDK 默认采集的匿名 ID，一般为 UUID
    },
    "anonymous_id": "your_customized_anonymous_id",   // 匿名 ID  
    "distinct_id": "your_customized_anonymous_id",    // 神策用户标识 distinct_id，在匿名状态下就是匿名 ID 
    "lib": {
        "$lib": "HarmonyOS",
        "$lib_method": "code",
        "$lib_version": "0.0.5",
        "$app_version": "0.0.3"
    },
    "properties": {
        "$timezone_offset": -480,
        "$screen_height": 2772,
        "$screen_width": 1344,
        "$app_id": "com.sensorsdata.sensorsdatasdk",
        "$app_name": "神策分析 SDK",
        "$app_version": "0.0.3",
        "$manufacturer": "HUAWEI",
        "$brand": "HUAWEI",
        "$model": "NOH-AN00",
        "$os_version": "2.1.7.1",
        "$network_type": "WiFi",
        "$screen_orientation": "PORTRAIT",
        "$screen_name": "Index",
        "$lib": "HarmonyOS",
        "$lib_method": "code",
        "$lib_version": "1.0.0",
        "$data_ingestion_source": [
            "HarmonyOS"
        ],
        "$os": "HarmonyOS",
        "$is_first_day": true,
        "$is_first_time": false
    },
    "type": "track",
    "event": "$AppClick",
    "time": 1712825022595,
    "_track_id": 659542613
}

用户登录

调用时机

当用户进行登录时，您需主动调用此接口，将用户的注册信息（一般为用户在您业务系统中的唯一身份标识）传入。

使用准备

登录 ID 在神策的用户关联体系中非常重要，因此，强烈建议您在用户发生注册或登录时调用此接口来记录用户的登录 ID。

全域用户关联（HarmonyOS）

介绍

接口介绍

更改匿名 ID

调用时机

使用准备

接口说明

用户登录

调用时机

使用准备

接口说明

绑定业务 ID

调用时机

使用准备

接口说明

解绑业务 ID

调用时机

使用准备

接口说明

用户登出

调用时机

使用准备

接口说明

重新设置匿名 ID

调用时机

使用准备

接口说明

参数名称	类型	是否必须	说明
key	String	是	需要绑定的业务 ID 的 key，例如我们可以绑定一个 identify_email 的 key
value	String	是	需要绑定的业务 ID 的 value

参数名称	类型	是否必须	说明
key	String	是	需要解绑的业务 ID 的 key，比如之前绑定邮箱的 key 是 “identify_email”，现在需要解绑，需输入 “identify_email”
value	String	是	需要解绑的业务 ID 的 value