Pagewise 用户使用手册

认识 Pagewise

Pagewise 解决一个问题：把分散在「关键词调研、写文案、建页面、发布、看数据、改页面」之间的手工操作，变成一条闭环流水线。你在知识库里维护 AI 写作的素材（痛点、场景、卖点、内链），用 AI 一键生成完整的落地页草稿，在可视化编辑器里审阅、修改并发布成店铺前台的真实页面，然后通过 Search Console 与 GA4 数据持续跟踪每个页面的表现，按系统给出的优先级队列逐条优化。

功能模块速览

快速上手

2.1 打开应用

在 Shopify 后台左侧「应用」列表中点击 Pagewise，应用嵌入在 Shopify 后台内打开，默认进入首页。如果直接访问应用网址且会话已失效，会先看到「登录 Pagewise」页面——输入店铺域名（形如 my-store.myshopify.com）即可继续安装或登录。

2.2 完成新手引导向导（约 5 分钟）

首次使用时，从首页「快速开始」清单第一项点「继续设置」进入 6 步向导。可中途离开，回来后已完成的步骤会保留；右上角「跳过设置」会把向导标记为完成，但其余配置仍需在各功能页里补齐。

1. 品牌与市场 — 填写「品牌名称」，选择主要市场（🇺🇸 United States 或 🇩🇪 Germany，决定生成页面的文案语言），点「继续」。
2. 同步产品 — 点「同步我的产品」，看到「已同步 N 个产品」徽章后才能点「继续」。
3. 页面存储 — 系统自动检查主题是否支持应用页面；点「创建页面存储」，出现「页面将存储为：…」后继续。若提示主题可能不支持，需切换到 Online Store 2.0 主题后点「重新检查主题」。
4. 品牌外观 — 点「从我的主题推荐」自动取色，或手动调整主色、强调色、背景色、文字色和标题 / 正文字体，点「保存并继续」。
5. AI 知识库 — 点「从我的目录生成」，AI 读取产品目录起草痛点 / 场景 / 卖点三个列表；逐行检查、删除不合适的行（不满意可「重新生成」），点「应用到知识库」；再在内链资源区点「一键导入站内页面」。
6. 示例页面 — 点「生成示例页」（约 20 秒，实际可能更久，后台运行可离开页面），成功后点「查看页面」审阅草稿，最后点「完成」。

截图占位 新手引导向导：第 5 步「AI 知识库」生成后的痛点 / 场景 / 卖点编辑列表 images/onboarding-wizard.png

2.3 端到端典型工作流

1. 走完上面的初始设置向导（品牌 → 产品 → 存储 → 外观 → 知识库 → 示例页）。
2. 进入「知识库」补全素材：录入或 AI 起草痛点话题、目标场景、服务卖点；在「内链资源」页签点「一键导入站内页面」。
3. 进入「生成」页：选目标市场、痛点话题、目标场景，勾选 4 个主推产品系列，点「AI 一键生成草稿」。
4. 在「确认 AI 生成参数」弹窗核对参数后点「确认并生成草稿」，等待 1–5 分钟（后台运行，可离开页面）。
5. 到「页面管理」找到新草稿，点「编辑」进入编辑器：调整版块、把各版块的占位图替换成真实图片（AI 暂不生成图片）、用「AI 改写」润色、填好 SEO 标题与描述，保存并预览。
6. 确认无误后在编辑器点「发布」，页面即成为店铺前台可访问、可被搜索引擎收录的真实页面。
7. 接入数据：在「设置 → Google 自动同步」配置每日自动同步，或手动上传 GSC / GA4 导出文件。
8. 日常在「搜索表现 GSC」看数据、找关键词机会（可一键「用此词生成页面」），在「监控 & 洞察」按优先级处理行动队列，形成闭环。

首页与导航

首页是打开 Pagewise 后的第一站：用「快速开始」清单带你完成初始配置，用功能入口卡片直达核心模块，用「数据概览」板块（核心指标、转化漏斗、交叉洞察与下批优先级）和最近更新让你随时掌握页面与流量状况。

左侧导航

导航为平铺的 6 个菜单项：页面管理 · 搜索表现 GSC · 监控 & 洞察 · 知识库 · 模版 · 设置。数据分析内容就在首页的「数据概览」板块，没有单独的仪表盘页面。

