HIKO Wish Keeper

需要两件事：主题里的 app embed 要打开，而且 app 设置里的愿望清单功能要启用。

第一步 —— 启用 app embed

1. 在 Shopify 后台打开 HIKO Wish Keeper
2. 点页头的 「在主题中启用」 按钮 —— 它会打开主题编辑器，并且已经选好这个 app embed
3. 确认开关是打开的，然后在编辑器里点保存

第二步 —— 在 app 设置里启用愿望清单

1. 回到 HIKO Wish Keeper 的设置页
2. 在商品页下方，打开「在商品页启用愿望清单」
3. 在商品列表页下方，打开「在商品格启用愿望清单」
4. 点保存

两步做完之后，愿望清单按钮会自动出现在店面上，不需要改任何主题代码。

app embed 是「什么都没出现」最常见的原因。这个 app 画在你店面上的每一样东西 —— 收藏按钮、账户页、分享页 —— 都由那一个 embed 加载。

可以。到 HIKO Wish Keeper 的设置打开「需要登录」。打开之后，未登录的访客完全不会加载愿望清单，连按钮都不会出现。

如果你希望访客也能收藏，就让它关着。访客的清单存在他自己的浏览器里，第一次登录时会并入他的账户，所以他收藏过的东西不会丢失。

洞察页提供完整的分析，帮你了解顾客行为：

• 查看所有有愿望清单的顾客，以及他们收藏的商品
• 看出全店最多人收藏的商品
• 追踪通知的送达率、打开率与点击率
• 按平台监看社交分享活动（Facebook、Twitter、Pinterest、WhatsApp、LINE）
• 分析商品浏览模式与热门趋势
• 追踪订单草稿的转化与收款状态
• 每日与每周的活动比较
• 将顾客 email 与愿望清单数据导出成 CSV

账户页是顾客在你店面上找到这个 app 为他保存的一切的单一位置。它的网址是 /apps/hwl/account，由标签页组成：他的愿望清单，以及登录之后的订单、地址、个人资料、通知设置与订单草稿。

它默认是开启的。你可以在 账户页 > 账户页下方关掉它；关闭期间那个网址不再工作，店面上也不会有任何链接指向它。

账户页是由 app embed 画出来的，跟愿望清单按钮需要的是同一个。embed 没开的话，顾客到得了那个网址，但看到的是一句「仍在加载」的提示，而不是他的账户。

两种都支持，而且不需要做任何设置。这个 app 不会问你的商店用的是哪一版。

原因在于账户页住在哪里。它是你自己 storefront 上的一张页面（/apps/hwl/account），由你的主题绘制 —— 不是 Shopify 托管的客户账户区里的页面。它通过主题读取已登录的客户、他的订单与地址，做法跟任何一张模板完全一样，而那些在两版之下行为相同。

登录也是两版都通。app 发出的登录链接指向 /customer_authentication/login，Shopify 会按你商店使用的版本把客户送到正确的登录界面，完成后再把他带回原本的位置。

有一个差异，而那是 Shopify 的限制、不是我们的。在新版客户账户之下，Shopify 托管的账户页无法显示任何来自主题应用的内容，所以愿望清单在那里没有入口。这就是为什么 app 会把主题 header 上的账号图标改送到账户页。在旧版客户账户之下，那个图标仍然会前往 Shopify 自己的账户页（那边一切正常），客户则通过心形图标或你自己添加的任何链接进入账户页。

到 账户页 > 标签页。每个标签页有自己的开关、自己的图标，而且可以用上下箭头调整顺序 —— 你排的顺序就是顾客看到的顺序。

标签页有个人资料、地址、愿望清单、订单、订单草稿与通知设置。除了订单草稿与通知设置需要付费方案之外，其余默认都是开着的。

两条规则值得知道：

• 除了愿望清单之外，每个标签页都需要顾客登录。未登录的访客只看得到愿望清单，不管你开了哪些。
• 关掉一个标签页只是把它从顾客眼前藏起来，不会删除任何东西 —— 再打开，数据都还在。

全部在 账户页下方，旁边有实时预览，改什么就跟着变：

1. 外观 —— 四种版式任选：侧边栏、标签页、仪表板（磁贴格）或折叠
2. 配色 —— 浅色、深色、暖色或自动（自动会跟着访客自己的系统设置）
3. 品牌色 —— 用在按钮、链接与当前标签页上。在深色配色上会自动提亮，以免深色的品牌色整个消失
4. 自定义 CSS —— 设置没覆盖到的部分；它只作用在账户页里面

可以，需要付费方案。到 账户页 > 标签页，展开个人资料，然后新增字段。每一个可以是文本框、你自定义选项的下拉菜单、日期，或复选框。

顾客填的答案以 metafield 存在 Shopify 的顾客上，所以你可以在 Shopify Flow、客户细分或主题里使用它们。那一页的你的字段存在哪里面板会列出每一个字段确切的 namespace 与 key。

新增之前有三件事要知道：

