《快缩短网址·用户唯一标识白皮书》
项目地址：suo.run

一、缘起：为何执着于「唯一」
在数据洪流中，若无法精准锚定「谁是谁」，所有关于人的统计都将沦为虚妄。日活、留存、裂变、LTV——这些商业命脉皆系于一条纤细而坚韧的线索：用户唯一标识。唯有此线不断，数据之舟方能驶向真实彼岸。

二、双螺旋：Device ID × User ID
我们要求每一次埋点携带两根基因链：
1. Device ID——终端的指纹，识别「这台设备」。
2. User ID——业务的灵魂，识别「这个人」。
二者交织，便能在任何时刻、任何场景，还原「某人某刻某设备」的完整画像。



三、Device ID：终端的「出生证明」
1. Android 生态
• IMEI：昔日王者，Android 10 起已隐退。
• OAID：国内联盟推举的匿名标识，需用户授权。
• Android ID：系统级 ID，刷机或恢复出厂即重置。
• UUID + 文件兜底：当上述皆不可得，生成随机 UUID 并落盘，作为「弱唯一」。

算法策略：
if (OAID 可用) → OAID
else if (Android ID 合法) → Android ID
else → 新生 UUID 并缓存

2. iOS 生态
• IDFA：广告世界通用护照，iOS 14+ 需 ATT 授权。
• IDFV：同一开发者域内恒定，卸载即灭。
• UUID + Keychain：当 IDFA 拒绝、IDFV 重置时启用。



算法策略：
if (IDFA 授权) → IDFA
else → IDFV + 开发者签名 → 生成「半永久」UUID 写入 Keychain

3. Web 端
• Cookie + LocalStorage 双重锚定
• 若 Cookie 被清除，则通过 Fingerprint2 采集画布、字体、UA 等特征，生成「指纹 ID」并回写 LocalStorage



四、User ID：人的「灵魂编码」
• 登录态：以业务账号体系为准，登录即绑定。
• 匿名态：以 Device ID 为临时替身，一旦登录即完成「灵魂附体」。
• 多端合并：同一手机号 / 邮箱 / 微信 UnionID 登录，即触发「ID Mapping」，将多条 Device ID 指向同一 User ID。



五、落地范式：埋点字段模板
{
"event": "page_view",
"ts": 1713956789123,
"device_id": "a1b2c3d4-e5f6-7890-abcd-1234567890ab",
"user_id": "u_987654321",
"url": "https://suo.run/abc123",
"referrer": "wechat",
…
}

六、优雅降级与隐私合规
• 所有标识符采集前弹窗授权，遵循 GDPR / 国标《个人信息保护法》。
• 提供「一键抹除」接口，Device ID & User ID 同时失效并重新生成。
• 服务端存储时，敏感标识符一律加盐哈希，杜绝逆向。

七、结语
在「快缩短网址」的宇宙里，每一次点击都是一次心跳。Device ID 与 User ID 如同双星系统，以精密的引力锁定每一个真实生命。让数据不再迷失，让增长有迹可循——这，便是我们执着于「唯一」的全部意义。