界面导览

截图占位 首页全貌：快速开始清单 + 三张功能入口卡片 + 数据概览（指标卡、转化漏斗、交叉洞察、下批优先级） images/home-overview.png

页面管理

「页面管理」是所有已生成 / 已发布页面的总台账：集中查看每个页面的市场、类目、状态和最近搜索表现（曝光 / CTR），完成日常维护——改状态、进编辑器、预览、查详情、删除，还能把店铺里已有的存量页面一键同步进来统一管理。

页面状态

界面导览

截图占位 页面管理列表全貌：状态页签、市场筛选、表格各列及行操作图标 images/pages-list.png

截图占位 页面详情弹窗：基础信息 + 最近 GSC / GA4 快照，底部「删除页面」与「去 Shopify 后台编辑」 images/pages-detail-modal.png

截图占位 「同步现存页面」的同步预览弹窗：将新建 / 将更新 / Orphan 三组勾选清单 images/pages-sync-preview.png

常用操作

修改页面状态（上线 / 下线）

1. 在列表「状态」列找到目标页面的下拉框。
2. 选择新状态：「草稿」「已上线」或「已退役」。
3. 系统先把状态同步到 Shopify，再更新本地记录；切到「已上线」会记录发布时间。若同步失败，下拉框会自动弹回原状态，重试即可。

同步店铺现存页面

1. 点右上角「同步现存页面」。首次使用先在「选择同步源 Metaobject」中选一个定义（只列出开启了网页发布的定义），点「保存并预览」。
2. 在「同步预览」中核对三组清单：将新建（Shopify 有、本地没有）、将更新（字段有变化，会列出变更字段）、检测到 Orphan（Shopify 已删、本地仍存在）。
3. 勾选要处理的条目，点「确认导入（N）」，完成后查看「同步完成」汇总。勾选 Orphan 只会把本地状态标为「已脱钩」，不会删除任何数据。

删除页面

1. 打开该页面的详情弹窗，点左下角红色「删除页面」。
2. 在确认弹窗中点「删除」。

AI 生成页面

「生成」页是 AI 落地页生成器：选好目标市场、痛点话题、目标场景和 4 个主推产品系列，AI 会在后台生成一个结构完整的落地页草稿。页面的输出格式与结构由系统固定，你只需要提供和确认「写什么」的参数。

界面导览

截图占位 「配置页面参数」表单全貌：目标市场、痛点方向、目标场景与产品系列选择区 images/generate-form.png

截图占位 「确认 AI 生成参数」弹窗：产品详情必填项与「✨ AI 生成」按钮 images/generate-confirm-modal.png

截图占位 后台生成进度卡片（阶段提示 + 进度条）与生成成功横幅 images/generate-progress.png

操作步骤

首次使用：同步 Shopify 产品

1. 在「主推产品系列」区域点「⟳ 同步 Shopify 产品」，从店铺拉取所有在售产品。
2. 等绿色横幅显示同步结果（拉取 / 新增 / 更新 / 停用数量），产品标签列表即可点选。

配置参数并生成

1. 选择「目标市场」。
2. 在「痛点方向」选分类，再选「具体话题」；没有合适的可选「其他（自定义输入）」手动输入。
3. （可选）选择「目标场景」、填写「页面 Slug」和「补充说明」。Slug 只能用小写字母、数字、连字符，留空会自动按 AI 生成的标题派生。
4. 点选正好 4 个产品系列（可用搜索框过滤）。
5. 点「AI 一键生成草稿」，系统拉取所选产品的实时资料并打开确认弹窗。
6. 在弹窗中核对 / 编辑参数：检查痛点话题与场景，逐个检查 4 个产品的标题和卖点描述（描述为空可点「✨ AI 生成」自动填写），需要时「添加一行」补充额外要求（如「强调宠物友好」）。改乱了点「恢复默认」。
7. 点「确认并生成草稿」，顶部出现生成进度卡片。期间可以离开页面或刷新，生成在后台继续。
8. 生成成功后点「查看页面列表」去「页面管理」审阅草稿；失败会显示原因，调整参数后可重新生成。

页面编辑器

编辑器是对单个页面做精修的全屏工作区：左侧编辑、右侧实时预览。在这里调整版块内容与顺序、修改标题和 SEO 信息、用 AI 改写局部文案，最后保存并发布到店铺前台。

