终端用户留存分析可直接用$uid_set和$uid_got实现，核心是nginx层稳定生成并传递这两个变量：$uid_set首次访问设cookie并赋值，$uid_got从当前请求cookie提取，二者对比即可识别新老用户，结合access_log中按天解析日志即可完成d1/d7留存统计。
直接用 $uid_set 和 $uid_got 实现终端用户留存分析，关键不在于复杂埋点，而在于日志中稳定、可追溯的用户标识链路。只要 Nginx（或 OpenResty）层能正确生成和传递这两个变量，后续通过日志解析即可完成按天/周粒度的留存统计，无需客户端 SDK 或后端 session 支持。
理解 $uid_set 与 $uid_got 的作用分工
这两个变量通常由 nginx-http-uid-module（或 OpenResty 的 resty.uid）提供，是轻量级用户标识机制的核心：
-
$uid_set：在用户首次访问时生成唯一 UID（如 base64 编码的 16 字节随机数），并写入 Cookie（如
uid=AbC123...），同时将该值赋给此变量；若已存在有效 uid Cookie，则不覆盖，保持原值 - $uid_got：从当前请求的 Cookie 中提取 uid 值；若 Cookie 不存在或格式非法，则为空字符串
二者差异决定了“新老用户识别”逻辑：当 $uid_set == $uid_got，说明本次是回访（UID 已存在）；若 $uid_set 非空但 $uid_got 为空，说明是新用户（首次访问，刚设 Cookie）；若两者均为空，可能是爬虫、禁 Cookie 用户或异常请求，建议过滤。
在 access_log 中记录关键字段
在 Nginx 配置中扩展 log_format，显式输出用户标识和时间戳：
log_format analytics '$time_iso8601\t$uid_got\t$uid_set\t$request_method\t$status\t$uri'; access_log /var/log/nginx/analytics.log analytics;
注意要点：
- 使用 制表符 \t 分隔，便于后续用 awk / Python / Spark 快速切分
- 必须包含 $time_iso8601（ISO 格式时间），用于按天归档和对齐日期维度
- 保留 $uid_got（实际参与行为的 ID）和 $uid_set（是否触发新 ID 生成），二者共同支撑“新增判定”
- 避免记录敏感字段（如 IP、完整 Cookie），符合基础隐私要求
用日志解析实现次日/7 日留存计算
以次日留存（D1 Retention）为例，核心是：统计某日（比如 2024-05-01）的新用户数，再看其中有多少人在 2024-05-02 仍有请求。
- 步骤 1：从日志中提取每日活跃 UID 集合（去重）
awk -F'\t' '$2 != "" {print $1"\t"$2}' analytics.2024-05-01.log | sort -u -k2,2 > uid_20240501.txt - 步骤 2：标记“新增用户”——取 $uid_set 非空且 $uid_got 为空的行
awk -F'\t' '$3 != "" && $2 == "" {print $2}' analytics.2024-05-01.log | sort -u > new_uid_20240501.txt - 步骤 3：检查这些新 UID 在第二天是否出现
awk 'NR==FNR{a[$1]=1;next} $2 in a' new_uid_20240501.txt analytics.2024-05-02.log | sort -u -k2,2 | wc -l
结果即为 2024-05-01 新用户中，2024-05-02 的回访人数。除以 new_uid_20240501.txt 行数，即得 D1 留存率。同理可扩展至 D7（需合并 7 天日志做交集）。
注意事项与常见陷阱
这套方案轻量，但几个细节决定结果可信度：
-
Cookie 过期策略要明确：Nginx 模块默认设 Cookie max-age=365d，若业务希望更短（如 30 天），需手动配置
uid cookie expires=2592000; -
跨子域需共享 Cookie：若 www.example.com 和 app.example.com 都要计入同一用户，设置
uid cookie domain=.example.com; - 避免缓存干扰：CDN 或浏览器缓存可能不带 Cookie，导致 $uid_got 为空；建议对关键路径（如首页、API）关闭强缓存，或用 no-cache + Vary: Cookie
- 移动端 WebView 场景需额外处理：某些 Android WebView 默认禁用第三方 Cookie，可考虑 fallback 到 URL 参数透传（如 /?uid=xxx），并在 Nginx 中用 map 提取覆盖 $uid_got
不复杂但容易忽略。
