john
c122bd5664
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>
38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
# 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 |
|