TapCub 正式上线:统计、分析、客服一个平台免费用
术语表

User ID 是什么?

在分析里,User ID 是你的产品给每个登录用户分配的稳定标识,让这个人在所有设备上的访问都算作一个用户。

陈屿 审核人 卢卡斯·海斯 又称 用户 ID 最后更新 2026 年 11 月 1 日 术语表

一句话回答

User ID(用户 ID)是你的产品给登录用户分配、并传给分析工具的稳定、不重复的标识,让这个人在所有设备和会话里的行为都算作一个用户。它不是用户登录时输入的账号名。

分析里的 User ID 指什么

在登录页上问「User ID 是什么」,答案是你登录用的账号名。在产品分析和网站分析里,这个词的范围更窄:User ID(用户 ID)是你自己的系统给每个账号分配的标识,比如数据库里的 u_123,在用户登录后传给分析工具。之后这个人在哪台设备上产生的事件,都带着同一个用户标识。

分析工具自己没法知道一个人是谁。登录之前,它只看得到一个浏览器或一次 App 安装。User ID 就是你告诉它的方式。在这些 ID 里,只有它换了设备也不变,所以它是跨设备追踪的基础:没有它,同一个客户用笔记本、手机和平板,就会被算成三个用户。

User ID 和访客 ID、设备 ID、会话 ID 的区别

分析工具里同时存在好几种 ID。它们回答的问题不同,混在一起用,是两份报表对不上最常见的原因。

ID谁生成什么时候出现能保持多久用来数什么
访客 ID分析工具第一次浏览看工具,一天或更久独立访客
设备 ID统计 SDK,存在设备上允许采集后的第一个事件直到清除存储或重装 App设备数
User ID你的产品用户登录时和账号一样久人数
会话 ID分析工具一次访问开始一段时间不活跃或切换账号后结束访问次数

以 TapCub 为例:访客 ID 由站点盐和地址、浏览器信息算出哈希,不写 Cookie;严格隐私设置下盐每天更换,所以同一个浏览器第二天就是新访客。设备 ID 只在开启识别模式、并且用户同意统计时才写入。会话对应一次访问。只有 User ID 是你自己的。

User ID 什么时候挂上

一个用户通常经历五个阶段:

  1. 匿名浏览。 没登录,事件只带访客 ID,允许时再带设备 ID。
  2. 在一台设备上第一次登录。 代码传入 User ID。TapCub 会把这台设备之前的匿名事件回填给这个人,第一次访问和获客来源都不会丢。Google Analytics 对同一会话里登录前的事件也是这样处理。
  3. 在另一台设备上登录。 同一个 User ID 把新设备并到同一个人身上,这就是跨设备合并。
  4. 共用设备上换账号。 已经算给第一个人的事件不动,设备改指向第二个人,并开始新的会话。
  5. 退出登录。 清掉 ID,之后这个浏览器上的事件重新变成匿名,直到下次登录。

分析工具把设备和人对上的过程叫身份识别,User ID 是它的输入。

怎么设置 User ID

登录成功后,用你自己账号系统里的 ID 调用分析工具的 identify 或 login 方法。TapCub 网站脚本的写法:

<script>
  // 登录成功后
  tapcub.login('u_123', { $name: 'Ada' });
</script>

退出登录时:

<script>
  tapcub.logout();
</script>

login 的 ID 最长 200 个字符,可以带档案字段;bind 给同一个人追加其他标识,比如微信 UnionID。完整说明见文档在代码里关联身份。

Google Analytics 里对应的是 user_id 参数。Google 的 User-ID 说明要求 ID 由你自己生成、不超过 256 个字符,退出登录后传 null。

好的 User ID 要满足什么

  • 稳定。 同一个账号永远不变。邮箱和手机号会换,不适合当 ID。
  • 不重复,不复用。 不要把已注销账号的 ID 分给新用户,否则两个人的历史会合到一起。
  • ID 本身不含个人信息。 Google 的说明要求 ID 里不能有第三方能据此认出这个人的信息。用内部编号,不要用邮箱或姓名。
  • 不要用占位值。 给没登录的人传 0、-1、null 或 guest,会把所有匿名访客合成一个巨大的「用户」。TapCub 会拒绝 null、undefined、anonymous、guest、全零、-1、NaN、true 和 false,并在身份映射页记成告警。
  • 各端一致。 网站、App、小程序和服务端事件要传同一个值,不然一个客户会变成好几个人。

