帮助中心

怎么调 login 识别一个用户？

四个身份方法、各自存什么，以及哪些 ID 会被拒绝。

数据分析1 分钟阅读最后更新 2026 年 10 月 28 日TapCub 团队所属指南：跨网页、App、小程序识别用户

更多：数据分析

还有其他问题？

没找到答案？每条消息都有真人阅读，工作日通常几小时内回复。

简短回答

自己的登录成功后调 tapcub.login(id, props)，用 bind() 补充更多标识，退出时调 logout()。id 必填（最长 200 字符）；邮箱转小写后哈希，手机号规范化。

四个方法

识别模式开启后，脚本暴露四个方法。自己的登录成功后调 login，用户退出时调 logout：

app.js

// 你的登录成功之后
tapcub.login('u_123', { $name: 'Ada', plan: 'pro' });

// 为同一个人补充其他标识
tapcub.bind({ unionid: 'UNION_ID' });

// 退出登录时
tapcub.logout();

方法	作用
`login(id, props, opts)`	`id` 必填，最长 200 字符。`opts.type` 默认是你的登录 ID，也可以是邮箱、手机号、OpenID 或 UnionID。邮箱转小写后哈希；手机号去掉空格和短横线。`props` 里的姓名、邮箱、手机进入档案。
`bind(ids)`	给同一个人添加更多 ID。登录类型的 ID 每人一个；邮箱、手机、UnionID 各最多五个。
`logout()`	清除登录并轮换会话标记，共用设备上的下一位访客从头开始。
`setProps` / `setPropsOnce`	覆盖档案字段，或只在字段为空时写入——比如首次来源活动。