# PostHog 埋点观测与 SEO 优化经验总结

这篇文档沉淀 2026-04-21 这轮工作的经验，重点包括两部分：

- 如何判断“埋点是否真的生效”
- 如何在不新增实体页的前提下，提升 SEO 搜索触达率

## 一、PostHog 埋点观测经验

### 1. 先看业务动作埋点，不要只盯标准事件

这次观察里，业务动作埋点已经明显生效，但 `$ai_generation` 仍然为 0。

已确认有数据的关键事件包括：

- `ai_input_click_send`
- `task_click_insert`
- `task_click_download`
- `task_click_retry`
- `generation_result_insert_canvas`
- `generation_result_download`
- `generation_retry_after_failure`
- `task_recovered_after_reload`

结论：

- “今天基于 MCP 补的业务埋点”已经打通
- “PostHog LLM starter 标准事件”还没有真正接入当前主生成链路

经验：

- 埋点验证要分层看
- 业务链路埋点正常，不代表标准分析事件也正常
- 标准事件为 0，不代表整条埋点链路都失败

### 2. 观察当天数据时，优先用高意图动作判断是否生效

比起只看曝光类事件，更建议优先看这些“强意图动作”：

- 发送生成
- 插入画布
- 下载结果
- 重试失败任务
- 刷新后任务恢复

原因：

- 这些动作更接近真实使用
- 一旦有值，基本可以证明核心链路已通
- 对判断“埋点是否落地成功”比页面浏览类事件更直接

### 3. 埋点复盘要输出“哪部分通了、哪部分没通”

只说“有数据”不够，必须明确拆分：

- 哪些业务事件已经生效
- 哪些标准事件仍缺失
- 问题属于“埋点未发出”还是“链路未接入”

推荐复盘口径：

- 业务动作埋点：已通
- 通用性能/页面监控：另看
- `$ai_generation` 标准链路：待补

这样后续继续修埋点时，范围更清晰，不会重复排查已通过的部分。

## 二、SEO 优化经验

### 1. 不新增页面实体，先吃透现有页面

本轮优化遵循：

- 如无必要，不新增页面
- 优先改已有首页、手册页、功能页
- 通过标题、描述、H1、正文锚文本、内链来扩展搜索覆盖

经验：

- 现有页面如果没有吃满意图，继续新建页面往往只会分散权重
- 先把已有页面的搜索意图做清楚，收益更快

### 2. 首页不要硬堆词，要按页面角色分词

推荐分工：

- 首页：品牌词、平台词、总入口词
- 功能页：模型词、能力词、操作词
- 手册页：教程词、问题词、场景词

本次采用的策略：

- 首页承接 `AI应用平台`、`画布工作区`、`流程图`、`思维导图`
- 图片页承接 `文生图`、`参考图`、`批量生图`、`nano-banana`
- 视频页承接 `文生视频`、`图生视频`、`Veo3`、`Sora`
- 拆图页承接 `九宫格拆图`、`朋友圈宫格图`
- 流程图页承接 `Mermaid 转流程图`
- 思维导图页承接 `Markdown 转思维导图`

经验：

- 同一批关键词不要全堆到首页
- 应该让“页面内容”和“搜索意图”一一对应

### 3. 模型词和应用词会提升触达率，但必须落在正文里

用户可能按以下方式搜索：

- 按模型搜：`nano-banana`、`Veo3`、`Sora-2`
- 按应用搜：`批量生图`、`图生视频`、`九宫格拆图`
- 按操作搜：`Markdown 转思维导图`、`Mermaid 转流程图`

经验：

- 只放在 `meta keywords` 没用
- 只放在首页一处也不够
- 最有效的是把词落在目标页正文、标题、H1、真实锚文本中

### 4. 内链优化比继续堆 meta 更值钱

本轮后续优化的核心不是继续改 meta，而是补正文内链。

高价值内链策略：

