Initial TrueGrowth source import
This commit is contained in:
355
docs/POSTHOG_SEO_LESSONS.md
Normal file
355
docs/POSTHOG_SEO_LESSONS.md
Normal file
@@ -0,0 +1,355 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user