界面导览

截图占位 编辑器全屏界面：顶部工具栏（保存 / 发布 / 预览 / 设备切换）+ 左侧版块列表 + 右侧实时画布 images/editor-overview.png

截图占位 版块设置面板：字段表单、内容块列表与「AI 改写」弹窗 images/editor-section-panel.png

截图占位 「页面设置」SEO 面板：标题、SEO 标题、SEO 描述与只读 Slug images/editor-page-settings.png

操作步骤

编辑版块内容

1. 在左侧版块列表点击要修改的版块（或直接点右侧画布中的对应区域）。
2. 修改文字、链接、图片等字段，右侧画布实时刷新。列表型内容（如某条 FAQ）在「内容块」区域展开后编辑，可新增、删除、拖拽排序。
3. 改完点「返回」回到版块列表，点顶部「保存」。

用 AI 改写某个版块

1. 进入该版块的设置面板，点右上角「AI 改写」。
2. 在「想怎么改？」输入框描述需求，如「语气更亲切，并提到免费配送」，点「改写」。
3. 结果直接应用到页面并提示「已应用改写——请检查并保存」；在画布检查效果，不满意按 ⌘Z 撤销，满意则「保存」。

预览与发布

1. 先点「保存」——预览链接展示的是已保存的内容，未保存的修改不会出现在预览里。
2. 点「预览」，系统在新标签页打开临时预览链接，可发给同事审阅（预览页不会被搜索引擎收录）。链接有有效期，过期后回编辑器重新点「预览」。
3. 确认无误后点「发布」，状态徽章变为「已上线」，页面即在店铺前台可访问（网址形如 店铺域名/pages/…）。需要下线时点同一位置的「取消发布」。

知识库

知识库是 AI 生成页面的「素材仓库」，集中维护五类信息：产品系列、服务卖点、内链资源、痛点话题、目标场景。痛点话题和目标场景会成为「生成」页的下拉选项，服务卖点会被生成的正文引用，内链资源会被自动嵌入页面。素材越完整，AI 生成的页面越贴合店铺实际。

界面导览

截图占位 知识库主页面：六个页签与产品系列表格（含搜索框和右上角「新增」按钮） images/knowledge-tabs.png

截图占位 批量导入页签：实体类型选择、模板下载、文件上传区与预览表格 images/knowledge-import.png

操作步骤

手动新增 / 编辑 / 删除条目

1. 切到目标页签，点右上角「新增」，在弹窗中填写表单（各页签字段不同，必填项留空会标红），点「新建」。
2. 编辑：点行内铅笔图标，改完点「保存」。
3. 删除：点行内垃圾桶图标，在「确认删除？」弹窗确认。删除无法撤销。

AI 一键生成素材

1. 当「服务卖点」「痛点话题」或「目标场景」页签为空时，点空状态中的「✨ AI 根据产品目录生成」。
2. AI 基于已同步的产品目录，一次性生成三类素材并自动导入对应页签；之后可像普通条目一样继续编辑。

一键导入站内链接

1. 切到「内链资源」页签，点「一键导入站内页面（page / blog / collection）」。
2. 系统把店铺所有已发布的独立页面、博客文章与产品系列导入为内链资源，完成后显示「已导入 X 条，更新 Y 条」。可随时重复执行，按 URL 去重更新。

批量导入（文件上传）

1. 切到「批量导入」页签，在「实体类型」下拉选择要导入的类型（每次只能选一种）。
2. 不确定格式时先点「下载模板 CSV」，按模板填写。
3. 拖入或选择 CSV / XLSX / JSON 文件（最大 2 MB），自动解析并显示「预览 N 行」；缺必填字段的行会被跳过并以横幅提示。
4. 确认预览无误后点「确认导入」，完成后显示「已导入：新增 X · 更新 Y」。

搜索表现 GSC

集中查看店铺在 Google 搜索中的表现：点击、曝光、CTR、平均排名，站点趋势，以及逐页面、逐查询词的明细表。它回答两个问题——「整体表现是涨是跌」和「哪些页面 / 关键词值得动手优化」。系统会给每个页面打「信号」标签、给每个查询词打「机会」标签并算机会分。

界面导览