- `素材库` → `advanced-media-library.html`
- `API 配置 / API Key` → `advanced-settings.html`
- `批量生成 / 批量生图` → `advanced-toolbox.html`
- `九宫格拆图` → `ai-generation-image-split.html`
- `灵感创意板` → `ai-generation-inspiration-board.html`
- `AI 生成图片` → `ai-generation-image-generation.html`
- `AI 生成视频` → `ai-generation-video-generation.html`
- `Markdown 转思维导图` → `drawing-mindmap.html`
- `Mermaid 转流程图` → `drawing-flowchart.html`
- `导出与导入` → `advanced-export-import.html`

经验：

- 正文里的真实锚文本，比孤立的导航链接更有语义价值
- 内链要让“能力页”和“场景页”互相导流
- 用户读到哪里、下一步要做什么，就把链路接到哪里

### 5. 手册首页既是导航页，也是 SEO 入口页

手册首页不能只是目录。

更好的做法是：

- 用一段总述解释平台定位
- 把核心能力写成结构化列表
- 在列表里挂上高价值关键词和功能页内链

本次首页整理后的经验：

- 先修不规范 HTML 结构
- 再把“模型词 + 功能词 + 页面跳转”一起补进去

这样首页就不仅是目录，也会成为更强的入口页。

## 三、推荐工作流

以后再做同类工作，建议按这个顺序执行：

1. 先用 PostHog 看当天核心业务动作是否有值
2. 明确“业务埋点已通”还是“标准事件已通”
3. 首页补品牌词和平台级能力词
4. 功能页补模型词、场景词、操作词
5. 手册页补正文内链，不继续机械堆 meta
6. 最后用 `rg` 快速检查 `title`、`meta description`、`h1`、`href`

## 四、这轮工作的关键结论

### 埋点侧

- 今天补的业务埋点已生效
- `$ai_generation` 仍需后续独立修主链路接入

### SEO 侧

- “支持的模型 + 应用场景关键词”确实会提升触达率
- 但必须放在正确页面的正文和内链里
- 现阶段继续做内链优化，比再堆一轮 meta 更有收益

## 五、一句话原则

### 埋点

先确认业务动作有没有被记录，再确认标准事件有没有接上。

### SEO

不要让首页替所有页面吃词，要让每个页面只吃自己最该吃的搜索意图。

## 六、SEO 首页落地页设计经验（OpenTu home.html）

这次新增 `home.html` 的目标不是再堆一批重复 SEO 页面，而是把品牌首页做成一个更可信、更可转化的统一入口。

### 1. 面向用户展示卖点，不展示内部讨论过程

页面文案必须站在客户视角表达价值。

不应出现在页面上的内容：

- “README 展示案例”
- “PostHog”
- “为什么强调某模型”
- “这是为了 SEO 增加的页面”

这些属于内部策略和实现细节，只适合写在文档、PR 或复盘里。

推荐页面表达：

- 产品是什么
- 能解决什么创作断点
- 用户下一步可以怎么开始
- 为什么值得信任，例如开源、可自部署、作品可沉淀

经验：

- 内部策略可以指导页面结构，但不能成为用户可见文案
- 用户只关心收益，不关心我们为什么这样设计

### 2. 首页首屏只保留一个核心主张

首屏最容易犯的问题是信息过多：标题、副标题、标签、卖点卡、按钮、示例图全部抢注意力。

本次最终收敛为：

- H1：`开源 AI 创作台`
- 一段短副标题解释画布价值
- 三个轻量卖点卡
- 两个 CTA：进入画布、查看开源项目
- 一个真实产品动图作为视觉证据

经验：

- H1 不要承担全部解释任务，只负责把定位讲清楚
- 副标题只补充使用场景，不继续堆关键词
- 卖点卡要短，更多像“信任锚点”，不是详细说明书
- CTA 与卖点的顺序会影响视觉重心；卖点卡在前、按钮在后更适合弱化强推销感

