feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
Document Umami as the sole analytics platform, remove Rybbit proxy and tracker code, and classify public page traffic with discovery_channel for adm SEO/GEO dashboards. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -0,0 +1,37 @@
|
||||
# Memind 访问统计平台说明
|
||||
|
||||
## 当前唯一平台:Umami
|
||||
|
||||
Memind 公开页与生成页的真实用户访问统计 **仅使用 Umami**(`memind-analytics` 独立部署,生产入口 `fxi.tkmind.cn`)。
|
||||
|
||||
- Portal 通过同源 `/analytics/*` 代理 Umami tracker
|
||||
- 管理后台(memind_adm)通过 SSO 进入 Umami,并提供 **SEO / GEO 发现流量** 专用看板
|
||||
- 生成页事件维度见 `mindspace-analytics.mjs`(含 `discovery_channel` / `discovery_source`)
|
||||
|
||||
本地配置见 [local-analytics.md](local-analytics.md)。
|
||||
|
||||
## 已退役:Rybbit
|
||||
|
||||
**Rybbit 已于 2026-08 下线,不再部署、不再注入 tracker、不再提供 SSO。**
|
||||
|
||||
历史背景:Rybbit 曾作为 Umami 并行的行为分析方案(`/rybbit/*` 代理、`MEMIND_RYBBIT_*` 环境变量、memind_adm Rybbit SSO)。该方案已废弃。
|
||||
|
||||
**禁止**在新代码、文档、环境变量示例或运维脚本中重新引入 Rybbit 相关配置。若看到遗留引用,应删除而非「可选保留」。
|
||||
|
||||
## SEO / GEO 流量口径
|
||||
|
||||
| 字段 | 含义 |
|
||||
|------|------|
|
||||
| `discovery_channel` | `seo`(搜索引擎)/ `geo`(生成式引擎)/ `direct` / `referral` |
|
||||
| `discovery_source` | 具体来源,如 `google`、`baidu`、`chatgpt`、`perplexity` |
|
||||
| `referrer_host` | 外部 referrer 域名(不含路径) |
|
||||
|
||||
分类逻辑见 `mindspace-analytics-discovery.mjs`。Shell + iframe 场景会通过 `memind_discovery` 查询参数向内层传播来源。
|
||||
|
||||
## 相关仓库
|
||||
|
||||
| 仓库 | 职责 |
|
||||
|------|------|
|
||||
| **Memind** | tracker 注入、discovery 分类、Umami 代理 |
|
||||
| **memind-analytics** | Umami 定制部署、`memind-pages` API(overlay 在 `deploy/umami/overlay/`) |
|
||||
| **memind_adm** | Analytics 配置、SEO/GEO 看板、Umami SSO |
|
||||
Reference in New Issue
Block a user