适用场景
| 场景 | 说明 |
|---|---|
| AI 客服 | 在 Shopify 店铺前台显示 AI 会话窗口，承接访客咨询 |
| 推荐问题 | 使用 GrowthOS SaaS 中配置的推荐问题，引导访客快速提问 |
| 内容同步 | 同步首页、产品、集合、普通页面和博客文章，用于 SEO/GEO 体检与优化 |
| SEO/GEO 发布 | 将审核后的 SEO/GEO 内容写入 Shopify，并由 Theme App Extension 注入到前台 |
| 多语言店铺 | 跟随 Shopify 店铺语种和当前页面语种工作 |
安装流程
- 在 Shopify 后台进入 App Store，搜索 GrowthOS。
- 点击安装，并按 Shopify 提示完成授权。
- 打开 GrowthOS。
- 在 GrowthOS SaaS 后台生成站点授权码。
- 回到 Shopify App，粘贴授权码并完成绑定。
- 在 Theme Editor 中开启 GrowthOS App Embed。
- 根据需要开启 AI Chat block 和 SEO/GEO Head block。
- 在 Shopify App 或 GrowthOS SaaS 中发起内容同步。
启用前台窗口
AI 客服窗口由 Shopify Theme App Extension 注入，不需要修改主题代码。 在 Shopify Theme Editor 中打开 GrowthOS App Embed 后，可以配置：| 配置项 | 说明 |
|---|---|
| Theme | 会话窗口主题 |
| Custom colors | 自定义主色、面板色、输入框颜色等 |
| Position | 窗口显示在左侧或右侧 |
| Avatar image | 上传客服头像 |
| Avatar URL fallback | 当不上传图片时，可使用头像链接 |
内容同步
GrowthOS 会同步 Shopify 中与 SEO/GEO 相关的页面内容：| Shopify 内容 | GrowthOS 中的用途 |
|---|---|
| 首页 | 站点首页体检与优化 |
| 产品 | 产品页 SEO/GEO 体检与优化 |
| 集合 | 分类/集合页 SEO/GEO 体检与优化 |
| 普通页面 | 关于我们、联系页、落地页等内容优化 |
| 博客文章 | 文章 SEO/GEO 体检与优化 |
SEO/GEO 发布
在 GrowthOS SaaS 中完成体检、优化和审核后，可以发布到 Shopify。 发布后：- 产品和集合支持写入 Shopify 原生 SEO 标题与描述。
- 页面和博客文章通过 Shopify 本地 metafield 保存 SEO/GEO 内容。
- SEO/GEO Head block 会在前台页面 head 中注入 canonical、robots、AI Summary、Open Graph、Twitter、JSON-LD 和 FAQ。
- 回滚时会撤销 GrowthOS 注入内容；产品和集合在有历史记录时会恢复原生 SEO 旧值。
Head output mode
Compatible DOM upsert兼容模式。GrowthOS 会在页面加载后更新并去重
description、canonical、Open Graph 和 Twitter 等 head 标签。浏览器 DOM 会看到 GrowthOS 内容，但查看页面原始源码时可能仍先看到 Shopify 或主题默认标签。
适合已经安装第三方 SEO App、主题默认 SEO 输出较多，或需要减少重复标签的店铺。
Strict source output严格源码输出。GrowthOS 会尽量把 meta、canonical、Open Graph 和 Twitter 等内容直接输出到 head 中，更容易在页面源码和 SEO 检查工具中看到。 推荐首次启用和排查注入时使用；如果出现重复标签，再切回兼容模式。 Schema compatibility 控制 JSON-LD 结构化数据和主题、Shopify 默认输出、第三方 SEO App 的兼容方式：
Schema compatibility
Merge and de-duplicate合并并去重。保留页面已有 Schema，同时移除和 GrowthOS 明显重复的 Article、FAQ、Breadcrumb 等结构化数据。推荐默认选择。 Replace page schema
替换页面 Schema。更激进，会移除页面已有同类 Schema，只保留 GrowthOS 输出。仅在页面出现明显重复或冲突的结构化数据时使用。 Append only
只追加 GrowthOS Schema，不清理页面已有 Schema。适合需要完全保留主题或第三方 SEO App 输出的特殊场景，但可能产生重复。 如果不确定，建议先选择
Strict source output + Merge and de-duplicate，发布后检查文章页或产品页；如果发现重复 meta 标签，再切换为 Compatible DOM upsert。
多语言文章发布时，GrowthOS 会优先把非默认语种内容登记为 Shopify 原生翻译，避免为同一篇内容重复创建多篇文章。请先发布默认语种，再发布其他语种。
多语言与 Markets
GrowthOS 会优先识别 Shopify Markets 和店铺已发布语种。对于常规/en、/fr 这类语言路径，会自动匹配对应页面。
如果店铺使用第三方多语言 App、子域名或自定义语言路径，可以在 Shopify App 的兼容设置中手动配置语言根路径，例如：
注意事项
- 请先在 GrowthOS SaaS 后台生成授权码，再到 Shopify App 内绑定。
- 安装 App 后，还需要在 Theme Editor 中开启 GrowthOS App Embed，前台窗口和 SEO/GEO head 注入才会生效。
- 如果更新了 App 权限，Shopify 可能要求重新授权。
- 如果店铺启用了多语言、Markets 或第三方 SEO App，建议发布后检查不同语种页面的前台效果。
- 关闭 GrowthOS App Embed 后，前台 AI 会话窗口和 SEO/GEO head 注入会停止显示。