# 数据追踪

路径 `/tracking`，对应左侧导航 **数据追踪 → 数据详情**。这是省心推 GEO 价值的核心呈现位：在豆包、文心一言、通义千问、DeepSeek、Kimi、混元/元宝等 AI 平台上采样品牌相关问题的真实回答，归因引用来源，量化品牌曝光。

## 1. 数据来源

数据**不是从第三方搜索引擎抓的**，而是由桌面客户端直接打开 AI 平台对话页、按问题集逐条采样：

- 每个 **品牌 → 关键词 → 问题** 都是一次采样单位
- 桌面客户端每天按计划运行采样任务，把模型回答和引用来源回写到服务端
- 你也可以在页面里手动 **立即采集**

> 数据采集前置条件（缺一项就拿不到数据）：
> 1. 当前账号已在桌面客户端登录、且客户端**在线**
> 2. 桌面客户端的 **AI 平台** 页面已绑定至少一个 AI 平台并 **授权正常**
> 3. 品牌词库里已建好品牌 → 关键词 → 至少一个问题

## 2. 页面结构

进入 `/tracking` 后顶部是筛选区：

- **品牌**：必选；账号下没品牌时整页空
- **关键词**：可选，限定到具体关键词
- **AI 平台筛选**：聚焦看某个平台的表现
- **立即采集** 按钮：仅当上述前置条件全部满足时可点

页面主体分为四块：

### A. 平台对比矩阵

横向把当前所有 AI 平台并排，纵向是品牌相关指标。能直观看到：

- 哪些平台经常引用我？
- 哪些平台一次没引用？
- 同一个问题在不同平台上的回答差异

### B. 高频问题

按品牌库当前关键词下的问题集排序展示：

- 显示问题文本、最近一次采样时间
- 点击任一问题进入 **问题详情页**

### C. 引用排行（Citation Ranking）

按发布外链主体归因 SaaS 发文在模型引用来源中的出现次数与占比：

- 时间窗口：**近 7 天 / 近 30 天** 切换
- 字段：来源域名、引用次数、占比
- 视图说明：「按发布外链主体归因 SaaS 发文在模型引用来源中的出现次数与占比」

### D. 被引用文章（Cited Articles）

横向列出被任意 AI 平台引用过的省心推平台内文章：

- 字段：文章标题、被引用次数、最近被引平台
- 点击文章可进入文章详情抽屉

## 3. 问题详情页

路径 `/tracking/questions/:brandId/:questionId`。这是省心推数据回看的最深层级，分四块：

### 答案内容（Answer Content）

- 选中的 AI 平台对该问题的最新回答全文
- 没有采样数据时显示「该平台暂无采样回答」

### 引用来源（Citation Sources）

- 模型回答里附带的所有外部链接
- 字段：序号 + 链接 + 域名
- 每条引用来源右侧有 **仿写创作** 按钮：一键把这条外链作为来源导入仿写流程（详见 [文章创作 §仿写创作](./03-文章创作.md#4-仿写创作)）

### 引用分析（Citation Analysis）

- 服务端基于回答内容做的归因分析
- 试图回答"为什么模型在这个问题上引用了这些来源"

### 内容引用（Content Citations）

- 当前账号已发布的文章在该问题里被引用的次数
- 用于直接验证"我们写的文章是否被 AI 引用了"

## 4. 立即采集

立即采集会触发桌面客户端马上跑一次该品牌（或具体关键词/问题）的采样任务。可点击场景：

- 当天日期 + 客户端在线 + AI 平台授权正常 + 至少一个问题已建立

不可点击的常见原因：

| 提示 | 解释 |
| --- | --- |
| 「请先选择品牌，再发起采集」 | 顶部筛选未选品牌 |
| 「请先选择关键词，再立即采集当前问题」 | 在问题详情页未限定关键词 |
| 「立即采集只支持今天的数据，请切回今天后再操作」 | 数据查询区切到了历史日期 |
| 「正在检查当前账号的桌面客户端状态」 | 客户端心跳中，稍等 |
| 「当前登录账号的桌面客户端未在线，暂时不能立即采集」 | 桌面端没启动或网络中断 |
| 「当前账号尚未注册桌面客户端，不能发起采集」 | 没装客户端、或客户端没用同一账号登录过 |
| 「当前账号暂无已授权 AI 平台，不能发起采集」 | 桌面端 AI 平台页面没绑定任何平台 |
| 「当前筛选平台未授权，不能发起采集」 | 筛选了某个平台，但该平台没授权 |

## 5. 采集模式与覆盖率

页面顶部信息条会展示：

```
插件采样 · 目标 X · 计划 Y · 已采样 Z · 覆盖率 A% · 更新于 ... · 触发方式
```

字段含义：

- **目标**：原计划要采样的次数
- **计划**：实际生成的采集任务数
- **已采样**：成功回写结果的次数
- **覆盖率**：已采样 / 目标
- **触发方式**：周期任务 / 立即采集

> 插件模式（实际为桌面客户端模式）下结果受设备在线率影响，**低覆盖样本仅供趋势参考**。建议保持桌面客户端长期在线以提升覆盖率。

## 6. 平台授权状态横幅

页面顶部会显示授权状态卡片：

| 状态 | 含义 | 后续动作 |
| --- | --- | --- |
| **AI 平台授权正常** | 已有可用授权 | 可正常采样 |
| **未检测到桌面客户端** | 当前账号没在桌面客户端登录过 | 安装并登录桌面客户端 |
| **暂无已授权 AI 平台** | 客户端有，但 AI 平台未绑定 | 桌面端 → AI 平台 → 绑定 |

## 7. 异步任务调试

页面底部有一块 **异步任务调试**，仅用于排查 callback → 队列 → worker 的流转，不影响上方四块主内容。一般用户可忽略；遇到数据延迟或缺失时可截图给运营同学看。

## 8. 常见问题

- **页面常年空白**：99% 的情况是缺前置条件之一（品牌 / 问题 / 桌面客户端 / AI 平台授权）
- **某个 AI 平台总是没数据**：去桌面端 **AI 平台** 页面看该平台的授权状态；常见是 cookie 过期需要重新授权
- **引用排行里没看到自己的文章**：归因按"发布外链主体"匹配；要确认文章已发布到第三方平台并产生了外链，且模型在采样窗口内引用了这条外链