截图占位 整页概览：KPI 四卡 + 站点趋势图（标注指标与时间范围切换按钮） images/gsc-overview.png

截图占位 「页面」页签：信号筛选展开 + 带信号标签的明细表 images/gsc-pages-tab.png

截图占位 「上传 GSC 导出」弹窗：日期 + 文件拖放区 + 导入成功横幅 images/gsc-upload-modal.png

操作步骤

排查需要优化的页面

1. 在明细表选「页面」页签，点「筛选」按信号过滤：选「零点击」或「低 CTR」找急需改标题 / Meta 的页面，选「Top 10 机会」找小幅优化即可上首页的页面。
2. 点击某一行打开详情弹窗，查看历史趋势和规则解释。
3. 按弹窗按钮跳转：「查看页面详情」或「去行动中心处理」。

挖掘关键词机会并生成新页面

1. 切到「查询词」页签（默认按机会分从高到低），用「筛选」选「零点击」「Top 10 优化」或「第 2 页机会」。
2. 点击某个查询词查看历史趋势，确认是否已有关联页面。
3. 若值得做专门页面，点「用此词生成页面」，带着这个词直接进入生成流程。

手动上传 GSC 数据

1. 在 Google Search Console 中：选择属性 → 「效果」→ 导出 CSV 或 Excel。
2. 回到本页点「上传 CSV」，填写数据起始 / 结束日期（即导出报表覆盖的时间段）。
3. 「Pages」和「Queries」两个 sheet 各上传一次（单文件最大 5 MB），点「上传」后查看结果横幅确认导入 / 跳过 / 未匹配行数。

监控 & 洞察

这是 Pagewise 的「行动中心」：把 GSC（搜索表现）和 GA4（站内行为）两份数据自动交叉分析，找出表现异常的页面，按「预计可挽回的点击量」排成优先级队列，每条待办都附带数据证据和一个明确的下一步动作。适合每周例行查看：先看站点整体健康，再从 P1 待办逐条处理。纯数据浏览请去「搜索表现 GSC」，这里只管「该做什么」。

界面导览

截图占位 监控 & 洞察首屏：状态行、四张 KPI 卡片与「AI 全量诊断」按钮 images/monitor-overview.png

截图占位 行动队列中一条 P1 待办：优先级与问题徽章、证据行、「AI 重写 / 预览 / 详情」按钮 images/monitor-queue-card.png

截图占位 「上传 GA4 导出」弹窗：日期选择与文件上传区 images/monitor-ga4-upload.png

操作步骤

每周例行巡检

1. 看顶部状态行和 4 张 KPI 卡，确认曝光 / 点击 / CTR 相比上一窗口的涨跌。
2. 从行动队列最上方的 P1 待办开始，读问题徽章和证据行（悬停徽章看判定规则）。
3. 按主按钮处理：「AI 重写」「查数据」或「修页面」；处理前可「预览」线上效果或看「详情」。
4. 处理完一批后回到本页，队列随数据更新自动收敛，清空时显示「✓ 队列已清空，暂无待办」。

用 AI 重写低点击率页面的标题

1. 找到带「重写标题」或「低 CTR」徽章的待办，点「AI 重写」。
2. 已配置 AI 时点「用 AI 生成」直接获得候选标题；未配置则「复制 prompt」→「打开 Claude.ai」粘贴运行。
3. 拿到满意的标题后点「修页面」打开编辑器，把标题改上去并保存；关闭编辑器后队列自动刷新。

追查某个页面的流量波动

1. 在「涨跌幅最大页面」榜单找到波动明显的页面，点「查数据」。
2. 系统跳到「搜索表现 GSC」的「页面」页签，并把该页面地址预填进搜索框——查看的是该页面自身的指标行与历史趋势。
3. 结合趋势判断是排名变化、季节性还是标题问题，再回队列执行相应动作。

模版配置

「模版配置」定义生成页面的整体外观：四种品牌颜色（主色、强调色、背景色、正文色）和标题 / 正文字体，右侧实时预览。保存后自动应用到之后 AI 生成的页面、编辑器保存结果和页面预览，无需每次生成时单独选择。

界面导览

截图占位 模版配置页整体视图：左侧模版卡片与外观编辑、右侧实时预览 images/templates-page.png

操作步骤