### 3. 标题要短，SEO 关键词放到页面其他位置承接

为了视觉专业度，H1 不宜过长。

这次没有把 H1 写成：

- `OpenTu AI 创作工作台 | GPT-Image-2 与 DeepSeek-v4 画布`
- `开源 AI 图片生成与知识画布工作台`

而是收敛为：

- `开源 AI 创作台`

SEO 关键词仍然可以放在：

- `title`
- `meta description`
- section 标题
- FAQ
- JSON-LD
- 正文段落
- 内链锚文本

经验：

- H1 负责“人读起来顺”
- SEO 关键词由整页结构共同承接
- 不要为了搜索词牺牲首屏可信度

### 4. 首屏视觉要控制纵向留白和信息密度

本次设计中间经历了几个问题：

- 顶部导航和首屏距离过大，导致首屏内容下沉
- 标签、标题、副文案、按钮、卖点卡堆在一起，左侧头重脚轻
- 首屏与第二段之间留白过大，页面像断层
- 标题字距过紧，中文大字号显得压迫

最终调整方向：

- 减少导航底部 padding
- 减少 hero 底部 padding
- 单独控制 `.hero + .section` 的间距，避免影响其他 section
- 大标题适当放大字距，提升高级感
- 桌面端标题尽量单行，小屏允许自然换行

经验：

- 首页首屏的“专业感”往往来自间距，而不是更多装饰
- 不要只看单个模块，要看首屏和下一段之间的节奏
- 中文大标题需要比英文更谨慎地控制字距和换行

### 5. 示例图要承担视觉证据，不要只做装饰

右侧示例图使用 README 中已有的产品动图，避免旧图和页面卖点不一致。

经验：

- 示例图应直接证明页面卖点，例如画布、作品整理、生成过程
- 不要首屏放与当前产品形态不一致的旧图
- 图片浮层文案要短，只做补充，不抢 H1 和 CTA

### 6. SEO 页也要有可分析的行为埋点

`home.html` 虽然是静态落地页，但仍需要埋点判断 SEO 效果。

本次覆盖的行为包括：

- 页面访问
- 导航点击
- 首屏 CTA 点击
- 模型卡点击
- 作品卡点击
- 滚动深度

经验：

- SEO 效果不能只看访问量，还要看访问后的意图动作
- CTA 点击和滚动深度比单纯 PV 更能判断页面质量
- 静态页埋点要轻量，失败时不能影响页面加载

### 7. 重复 SEO 页面能删就删，用 301 合并权重

本次删除了仅为 SEO 增加、内容重复度高的页面，并将旧地址 301 到 `home.html`。

经验：

- 重复页面会分散维护成本和搜索权重
- 如果页面无法承载独立搜索意图，应合并到更强入口页
- 删除页面时必须同步更新 sitemap、redirects 和部署平台重定向配置

### 8. 首页提前注册 Service Worker 可以改善后续体验

`home.html` 会在空闲时注册 `sw.js`，让用户进入画布工作台前提前准备资源。

经验：

- SEO 落地页不只是“被搜索到”，还要帮助后续工作台加载更顺滑
- 预热资源应放到空闲时机，避免影响首屏性能
- SW 注册失败必须静默处理，不能影响用户浏览

### 9. 首页设计检查清单

以后再做类似首页，可以按这个清单检查：

1. H1 是否一句话说清产品定位
2. 首屏是否只有一个核心主张
3. 内部策略词是否全部移出用户可见文案
4. CTA 是否明确且不抢走全部视觉重心
5. 卖点卡是否足够短
6. 示例图是否能证明产品能力
7. 首屏和下一段之间是否存在断层
8. 埋点是否覆盖访问、点击、滚动和核心转化
9. sitemap 与重定向是否同步更新
10. SEO 关键词是否分布在整页结构里，而不是硬塞进 H1