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 過去，你就不需要輪詢。