使用教程 | Yeehai SEO Board

Yeehai SEO Board 将 Google Analytics 4（GA4）与 Google Search Console（GSC）数据收敛到客户项目，支持资源确认、完整自然月同步、SEO 月报、季度报告、人工解读、第三方指标补充、客户分享及资源用量观察。它不是通用 BI，也不会在浏览页面时自动读取 Google API。

01角色与权限

SEO 管理员：管理 Google 账号、项目、资源匹配、报告生成、模块、人工内容、第三方指标、客户分享和资源用量。
只读成员：查看项目、报告和账号概况；可导出项目数据、Excel 与 PDF，但不能进行管理型修改。
客户 / 外部收件人：只通过一份报告的分享链接与 4 位密码访问该报告，不能登录后台或浏览其他项目。

权限提示

页面没有某个按钮通常表示当前账号没有对应权限。需要新增项目、生成报告或创建分享时，请使用管理员账号。

02快速上手

登录后在“数据总览”确认当前月份和整体趋势。
在“月报中心”按项目名称、域名或报告目录名搜索项目。
打开所需月份的报告，先读摘要和行动建议，再查看趋势与榜单。
需要留档时导出 Excel / PDF；如需客户查看，由管理员创建分享链接。

重要提示

切换月份、浏览项目和查看报告只读取 D1 中已有快照；它们不会触发同步或自动生成新报告。

02A制作最简单的月报

第一次使用时，先走一条最短的可交付路径。只要有管理员、一个已确认项目、已授权的 GA4 与 GSC 主资源和一个已结束的自然月，就能产出基础月报。

连接数据：在“Google 账号”完成 OAuth；确认项目后分别选择一个可用且已授权的 GA4 Property 和 GSC Site。月报核心指标需要两类数据源都返回数据。
确认项目：在“项目管理”检查名称、域名、slug 和“月报就绪状态”，先处理连接未完成或授权失效。
选择月份：进入“月报中心”项目报告目录，选择一个已结束的自然月，例如 2026-08。
生成一次：点击“生成该月月报”，等待 queued → running → succeeded；同一项目 / 月份的活动任务会被复用。
快速复核：打开报告，先看“摘要”“关键词与页面机会”“行动建议”，再确认完整性提示与数据来源月份。
补充解读：至少填写一个章节的“现状分析”和下月优先行动。导出或分享前，系统会提醒仍为空的可见人工模块。
交付：导出 PDF 或结构化 Excel；需要客户查看时，再创建一条带 4 位密码的单份报告分享链接。

最小交付清单

已确认项目 · GA4 与 GSC 两个可用数据源 · 一个完整月份 · 报告状态为 succeeded · 摘要 / 机会 / 行动建议已检查 · 至少一段人工分析 · PDF 或 Excel 文件。

遇到 partial 怎么办？

先查看任务错误与报告完整性提示，修复授权或资源匹配后再重新生成；不要把部分成功报告直接当作完整交付。

03查看数据总览

“数据总览”用于快速了解当前月份全部已确认项目的整体表现，可通过月份选择器或前后按钮切换查看范围。

项目数量：已确认、纳入管理的客户项目数量。
自然搜索点击：用户从 Google 搜索结果进入网站的点击次数，来源于 GSC。
自然搜索展示与关键词：反映搜索可见度变化，来源于 GSC。
自然搜索会话：网站通过自然搜索获得的访问会话数，来源于 GA4。
上升 / 下降项目：与上一可比月相比的项目数量。

趋势图展示最近 6 个月的 GSC 点击和 GA4 自然搜索会话；右侧“Google 账号”卡片用于查看连接概况。点击与会话来自不同数据源、统计方法不同，数值通常不会完全相等。

总览的读取边界

月份切换和浏览总览只读取 D1 中已经保存的快照，不会在页面打开时请求 Google API。看到“暂无数据”或“—”时，先确认该月份是否已经同步。

04项目与数据连接

所有角色都可在“项目管理”按项目名称、域名或 Google 账号搜索，切换分页和每页行数，并导出当前筛选结果。列表指标随当前月份变化，比较项目前请确认月份一致。

连接账号：管理员在“Google 账号”完成 OAuth 后，系统发现其可访问的 GA4 Property 和 GSC Site。刷新账号列表只更新资源目录，不会生成报告；不要把“已发现资源”当作“项目已经配置完成”。