• 字段类型之后改不了。 这是 Shopify 的限制。一开始就选对；要换类型只能新增一个字段。
• 移除字段只是把它从表单上拿掉。 顾客已经填过的答案留在 Shopify 里，definition 也还在。这是有意的 —— 一次误点不该抹掉全店的顾客数据。
• 免费方案仍然可以编辑与移除既有字段，只是不能新增。

店面页头那颗心形，会把顾客带到他真的看得到自己清单的地方：

• 未登录 —— 独立的愿望清单页
• 已登录，而且愿望清单标签页开着 —— 账户页，直接开在愿望清单那一格
• 已登录，但愿望清单标签页关着 —— 独立的愿望清单页

如果你把愿望清单设成弹窗或侧滑，那颗心形会保持原本的行为，不会跳转。

在 账户页 > 登录之后三选一：账户页（默认）、首页，或你自己指定的页面。

选自己指定的话，请输入以斜杠开头的路径，例如 /pages/members。完整网址会被拒绝 —— 登录跳转只接受你自己店里的路径，而被拒绝的值会安静地退回账户页。

这个设置对每一个登录入口都生效，包含主题页头的账号图标。

HIKO Wish Keeper 只有一个付费方案，可以按月或按年计费：

• 免费 —— 完整的愿望清单功能，全店的清单与收藏数量都不限，另外还有洞察分析与社交分享
• Professional —— 每月 $6.99 或每年 $62。另外加上邮件通知、API 访问、订单草稿与收款，以及账户页的自定义个人资料字段

付费方案含 7 天免费试用。随时可以从升级页升级。

不会。Shopify 会自动按比例计算，把你当前方案未使用的部分抵扣到新方案上，你只需要补差额。

从月付换成年付时，月付周期剩下的天数会抵扣年费。例如月中换成年付，没用完的那半个月会从年费里扣掉。

这整件事由 Shopify 的计费系统处理，你不需要做任何事。

7 天试用结束时，Shopify 会发信请你确认这笔定期扣款。系统不会自动扣款 —— Shopify 要求你明确确认之后才会收费。

你确认的话，订阅会无缝接续。两天内没有确认的话，方案会降回免费版，付费功能在你重新订阅之前不能使用。

之后随时可以从升级页重新订阅。降级不会造成任何数据丢失 —— 你的清单、自定义字段与设置都还在。

按钮在你店面上长什么样子，完全由你决定。全部在设置页：

1. 到 设置 > 全局样式 更改图标形状、颜色与大小
2. 分别调整启用色（已收藏）与未启用色
3. 设置动画效果：脉动、弹跳或无
4. 调整图标尺寸与线条粗细
5. 用实时预览面板边改边看

可以，商品列表页与商品页都能各自指定：

1. 商品列表页：选择位置（右上、左上、右下、左下）与边距
2. 商品页：选择显示模式 —— 「图片叠加」或「标准按钮」
3. 按钮位置：加入购物车旁、价格下方，或自定义位置
4. 按钮样式：「图标 + 文字」或「仅图标」

这个 app 内置 15 种语言的翻译：英文、繁体中文、简体中文、日文、韩文、德文、法文、西班牙文、意大利文、葡萄牙文、俄文、越南文、泰文、阿拉伯文与希伯来文。顾客会看到与自己浏览器相符的那一种，你不需要做任何事。

翻译页是用来改用词的，不是用来加语言的：

1. 从导航进入翻译页
2. 从下拉菜单选择默认语言
3. 修改任何你想换个说法的按钮文字、消息或清单名称
4. 点保存

你可以用自定义翻译加入任何语言：

1. 进入翻译页
2. 点「新增语言」
3. 输入语言代码（例如韩文是 ko、德文是 de）
4. 翻译每一个文字字段 —— 按钮文字、提示消息、清单名称、弹窗文字等等
5. 点保存

只要顾客浏览器的语言符合你输入的代码，就会使用你的自定义翻译。顾客看到的每一个词都由你掌控。

顾客可以用一个专属链接，把任何自定义清单分享给亲友：

1. 打开愿望清单页并选择一个自定义清单
2. 点「分享」按钮复制可分享的链接
3. 把链接发给任何人 —— 对方不需要账号就看得到
4. 分享页会显示所有条目，含商品细节与价格

每个自定义清单都会自动取得一个专属的分享 token。默认的「我的收藏」与「稍后再看」也可以分享。

可以。打开分享链接的人能订阅它：

1. 打开朋友发来的分享链接
2. 点「订阅」把那份清单加进自己的愿望清单页
3. 订阅的清单会和自己的清单并列
4. 清单所有者的变更会自动反映给订阅者

顾客可以把收藏的商品分享到社交平台：

• Facebook —— 分享商品含图片与描述
• Twitter / X —— 发布含商品链接的推文
• Pinterest —— 收藏商品图片
• WhatsApp —— 用消息发送商品链接
• LINE —— 通过 LINE 分享
• Email —— 用邮件发出商品链接
• 复制链接 —— 把商品网址复制到剪贴板

在 设置 > 社交分享 启用。可以选择要显示哪些平台，并自定义分享消息模板。

自动通知顾客：他收藏的商品降价了。

