首页 帮助中心 基调听云Browser 设置用户ID

设置用户ID

通过localStorage接口方式设置用户ID

探针代码执行前, 在localStorage中设置key TY_DISTINCT_ID,探针将使用设置的ID作为用户ID上传。

localStorage.setItem('TY_DISTINCT_ID', 'user1');

代码示例:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <script>
        // 设置用户ID    
        localStorage.setItem('TY_DISTINCT_ID', 'user1');
    </script>
    <!--引入探针-->
    <script src="./tingyun_rum.js"></script>
</head>
<body>
</body>
</html>

Cookie方式自定义用户ID

可以在探针配置Cookie名称,探针会尝试获取此Cookie值作为did记录。

探针配置示例:

{
    did_cookie: 'login_user'
}

上述配置加入后,探针启动时会尝试获取名称为login_user的cookie值作为用户ID上传。

通过探针接口方式设置用户ID

示例:

TINGYUN.setDid('username1');

此方式作为需要先加载探针,再调用接口设置,设置的值作为用户ID上传。如果Cookie在探针启动时不存在,可以使用接口调用方式。

说明

  • 三种方式优先级顺序: 探针接口方式 > Cookie取值 > localStorage设置方式
  • Cookie取值探针接口方式设置在1.8.3探针中新增,其中探针接口方式 的设置方式只在当前页面生效,需要晚于探针加载调用。