如果还想按邮箱或手机号把人对上,把它们作为附加标识传,而不是当 User ID。TapCub 会先规范化再哈希保存。一个人保留一个登录 ID,邮箱、手机号、UnionID 各最多五个,设备默认最多 50 台;超过时解绑最早的一台,并在日志里记录。

User ID 会怎样改变你的数据

启用 User ID 后,「用户」的含义变了,数字也会跟着变:

口径差异卡:同一天的网页访客、设备和归一后的用户数
TapCub 身份映射,演示数据:同一天按三种口径计数。把设备合并到人之后,比按设备数少了约四分之一。
  • 独立用户变少。 属于同一个人的多台设备只算一次。上图的演示项目里,这一天比按设备数少了约四分之一。
  • 留存变好。 换了新设备回来的人,现在算回访,不再算新用户。
  • 跨设备漏斗能走完。 在手机上加购、在电脑上付款的人,算作完成一个漏斗,而不是两个半截的。
  • 能算每个人的价值。 LTV 和人均收入都需要一个「人」来做分母。

访客数不受影响,因为它本来就不用 User ID。对比开启识别前后的数据时,比较设备数或访客数,不要比较用户数。

一个用户档案:同一个人下有四台设备和一个 OpenID
TapCub 里的一个人,演示数据:四台设备和一个微信 OpenID 通过同一个 User ID 合在一起,OpenID 昵称已打码。

User ID 与隐私

User ID 把行为和一个已知账号连在一起,所以要按个人数据对待。GDPR 第 4 条对个人数据的定义里明确列了「在线标识符」。实际要做到:

  • 在隐私政策里说明你会把账号标识发给分析工具。
  • 只在有同意或其他合法依据时采集。TapCub 的识别模式默认关闭,开启后也需要用户同意统计。
  • 能按请求找到并删除一个人的数据。TapCub 会标出提了删除或限制处理请求的人,并丢弃他们之后的新事件。

常见错误

  • 用邮箱当 User ID。 邮箱会变,而且每个事件里都带上了个人信息。
  • 各端格式不一样。 App 上是 123、网站上是 u_123,就是两个人。
  • 统计脚本还没加载就调用登录。 这次调用会丢。在 TapCub 里可以先放进 window.__tcq 排队。
  • 共用设备上忘了退出。 下一个人的访问会合进上一个账号。
  • 以为没登录的人也有档案。 他们只进汇总统计,只有 User ID 才会建立一个「人」。

延伸阅读:服务端埋点和新访客和老访客。

这个解释清楚吗?

我们会根据反馈修改和补充这篇内容。

陈屿

技术工程师

专注统计代码、SDK 与接口集成文档,从接入验证到问题排查,帮助开发者更顺畅地完成实施。

常见问题

常见追问

大家看完定义后最常问的几个问题。

还有其他问题?

直接和 TapCub 团队聊聊——工作日通常几小时内回复。

User ID 和用户名是一回事吗?

不是。用户名是登录时输入的,可能会改;User ID 是你的系统给账号分配的内部编号。在分析里它在后台发送,用户看不到。

一个人能有多个 User ID 吗?

不应该有。如果产品有几套账号体系,选一个作为 User ID,其他的作为附加标识传,分析工具才会把它们合成一个人,而不是拆成几个。

用户退出登录后 User ID 怎么处理?

清掉它:在 TapCub 里调用 logout,在 Google Analytics 里传 null。退出后的事件重新变成匿名,已经算给这个人的事件保持不变。

User ID 算个人数据吗?

算。按 GDPR,能对应到某个已知的人的在线标识符就是个人数据,哪怕 ID 本身只是一串数字。要在隐私政策里说明,并响应删除请求。

跨设备追踪一定要 User ID 吗?

要。没有登录,不同设备没法可靠地对应到同一个人,User ID 就是把它们连起来的那个标识。

在你自己的网站上看这个数字

加一行脚本就能开始,网站和 App 都能接,几分钟内就能看到第一批报表。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie