discipline/rounds/round-08-english-analytics-adsense.md
📑 本页目录
轮次记录 · Round 8 · 英文版 + 自建埋点 + AdSense 配置化
1. 目标与选题
- 用户指令：继续迭代（Round 8），落实「理论 → 网站盈利」纵向链路的第一段变现。
- 选题（来自 round-07 §7 候选 1）：英文版 + 埋点 + AdSense 上线，即 L5 第一阶段 ——广告收入的前提是海外流量（ADSENSE_SETUP.md 指出 Google 广告在大陆被墙）与 可检验的指标链数据（09-value-chain §7 的「待埋点（Round 8）」）。
2. 背景与相关文献
- 学科资产：09-value-chain.md（五层模型、指标链 H20/H21、变现纪律）、 07-iteration.md（迭代协议）、06-evidence.md（先注册后计分）。
- 业界做法：自建轻量遥测（JSONL 追加写）常见于小流量站点的隐私友好替代； AdSense 需配置驱动、审核后上线（不伪造「已上线」状态）。
- 约束：1GB 内存、无第三方分析依赖；事件口径必须与学科「先注册后计分」一致。
3. 框架变更（Decision）
| # | 决策 | 落点 |
|---|---|---|
| D34 | 自建轻量埋点：事件 JSONL 按月存储 + 只读聚合 API + 看板页；事件类型先登记（事件注册表），未知事件拒绝 | app/analytics_api.py、app/static/analytics.js、app/static/analytics.html、data/analytics/ |
| D35 | AdSense 改为配置驱动全站注入：环境变量 APP_TRENDS_ADSENSE_ENABLED + APP_TRENDS_ADSENSE_CLIENT；占位 ID 默认不生效 | app/page_inject.py、app/config.py、ADSENSE_SETUP.md |
| D36 | 所有 HTML 页面统一注入（AdSense + 埋点），静态文件保持干净；开关切换无需重建页面 | app/main.py render_page() + /discipline 注入 |
| D37 | 英文版范围（Q15 定案）：先做获客关键页 —— /en 门户 + /en/value-chain，双向语言切换；产品 UI 仍为中文并如实标注 | app/static/en/、main.py /en 路由、各页 EN/中文 切换 |
| D38 | 指标链落地：漏斗事件（页面浏览/许愿提交/会话提问/手动采集/CTA/语言切换）全部先登记后上报 | analytics_api._EVENTS + 09-value-chain §7 状态更新 |
4. 实践产物与结果
- 埋点：
POST /api/analytics/event（会话标识由 localStorage uuid 生成，不设 Cookie）；GET /api/analytics/summary（PV/UV/日趋势/Top 页面/事件计数/漏斗/留存代理， 可配 secret 保护）；/analytics指标看板页（纯前端、无第三方依赖）。 - 页面注入：
app/page_inject.py统一注入 AdSense（配置启用才注入）与 analytics.js；覆盖首页/看板/许愿池/会话/价值链路/隐私/学科全部 HTML。 - 英文版：
/en门户（价值主张 + 产品表 + 语言说明）与/en/value-chain（五层模型英文版）；中文页头部与学科导航加 EN/中文 切换。 - 任务事件：许愿提交（wish_submit）、会话提问（chat_send）、手动采集 （collect_click）、CTA 点击（cta_open）、语言切换（lang_switch）。
- 结果指标：全站页面注入生效；事件注册表 6 类事件先登记；指标看板可读； AdSense 保持「审核中，未启用」的诚实状态（占位 ID 不生效）。
5. 评估
- 达标：指标链 L3/L4 指标从「待埋点」变为「有数据管道」；变现 L5-1 前置条件 （海外入口 + 广告位配置化）就绪；英文获客页在线；事件口径与学科纪律一致。
- 未达标：AdSense 审核与真实收入不可由代码完成（需域名解析 + Google 审核）， 如实标注为「配置就绪，待审核」，不伪造。
- 诚实声明：埋点数据自上线日起积累，H20/H21 仍按季度计分（不因数据管道上线 而提前宣称成立）。
6. 未决问题
- Q14 结案：埋点采用自建 JSONL 方案（隐私友好、无依赖）；若流量上升至 单月 >100k 事件再评估迁移（届时保留事件注册表口径）。
- Q15 结案：英文版先做获客关键页；全套学科文档英文化列为 backlog （RQ 新增：文档 i18n 优先级）。
- Q18 埋点隐私：EU 用户需要 Cookie/同意机制时，再叠加同意门（当前无 Cookie、 聚合口径，先记录此风险）。
- Q16 未动：Pro 定价锚点（Round 9）。
7. 下一轮建议（Round 9 候选）
- Pro 订阅（watchlist 推送 + 周报邮件）：L5 阶段 2，首个付费转化； 指标链需新增「订阅转化」事件并先登记。
- 英文产品 UI 化：趋势雷达/预测看板 UI 双语化（承接英文版入口流量）。
- 许愿池 → 每周需求报告：聚合愿望数据产出周报（L5 阶段 2/4 雏形， 同时喂给订阅内容）。
8. 版本号与 changelog
- 版本：v0.7 → v0.8。Changelog 见 rounds/README.md。