1. 进入 通知 > 设置
2. 启用「降价通知」
3. 设置降价门槛（任何降价、百分比或金额）
4. 设置检查计划（每小时、每天等）
5. 已选择接收通知的顾客会自动收到邮件

补货通知只在商品从缺货变成有货时才发出。app 第一次记录一个商品的库存状态时有意不发 —— 否则你安装的那天，每一位顾客都会收到一封。

设置你的邮件服务商，才能开始发送通知：

1. 进入 通知 > 设置
2. 选择邮件服务商：Resend、SendGrid、Brevo 或自定义 SMTP
3. 输入 API 密钥与发件人信息
4. 用「发送测试邮件」确认设置正确
5. 启用你要发送的通知类型
6. 设置自动检查的计划

最容易上手的是 Resend，可以在 resend.com 取得免费 API 密钥。

可以，做出符合你品牌的邮件：

1. 进入 通知 > 模板
2. 选择通知类型（降价、补货等）
3. 选择模板的语言
4. 编辑邮件主题
5. 用你的品牌与内容自定义 HTML 正文
6. 加上纯文本版本，给不支持 HTML 的邮件客户端
7. 使用 {{product_title}}、{{new_price}}、{{product_url}} 等变量带入动态内容
8. 保存前先预览

用 AI 辅助功能可以快速生成专业的邮件模板！

订单草稿让你用顾客收藏的商品，代为创建订单。这是付费方案的功能：

• 直接从顾客的收藏条目创建订单草稿
• 发收款单给顾客，让他完成付款
• 追踪状态：草稿、已发出、已打开、已点击、已完成
• 随时取消或删除订单草稿
• 在订单草稿页查看所有草稿与各自的状态

在账户页的订单草稿标签页。到 账户页 > 标签页把它打开 —— 它默认是关的，因为它需要付费方案。

顾客会看到你发给他、还没付款的每一张收款单，可以点进去付款，也可以取消。你发出的收款邮件也会直接链到那里。

旧版的 app 曾经提供主题区块让你手动加到编辑器里。那些已经移除了 —— 账户页的标签页取代了它们，你不需要在主题里加任何东西。

在 HIKO Wish Keeper 的订单草稿页创建：

1. 进入订单草稿页，浏览或搜索顾客
2. 点一位顾客，查看他收藏的商品
3. 用复选框选择要纳入的条目
4. 点 「创建订单草稿 (N)」，N 是你选的条目数
5. 在弹出的窗口里，可选择设置折扣（百分比或固定金额）、库存保留时间与订单备注
6. 点「创建」查看含价格明细的订单摘要
7. 点「确认」创建草稿，或点「确认并发送」创建后立刻把收款单发给顾客

顾客会收到一封含结账链接的邮件。所有状态（草稿、已发出、已打开、已点击、已完成）都可以在订单草稿页追踪。

订单草稿需要 Professional 方案（每月 $6.99 或每年 $62）。

按钮没出现的话，依序检查：

• 确认 设置 > 商品页 或 商品列表页 的功能已启用
• 确认主题编辑器的 App embeds 里，这个 app 的 embed 是开着的
• 确认设置里的「需要登录」没有打开 —— 打开时，未登录的访客不会加载愿望清单
• 清除浏览器缓存并刷新
• 确认你的主题支持 app block（Online Store 2.0 主题）
• 用无痕窗口试一次
• 问题持续的话，联系支持

账户页是由 app embed 画出来的。顾客看到一句「仍在加载」的提示，表示 embed 没开：

1. 点 app 页头的「在主题中启用」
2. 确认开关是打开的，然后在编辑器里点保存

如果那个网址返回的是「找不到」，那是账户页本身被关掉了 —— 到 账户页 > 账户页重新打开。

邮件没送达的话，检查这几个常见原因：

• 确认 通知 > 设置 里的服务商 API 密钥正确
• 确认发件人地址已在你的邮件服务商那边完成验证
• 确认顾客确实选择了接收通知
• 到 洞察 > 通知 标签页查看通知记录里有没有错误
• 发一封测试邮件确认设置可用
• 到邮件服务商的后台查看退信或投递问题

我们很乐意协助：

• 技术问题请发到 [email protected]
• 使用 app 内的支持按钮直接留言
• 在这份 FAQ 里寻找常见问题的解答

在 Authorization 头部以 Bearer token 带上你的 API 密钥：Authorization: Bearer your_api_key。密钥可以在 API 集成页生成。

数字 ID（例如 1234567890）或完整的 Shopify GID（例如 gid://shopify/Customer/1234567890）都可以，所有端点两种都接受。

使用标准的 HTTP 状态码：

• 200 - 成功：请求顺利完成
• 400 - 请求错误：参数无效或缺少必填字段
• 401 - 未授权：缺少或无效的 API 密钥
• 404 - 找不到：资源不存在
• 429 - 请求过多：超过速率限制
• 500 - 服务器错误：我们这边出了问题

列表类端点接受 page 与 limit 查询参数。响应里的 pagination 对象会告诉你当前页数、总页数与总条数，让你走完大量结果。

可以。在 API 集成页设置一个 webhook 网址，愿望清单有事件发生时 app 会 POST 过去，你就不需要轮询。