UGOMK 操作手冊
05 章 / 共 18

解鎖權限

「解鎖權限」把 CRM 內的資源(票券、課程、貼文分類 / 標籤、勳章、自訂資源)綁定到「達到 Level N 之後才能看到 / 領取 / 折扣」的規則。搭配 Level 曲線後,會員升等就會自動看到新內容,達成長期黏著。

進入路徑

後台左側 社群 & 遊戲化 → 解鎖權限

列表欄位

欄位說明
Level需要達到的等級(Lv.N badge)
資源類型voucher / course / post_category / post_tag / badge / custom
資源 ID對應資源的 id(票券 id / 課程 id 等)
解鎖動作view(解鎖檢視) / auto_grant(自動發放) / discount(折扣)
啟用is_active toggle,關閉 = 規則不生效
建立時間created_at

三種 unlock_action

動作說明適用情境
view(解鎖檢視)會員 Level 達標後,該資源在 LIFF 才可見;未達標會被過濾掉隱藏菜單、VIP 貼文分類、進階課程
auto_grant(自動發放)會員達到該 Level 時,後端回傳 unlock_action='auto_grant' 通知前端,由前端 / 行銷劇本 決定後續 grant 動作(如發送票券);後端本身不直接執行 grant,需搭配對應的 ma_rules 或 LIFF 流程實作升等禮、里程碑獎勵
discount(折扣)會員 Level 達標後購買該資源享優惠(折數放在 action_config高等會員折扣、老饕會員價

新增規則

點右上「新增解鎖」→ 填欄位:

Level(必填) 該規則要在哪個等級解鎖,數字 1-20。

資源類型 從下拉選 6 種:

  • voucher 票券
  • course 課程
  • post_category 貼文分類
  • post_tag 貼文標籤
  • badge 勳章
  • custom 自訂(後端 helper 決定怎麼判定)

資源 ID(必填) 填該類型的 uuid(可從對應模組的列表複製)。

解鎖動作 三選一(見上表)。

動作設定(action_config) JSON 物件,格式視 action 而定:

  • view{} 即可
  • auto_grant{ "quantity": 1 }(發幾張 / 幾份)
  • discount{ "percent": 10 }(打幾折)

啟用 勾選 = 立即生效。

篩選

上方 Toolbar 可依 Level / 資源類型 / 啟用狀態篩選,方便快速找到某個等級或某類資源的所有規則。

刪除

列表右側「刪除」→ 二次確認 → 立即移除規則。歷史已 auto_grant 的資源不會被撤回(例如已發出的票券還在會員手上)。

LIFF 端行為

會員進 LIFF 時後端依 member.level 判定:

  • 未達 Level → 該資源不顯示(view)/ 不 grant(auto_grant)/ 不打折(discount)
  • 達 Level 當下 → 若 auto_grant,後端回傳 unlock_action='auto_grant';實際 grant 動作(寫入票券 / 推播)需由前端流程或搭配的 ma_rules 完成
  • 後續進場 → view / discount 規則每次讀時判定,不需重算

常見問題

Q1 規則刪掉後,已發出的票券會被撤回嗎

不會。auto_grant 是「當下 grant 一筆到會員」,之後刪規則只是不再發新的,歷史 grant 保留給會員使用。

Q2 同一資源可以設多個 Level 規則嗎

可以。例如 voucher_abc 在 Level 3 用 view(先看到)、Level 5 用 discount(買打 9 折)、Level 8 用 auto_grant(直接送一張),三條規則並存。

Q3 降 Level(Phase 2 之後)會不會收回 view 權限

Level 系統 monotonic(只升不降),不會發生「原本 Level 5 掉回 Level 3」的情境。所以 view 一旦解鎖就一直看得到,不會回收。

Q4 custom 資源怎麼用

custom 給進階場景:需要 backend 客製判定邏輯(如「解鎖某段影片 + 打卡積分 double」)。若您需要 custom 解鎖,請聯繫客服協助配置。

Q5 action_config 的 JSON 寫錯會怎樣

前端會擋(action_config 不是合法 JSON toast);後端讀取時若某欄位缺會回退到預設值(例:discount 沒填 percent 就當 100 = 不折)。

其他問題協助

若遇本說明未涵蓋的問題,請透過後台右下角 LINE 客服 @ugomk 聯繫真人專員協助處理。