确认与匹配：管理员需要确认项目名称、主域名和稳定的报告 URL 名称（只支持小写英文字母、数字和连字符），再分别选择 GA4 / GSC 主资源。两类资源可以来自不同 Google 账号；手动保存后会锁定匹配，也可以恢复自动匹配。

报告目录出现“连接未完成”或“授权失效”时，请先修复资源关联或重新授权。项目行上的“取数筛选”可按国家 / 地区筛选 GA4 与 GSC，并按主机名筛选 GA4；系统会先读取近 90 天候选数据，保存后旧指标会进入待重算状态。

报告前提

只有已确认项目才会读取报告指标。未确认资源仅保留在候选资源目录中，不会继续消耗报告 API 配额。

05生成与刷新报告

在“月报中心”找到已确认项目并打开其报告目录。
管理员选择一个已结束月份，点击“生成该月月报”；或使用“补全近 6 个月月报”建立趋势基线。
系统创建异步任务，依次显示等待、运行、成功、部分成功或失败状态。
完成后打开报告检查数据完整性。部分成功时，请先查看任务错误和报告提示。

月报仅按完整自然月生成；同一项目同一月份的活动任务会被复用，避免重复并发同步。关闭浏览器不会中断已经提交到后台队列的任务。报告不存在不等于没有业务数据，也可能是该月份尚未生成。

季度报告：先准备连续 3 个月的月报，再在项目报告目录选择起止月份并填写报告名称。季度报告复用这 3 个月的已保存数据与模块设置，不会重新读取 Google；季度报告中的环比是与上一个连续三个月比较。

任务状态怎么处理

queued 表示排队中，running 表示正在读取和写入，succeeded 可进入审核；partial 保留成功部分但必须先看错误和完整性提示，failed 则先修复授权、匹配或月份问题再重试。

06如何阅读 SEO 报告

摘要：先看自然搜索会话、点击、展示、CTR、平均排名及综合趋势，快速判断当月表现。若管理员录入了第三方指标，这里还会显示 Semrush / Moz 的补充数据。

搜索表现：查看 6 个月搜索可见度、自然流量、互动和关键事件趋势，判断波动是否持续。

关键词与页面机会：查看 TOP 查询 / 页面、Google 首页关键词、目标关键词、重点页面、站内文章与关键词变动，定位优先优化对象。目标关键词、重点页面和站内文章只有在项目配置后才会出现。

流量结构与质量：结合渠道、自然搜索落地页、跳出率、访问时长、设备和地区判断流量质量。

行动建议：确认负责人下一阶段的优先事项；管理员可以编辑下月优先行动和各章节现状分析，也可以增加带文字和图片的自定义章节。

第三方指标：这是可选的供应商估算数据，不替代 GA4 / GSC。当前支持 Semrush 的预估月流量、自然搜索关键词数、Authority Score，以及 Moz 的 Domain Authority。本期有上月数据时，流量 / 关键词数显示百分比变化，两个评分显示分数变化；没有本期数据时，报告可能标记为“历史沿用”。

不要只看一个数字

平均排名数值越小通常越靠前；GSC 点击与 GA4 会话统计的是不同环节；“可见关键词 / 页面”是 API 返回的有展现数据，不是网站被收录的全部数量。

07目标关键词、页面与模块配置

目标关键词：管理员在项目目录点击“目标关键词”，统一维护该项目所有月报共用的清单，最多 200 条精确、包含或 RE2 正则规则；支持 CSV / TXT 导入和从榜单收藏。保存时可选择仅保存、更新指定月份或手动重算所有已有月份。首次设置时会突出提醒历史月份重算，操作由用户选择。

历史月报保留原有快照，重算会更新相应月份的客户分享内容。发布前检查会提醒清单未同步、任务失败等情况；可在月报点击“更新本期关键词”重试。全月份重算请等待逐月任务提交完毕后再关闭页面，已提交任务会在后台继续执行。

重点页面与长博客：“重点页面”最多维护 100 个 URL，按完整自然月环比展示表现；站内文章（长博客）使用独立的文章监控模块，每个项目最多 1,000 篇，支持单条添加、粘贴 / CSV / TXT / XLSX 批量导入、301 改址与批量停用 / 删除。文章请填写发布日期：发布不足 30 天的文章显示“待观察”，不进入考核。完整操作见文章监控使用指南。

