會員等級

會員等級為將會員區分為不同層級的功能，可用於差異化推播、權益設計、優惠提供，是建立會員忠誠度的核心工具。

進入路徑

後台左側 會員管理 → 會員等級。

等級規劃建議

常見的等級設計為 3 至 5 層：

基本制（3 層）　例如「銅卡」「銀卡」「金卡」，適合初期經營，規則簡單會員容易理解。

進階制（4 層）　例如「一般」「銀卡」「金卡」「VIP」，可清楚區分目標客群。

完整制（5 層以上）　例如新增「白金」「鑽石」，適合大型品牌或長期經營的客戶。層數過多會員難以辨識，不建議超過 5 層。

建立等級

點右上 新增等級，填入以下欄位：

名稱　會員端可見的名稱（例如「金卡會員」）。

最低點數　達到此點數即套用此等級。

最低消費　達到此累積消費金額即套用此等級。

折扣率（%）　100 = 原價、90 = 9 折、85 = 85 折，依此類推。

排序　數字小者排前面，會員等級的排序依此欄位決定。

成長值　搭配「會員等級參數」使用，可作為自訂的升級門檻指標。

對應圖文選單　可選擇一個本地圖文選單，會員進入此等級時自動套用該選單。

顏色　會員列表上的等級色條與標示色。

等級操作

每筆等級右側按鈕：

編輯　修改所有欄位。

刪除　刪除此等級（注意：若仍有會員持有此等級，刪除前請先到會員詳情頁將他們調整至其他等級）。

等級套用時機

會員等級的判定與套用會在以下時機運作：

• 完成消費 / 點數異動時，後端會依「會員等級參數」設定的規則重新計算。
• 成長值累計達門檻時自動升級（2026-06-24） — 詳見下方「成長值自動升等」。
• 管理員於會員詳情頁手動下拉切換等級。

詳細的升級規則（依點數 / 消費 / 成長值）請於 會員管理 → 會員設定 →「會員等級參數」分頁 設定。

成長值自動升等（2026-06-24）

「成長值（growth_value）」是獨立於點數 / 累積消費的第三條升等指標，避免「點數可被兌掉導致降等」「累積消費含退款不準」這兩個老問題。每位會員的 members.growth_value 累計只增不減，達到等級設定的門檻就自動升等（monotonic：只升不降）。

開關與比率設定

到 會員管理 → 會員設定 →「會員等級參數」分頁（或 admin API PUT /api/settings/growth_value_config），可開啟並設定累計轉換率：

• 啟用成長值累計：總開關。關閉後系統照舊「點數 + 累積消費」判等級。
• 消費 → 成長值轉換率（consume_grant）：每消費 1 元送 N 點成長值（例如填 1 = 1:1、0.5 = 2 元 1 點）。
• 推薦 → 成長值轉換率（referral_grant）：每成功推薦 1 位送 N 點成長值（例如填 100 = 每位推薦人加 100 成長）。

注意：動 consume_grant 是套利點（提高 → 客戶升等變快、降低 → 變慢）；動 referral_grant 等於改推薦激勵強度，建議至少觀察一個週期再調。

等級門檻設定

每個等級「成長值」欄位填升等門檻（例如：銀卡 1000、金卡 5000、VIP 20000）。會員成長值達到該門檻時自動套用該等級。

演算法：每次成長值入帳後，系統取「成長值 ≤ 新總值 中、threshold 最大的 level」，若該 level 比目前 level 高就升等；永遠不降等（避免退款 / 退貨打亂體驗）。

觸發成長值入帳的事件

每筆成長值入帳會寫 audit_logs.action='growth_value_granted'，後台可在「系統 → 操作紀錄」查到完整歷史（含 trigger_growth_value / threshold / before_level / after_level）。

會員詳情頁顯示

點開會員 → 主資料卡會看到「成長值 1280 / 下一階 5000」進度條（settings 開啟時才顯示），方便客服回答「我還差多少升 VIP」。

等級與其他功能整合

圖文選單　建立等級時可選「對應圖文選單」，會員進入此等級時自動套用。

點數倍率　可於 會員管理 → 會員設定 →「會員集點參數」分頁 為不同等級設定不同的點數倍率。

票券限制　建立票券時可指定僅限特定等級兌換（透過 API / 自動行銷劇本）。

自動行銷劇本　劇本的篩選條件可依等級指定。

常見問題

Q1　會員消費達標但等級沒升

請依序檢查：

第一　該等級的「最低點數 / 最低消費」是否設定正確。

第二　會員實際的點數 / 累積消費金額是否真的達到門檻（可於會員詳情頁確認）。

第三　會員管理 → 會員設定 →「會員等級參數」分頁 的升級規則是否有啟用、是否符合預期。

Q2　可以讓會員自己選擇等級嗎

不行。等級為依後台規則計算而得，會員無法自主切換。

Q3　如何手動將某會員升為 VIP

於 會員管理 → 會員列表 找到該會員，點開個人頁面，於「等級」下拉選擇目標等級即可。

Q4　刪除等級會發生什麼事

若該等級仍有會員持有，建議先到 會員列表 將那批會員調整到其他等級再刪除，否則他們的等級顯示會變空。