1. 在「模版」卡片区点击要自定义的模版，选中后显示「已选中」。
2. 在「外观」设置四种颜色（取色器或直接输入十六进制值）和标题 / 正文字体。
3. 边改边看右侧实时预览，确认效果。
4. 点「保存外观」，出现「已保存 ✓」即生效。需要重置时点「恢复默认」（仅回填表单，仍需点「保存外观」才生效）。

设置

设置页是全局配置中心：首次启用时来这里完成初始化（品牌信息、页面存储位置、Google 数据源、AI 模型），之后只在切换市场、更换模型或排查同步问题时回来。任何字段修改后，Shopify 后台顶部会出现统一保存条，点「保存」一次性保存全部修改。

设置项一览

截图占位 设置页整体：左侧说明 + 右侧四个设置卡片（通用 / Google 自动同步 / 页面存储位置 / AI 集成） images/settings-overview.png

截图占位 Google 自动同步卡片：服务账号邮箱、两个 Property ID 输入框、同步状态行与「立即同步」按钮 images/settings-google-sync.png

配置 Google 自动同步（推荐，替代手动上传）

1. 在「Google 自动同步」卡片中复制灰色框里的服务账号邮箱。
2. 打开 Google Search Console → 「设置」→「用户和权限」，把该邮箱添加为用户（只读即可）。
3. 打开 GA4 → 「管理」→「媒体资源访问管理」，把同一邮箱添加为查看者。
4. 回到设置页填写「GSC Property ID」和「GA4 Property ID」，点顶部保存条的「保存」。
5. 点「立即同步」手动拉取一次；成功提示「Google 数据已同步」，状态行显示上次同步时间。之后系统每日自动同步。

常见问题

提示「AI 未配置」，生成按钮不可用？

AI 密钥由开发者在服务器侧配置，应用内没有填写入口。联系开发者完成配置后，到「设置 → AI 集成」选择模型即可。

生成按钮一直置灰？

依次检查：产品系列是否选了正好 4 个；是否有另一个生成任务正在后台运行（同一时间只能一个）；是否出现「需要追加权限」横幅（需重新安装应用授权）。

生成的页面在店铺前台看不到？

先确认页面状态是「已上线」（草稿不对外展示）；再确认店铺使用 Online Store 2.0 主题；如果最近切换过主题，到首页点「立即修复页面」把页面模板重推到新主题。

页面里的图片是灰色的占位图？

正常现象：AI 暂不支持图片生成。除产品卡片会自动使用 Shopify 产品图外，其余版块的图片字段默认是占位图。请在页面编辑器中点对应版块，用「上传图片」或「浏览图库」换成真实图片（建议用品牌设计提供的、与页面主题匹配的素材），保存后再发布。

上传 GSC / GA4 文件提示「无匹配页面」？

文件里的 URL 必须已存在于「页面管理」中才会被记录。先到「页面管理 → 同步现存页面」把店铺存量页面拉进来，再重新上传。

KPI 涨跌徽章不见了 / 显示「暂无更早窗口可对比」？

正常现象：环比需要两期互不重叠的 28 天窗口（至少间隔 28 天）。刚接入数据时只有一期，显示「首期基线」，积累几周后徽章会自动出现。

平均排名「下降」了，为什么徽章是绿色？

排名数字越小越好（第 5 名比第 8 名好），徽章按「是否变好」着色：绿 = 变好、红 = 变差。不要只看箭头方向。

预览链接打不开或显示过期？

预览链接有有效期，过期后回编辑器重新点「预览」即可。如显示「页面不可用——该页面已不存在或尚未同步」，说明页面已被删除或还未同步到 Shopify。另请允许浏览器为本站点打开新窗口。

页面状态变成「已脱钩」是怎么回事？

说明该页面在 Shopify 端的内容条目已被删除，只剩本地记录。应用会在 Shopify 侧删除后自动标记。可以删除本地记录，或重新生成 / 同步页面。

误删了页面能恢复吗？

不能。删除是双端永久操作（同时清除 Shopify 端条目、主题模板文件和本地记录）。只想下线请用「已退役」状态。

想换页面的 URL（Slug）？

Slug 创建后不可修改（避免已收录链接失效）。确实需要换 URL 时，只能用新 Slug 重新生成页面，再把旧页面退役。