调整模块：在报告中打开“调整模块”，可以隐藏当前报告不适用的内容模块，并选择渠道图表类型、指标和趋势口径；至少保留一个内容模块。修改关键词最低展现量或排名变化阈值会创建定向重算任务；保存为项目默认模板只影响未来新生成的同类型报告。

取数筛选：项目级筛选支持国家 / 地区的包含或排除，以及 GA4 主机名的包含或排除。保存后受影响的历史指标不会悄悄覆盖，需等待重算完成后再作为最终数据使用。

08编辑、导出与客户分享

管理员可为各章节编辑“现状分析”，编辑管理层摘要，单独维护“下月优先行动”，并创建自定义章节。保存或取消当前编辑、模块设置后再交付。可见的人工模块为空、数据缺失、同步异常或配置未更新时，系统会在导出或分享前提示检查；可以返回处理，也可以明确跳过本次检查。

导出数据：下载当前报告的结构化 Excel。文件包含人工编辑内容汇总、报告章节工作表和底层数据；隐藏模块的数据仍会保留，Excel 不包含网页图表。
导出 PDF：等待图表加载，点击“导出 PDF”，在浏览器打印界面选择“另存为 PDF”。
安全分享：点击“分享报告”生成单份报告链接与 4 位密码，复制给客户。

第三方指标如被隐藏，先在“调整模块”中显示“第三方指标”，再在报告摘要点击“编辑指标”录入；留空字段不会显示，来源链接可选。客户解锁后仅可在当前浏览器查看这一份报告，授权保留 7 天。重置密码会使旧密码和已解锁会话失效；更换链接或撤销分享会使旧 URL 立即失效。若颜色或图表在 PDF 中缺失，请在打印设置中启用“背景图形”。

09资源用量（管理员）

“资源用量”提供 Workers、D1、Queue 与存储的真实平台汇总或预计费用，并展示每日趋势、套餐额度、项目归因与最近同步任务。

项目归因用于比较 Google API、D1 语句、Queue 操作、快照存储和任务耗时；其中平台指标可能是真实值，项目 D1 / Queue 和耗时等部分是估算值，不能视为 Cloudflare 账单总额。页面访问、登录、管理接口和定时采集等公共开销不会归属于单个项目。

可以按当前账期或自然月查看，点击“刷新采集”重新读取平台快照。资源用量只面向管理员，不能替代正式账单。

10系统提示与工单

最近更新：登录后顶部的“最近更新”会展示用户可见的版本变化；有未读内容时会出现提示。阅读后可以在弹窗中查看历史版本。

维护与版本：如果页面顶部或正文出现系统维护提示，请按提示等待或避开高风险操作。看到“版本已更新 · 刷新”时，先保存或取消正在编辑的摘要、分析、行动和模块设置，再刷新页面，避免草稿丢失。

工单系统：从顶部“工单系统”或工单页面提交需求 / BUG，并填写提报人、标题、详细描述和关联项目；问题截图与目标示意图可以分别上传，单张图片不超过 5 MB，每张工单最多 6 张。提交后可在列表查看状态和处理说明。

11常见问题

“暂无数据”是否等于 0？不是。“暂无数据”或“—”通常表示未同步、未生成或该数据源不可用；只有数据源明确返回时才应理解为真实 0。

为什么 GA4 和 GSC 数字不同？GSC 记录搜索结果展示与点击；GA4 记录进站后的会话和行为。时区、归因、Cookie 与处理规则不同都会产生差异。

为什么报告是部分成功？某些数据块成功、另一些失败时，系统保留成功内容并标记为部分成功。请先查看错误与完整性提示，再决定是否重新生成。

为什么第三方指标和 GA4 / GSC 不一致？第三方指标是供应商估算值，统计范围、数据库、设备和更新时间可能不同；它只作为补充参考，不应与第一方指标直接相加或互相替代。

为什么项目有数据但没有报告？数据同步和报告生成是两个步骤；请确认项目已确认、月份已结束，并在月报中心查看该月份是否已经生成。

需要新增功能或反馈 Bug？请提供项目或域名、月份、所在页面、操作步骤、截图和期望结果，并填写工单。