推薦新會員（MGM）

推薦新會員（MGM, Member Get Member）為「會員推薦會員」的行銷機制。會員透過專屬推薦連結邀請朋友加入，被推薦人加入時系統自動綁定推薦關係，達成設定的條件後推薦人即可獲得獎勵。

進入路徑

後台左側 行銷活動 → 推薦新會員（MGM）。

運作流程

第一步　既有會員（推薦人）開啟會員專區「推薦好友」頁面。

第二步　系統為該會員產生專屬推薦連結（含 ?ref= 推薦碼）。

第三步　會員透過 LINE、社群、Email 將連結分享給朋友。

第四步　朋友（被推薦人）點擊連結，會先看到後台設定的「歡迎畫面」，按 CTA 進入官方帳號。

第五步　被推薦人加入官方帳號（或進行其他綁定動作，見「分享綁定推薦人」）時，系統自動綁定推薦關係。

第六步　達到「推薦好友任務」設定的門檻人數時，發放對應獎勵給推薦人；會員端「推薦好友」頁面會即時顯示任務進度。

先分清楚兩個角色

頁面最上方有一段名詞說明，設定前請先確認：

• 推薦人＝把朋友介紹進來的既有會員
• 被推薦人＝被介紹進來的新朋友

底下每一項獎勵區塊的抬頭都會用三格標明 「發給誰 / 何時發 / 發什麼」，設定前先看這三格確認發放對象是哪一位。客戶最常搞錯的就是這裡。

設定分成 4 個頁籤

頁面上方有 4 個頁籤，點名稱切換：

基本頁籤

「基本」頁籤是設定的入口：推薦機制的總開關、獎勵何時發，以及防止自我推薦的規則。

基本設定

• 啟用推薦機制　總開關，關閉後所有推薦行為與獎勵發放都會停用。
• 獎勵觸發時機　二選一：

- 加入即發：被推薦人透過推薦碼加入官方帳號時立即觸發。簡單，但可能被刷量。 - 首次消費才發（建議）：被推薦人完成首筆消費才觸發推薦人獎勵，避免有人純為點數而註冊。

防刷選項

• 阻擋同手機自我推薦：推薦人與被推薦人手機相同時拒絕綁定（同人開兩個 LINE 自我推薦）。
• 冷卻期（天）：擋「換一支 LINE 重刷」。綁定的當下去看同一支手機底下、目前仍綁著推薦人的其他會員，只要其中有一位是在設定天數內綁定的，這次綁定就不成立。0 = 不限制。

冷卻期的幾個實際行為，設定前先知道：

• 沒有留手機的會員不受限制：沒有號碼就沒有東西可以比對。剛用 LINE 登入、還沒填過資料的會員多半屬於這種。
• 看的是目前的推薦關係，不是歷史紀錄：會員被合併掉、或在後台把某位會員的推薦人清空之後，那支手機就視同沒有被推薦過。後者正是誤綁時的救援方式。
• 只在綁定當下判斷：不會影響已經綁好的關係，也不會回頭取消任何已發出的獎勵。
• 被擋下的綁定會留紀錄：在「系統 → 操作紀錄」可以查到 referral_bind_failed。

⚠️ 2026-09-02 起這個欄位才真正生效。 在此之前它只存在於設定畫面上，後端從未讀取， 也就是說先前填了天數的商家實際上一直沒有這層保護。若貴店的設定值不是 0， 上線後推薦綁定會開始依此被擋 —— 覺得擋太多請把天數調小或設回 0。

加入禮頁籤

切到 「加入禮」頁籤，裡面有兩個區塊：全會員加入禮（所有新會員都拿）與 新好友加入好禮（只有被推薦進來的新朋友拿）。兩者都是發給新加入的人，不是發給推薦人。

新好友加入好禮（被推薦人專屬）

被推薦人成功綁定推薦人時，系統會立刻一次性發放給「被推薦人」（不是推薦人）。流程上先於下方「推薦好友任務」發生。

• 獎勵點數　被推薦人加入時拿到的點數（0 = 不發點數）。
• 贈送票券（2026-06-24 改多張支援）：可設定發放 N 張票券，每筆指定 voucher_id + quantity（例如「100 元餐飲券 ×2、9 折券 ×1」），按新增票券項目逐筆編輯。舊單張設定會自動遷移成多張結構。
• 贈送抽獎機會：可選一個 active 抽獎活動 + 寫入次數（1～50）。被推薦人就會在「我的抽獎」看到這檔活動的 N 次機會。

三項（點數 / 票券 / 抽獎機會）全空 = 不發放任何加入好禮（但推薦關係仍會綁定）。

跟「推薦好友任務」的差別： - 新好友加入好禮 → 給「被推薦人」，bind 成功就立刻發、一次性、不受「獎勵觸發時機」影響。 - 推薦好友任務（下方階梯） → 給「推薦人」，依「獎勵觸發時機（加入即發 / 首次消費才發）」決定發放時間點。 兩者獨立運作，可同時啟用做「推薦與被推薦雙方都送點數」的活動。

跟「自動行銷劇本 → 新會員加入」的差別： - 此處的「新好友加入好禮」只在被推薦人透過推薦連結加入時觸發（必須有 ?ref= 綁定成功）。 - 「自動行銷劇本 → 新會員加入」對所有新會員觸發（不限是否透過推薦）。 - 兩者可共存：純自然加入的會員只拿自動行銷劇本的入會禮；被推薦加入的會員兩者都拿。

全會員加入禮（member_join_reward，2026-06-24）

所有新加 LINE@ 的會員（不管有沒有 ref 推薦碼）一次性入會禮。

設定欄位：

• 啟用：總開關。
• 獎勵點數 / 獎勵票券（多張）/ 贈送抽獎機會：與其他獎勵區塊相同的填法。
• 推播訊息：可填純文字 message（可用 {points} {vouchers} {lottery} 變數）。
• 推送既有圖文卡片（card_id，2026-06-25）：下拉選單從「內容管理 → 圖文卡片」既有卡片中挑一張，加入禮觸發時連同點數 / 票券一起 push 一張 Flex 卡片給新會員。預設「— 不推送 —」對應不發。卡片內 {member_name} 等變數會自動代入。
• 推送既有多卡（multi_card_id，2026-06-25）：下拉選單從「內容管理 → 多卡輪播」既有多卡中挑一組，加入禮觸發時 push 一組 Flex carousel。預設「— 不推送 —」對應不發。圖文卡片 / 多卡可同時設，會依序 push（卡片在前、多卡在後）。
• 歡迎 Flex 圖卡（welcome_flex）：另一個獨立勾選。啟用後 push 一張 Flex 卡片給新會員，欄位：

- 圖卡標題　例如「歡迎加入」 - 圖卡內文　歡迎詞 - 頂部圖片網址　Flex hero 圖（建議 2:1） - CTA 按鈕文字　例如「填資料領禮」 - CTA 按鈕網址　常見：填會員資料 LIFF / 點數商城 / 圖文選單入口

推播順序（同時設多項時依序送出）：

1. 純文字推播訊息（message_text）
2. 票券 Flex carousel（依設定票券張數）
3. 推送既有圖文卡片（card_id，2026-06-25 加入）
4. 推送既有多卡（multi_card_id，2026-06-25 加入）
5. 歡迎 Flex 圖卡（welcome_flex）

頁面下方「設定總預覽」會即時顯示啟用的項目 chip（含「+ 圖文卡片」「+ 多卡」chip 提醒）。

觸發時機：3 入口完整覆蓋（2026-06-25）

member_join_reward 從任一入口進來都會發放，且有 dedup 防雙發（同會員 24 小時內只發一次，由 audit_logs 比對保護）：

1. webhook follow 事件：會員直接加 LINE 官方帳號好友（不透過任何推薦連結）。
2. bindReferrer 綁定推薦人成功（2026-06-25 補）：被推薦人透過推薦連結 / 抽獎分享 / 轉贈票券 / 轉贈點數 / 分享微網頁進來，bind 完推薦關係後立即觸發。
3. LIFF 任何頁首次 login（2026-06-25 補）：會員從圖文選單點任何 LIFF 頁（會員中心 / 票券中心 / 點數商城等）首次 LINE login，未發過加入禮則立即觸發。

為什麼要補 2 / 3？ 之前唯一入口是 webhook follow → 但很多會員從推薦連結進來會走 LIFF bind-by-line（不打 follow event）→ 加入禮沒發出。2026-06-25 補完 3 入口後理論上任何方式進系統都會收到。

邊角 case

• unfollow 回 follow：若會員之前已收過加入禮再封鎖、後解封鎖回來，不重發（audit_logs 永久 dedup）。屬預期行為。
• 救援補發：若會員真的沒收到（罕見），admin 可至「推薦新會員 → 推薦戰績」找到該會員，後台呼叫 POST /api/referral/grant-join-reward/:member_id { force: true } 強制補發（force 旗標會跳過 dedup）。
• 在「本月訊息則數」怎麼看到這些訊息（2026-09-17 起）：加入禮推出去的訊息有自己的分類，不再算在「推薦·成長值·生日」裡。

- 加入禮/歡迎：會員加好友當下立即送出的，以及後台強制補發的。 - 加入禮/歡迎（補推）：會員先從推薦連結或 LIFF 綁定、當時還不是好友，系統先記著，等他加好友後才補送的。 - 「推薦·成長值·生日」只剩推薦人領到獎勵的通知等。2026-09-17 以前的歷史則數仍全部算在「推薦·成長值·生日」，所以跨這一天比較時，推薦類看起來變少是分類改了，不是發得少。

與「自動行銷劇本 → 新會員加入」/「新好友加入好禮（被推薦人）」三者的關係： - member_join_reward → 對所有新會員觸發、與 ref 無關 - 新好友加入好禮（referee_reward） → 只對「透過 ref 進來且 bind 成功」的會員觸發 - 兩者並行：用 ref 進來的會員會同時收到兩份禮（member_join + referee） - 「自動行銷劇本 → 新會員加入」trigger 自 2026-06-22 起已停用此入口，請集中在「推薦好友設定」管

推薦獎勵頁籤

切到 「推薦獎勵」頁籤，裡面有兩個區塊，都是發給推薦人（介紹朋友進來的那位既有會員）：

• 贈送給推薦人（每次推薦立刻發）：每帶一位就發一份，人人有份。
• 推薦好友任務：累積到 N 人才解鎖的階梯獎。

兩者完全平行、可一起跑。

贈送給推薦人（每次推薦立刻發）

獨立於「推薦好友任務」之外的固定獎勵：被推薦人每綁定成功一位，推薦人就立刻拿一份。不依賴「獎勵觸發時機」、不依賴階梯任務設定，綁定成功當下無條件觸發（適合做「每帶一個朋友送 10 點」這種基礎抽成）。

區塊抬頭的三格會標明：發給誰＝推薦人（把朋友介紹進來的既有會員）／何時發＝每成功推薦一位新會員就發一次，不需累積／發什麼＝點數、票券、抽獎次數、LINE 訊息。

設定欄位：

• 啟用：總開關。
• 獎勵點數：每筆綁定發給推薦人的點數，0 = 不發點數。
• 獎勵票券：可設多張票券，逐筆指定票券與張數。
• 贈送抽獎機會：可選進行中的抽獎活動 + 寫入次數。
• 推播訊息：可選填一段文字，綁定成功時連同獎勵推播給推薦人（例如「你的朋友已加入，獎勵已入帳」）。

與推薦好友任務的差別： - 每次推薦立刻發：每綁一個固定獎，所有人都拿；類似「介紹費」。 - 推薦好友任務（階梯）：達 N 人才解鎖獎；類似「達標獎金」。 - 兩者可一起跑。例如：每人 50 點 + 達 5 人加碼 500 點 + 票券。

推薦好友任務

在「推薦獎勵」頁籤的「推薦好友任務」區塊新增 / 編輯 / 刪除階梯。區塊抬頭三格標明：發給誰＝推薦人／何時發＝累積推薦人數達到該任務門檻時／發什麼＝該任務設定的點數、票券、抽獎次數。每筆任務欄位：

• 任務名稱　會顯示在會員「推薦好友」頁的階梯卡片上（沒填會自動顯示為「達 N 人」）。
• 達 N 人觸發　門檻人數，1 起算。
• 獎勵點數　達門檻發放的點數，可為 0。
• 獎勵票券　達門檻發放的票券（可不選）。
• 贈送抽獎活動　達門檻時為推薦人寫入 N 次抽獎機會（可不選）。可指定次數 1～50 次。僅進行中（active）的抽獎活動可發放，草稿 / 已結束的活動會自動跳過不發（不影響當次點數 / 票券發放）。
• 每日抽獎次數加成（2026-09-17，可不填）　達門檻後，該推薦人之後每一天的可抽次數都多 N 次（永久加成）。與上一項「贈送抽獎活動」是兩件不同的事：那個是一次性的 N 次機會（加在活動總次數上），這個是每天都有的加成（加在當日上限上）。

- 多階同時達標只取門檻最高的那一階，不累加。例：3 人 +1、10 人 +2、20 人 +3，推到 20 人是每天 +3 次（不是 +6）。 - 只對「抽獎活動設定 → 抽獎次數限制」中勾選了「套用推薦好友每日加成」的活動生效（預設不勾），且該活動必須有設「每日上限」。 - 有任一階填了加成時，區塊下方會出現 「每日抽獎加成上限」（預設 5，可填 0～50）：不論階梯設多高，一天最多就加這麼多次，用來防止有人衝人數換到誇張次數。填 0 代表所有階梯的每日加成都不生效。 - 這一項一律以「好友加入官方帳號」即計算，不受「獎勵觸發時機」影響。選「首次消費才發」時，點數與票券要等好友消費才發放，但每日抽獎次數在好友加入當下就生效 —— 這是刻意的：加成本身是衝加好友數的誘因，門檻拉高就失去作用。若客戶詢問「為什麼有的獎先給有的後給」，答案就是這個。

• 四項獎勵（點數 / 票券 / 抽獎機會 / 每日抽獎加成）至少擇一，不可全空。
• 重複發放開關：

- 每個新推薦人都發：達門檻後每多推薦一位都會再發一次。 - 達標只發一次：達門檻當下發一次，此任務對此推薦人不再觸發。

頁面下方有「預覽」即時顯示「假設推薦 5 位朋友會累計獲得多少獎勵」，方便確認設定；有設每日抽獎加成時會另外顯示「每天可抽次數 +N」（已套用加成上限後的數字）。

按頁面底部的「儲存設定」後（這一顆同時存下四個頁籤），系統會依 達 N 人 升冪自動排序寫入，會員端「推薦好友」頁的階梯進度條會即時生效。

範例：

• 任務 1：達 1 人，每位都發 100 點
• 任務 2：達 5 人，達標只發一次 500 點 + 體驗券
• 任務 3：達 10 人，達標只發一次 1000 點 + VIP 票券 + 抽 1 次幸運轉盤

進階觸發：若需更複雜的觸發條件（如「推 10 人連續 3 個月」「指定 tag 才觸發」「組合多動作 + 推播 LINE 通知」），請至「會員管理 → 自動行銷劇本」用 trigger「會員推薦人數達到」自訂規則。本頁「推薦好友任務」是會員看得到的階梯進度來源；自動行銷劇本是 admin 端的複雜觸發補強。兩者獨立運作。

分享與畫面頁籤

切到 「分享與畫面」頁籤，裡面有兩個區塊：分享綁定推薦人（哪些行為算綁定）與 被推薦人歡迎畫面（朋友點連結進來看到什麼）。

分享綁定推薦人

勾選哪些行為發生時自動建立推薦關係（可多選）：

• 新會員加入：透過推薦連結進來並加 LINE 好友。
• 分享抽獎活動：透過推薦人分享的抽獎連結進來抽獎。
• 轉贈優惠券：收到推薦人轉贈的票券時自動綁定。
• 轉贈點數：收到推薦人轉贈的點數時自動綁定。
• 分享微網頁：從推薦人分享的微網頁進入並加好友。

被推薦人歡迎畫面

朋友點推薦連結（含 ?ref=）進來時會先看到的卡片畫面。可設定：

• 顯示歡迎畫面 開關：若關閉，被推薦人會直接跳轉到下方指定的網址。
• 關閉時要跳轉的網址：通常填 LINE 官方帳號加好友連結。
• Banner 橫幅圖片：頁面最頂端的橫幅（建議 21:9 或 3:1，留空不顯示）。
• 歡迎圖片：卡片內頂端的歡迎圖（建議 1200×630 或 4:3，留空不顯示）。
• 歡迎標題　例如「歡迎加入我們！」
• 歡迎內文　支援 HTML 標籤（<b> 粗體、<br> 換行、<a> 連結、<span style="color:red"> 樣式）。
• CTA 按鈕文字　例如「加入官方帳號」。
• CTA 按鈕連結　按下後跳轉的目標。常見為官方帳號加好友連結 https://line.me/R/ti/p/@xxx。

頁面右側有即時手機預覽，所有欄位變動會立刻反映。

被推薦人獎勵的兩種設定位置

被推薦人（新加入的會員）能在本頁 「加入禮」頁籤 → 「新好友加入好禮」區 直接設定點數 / 票券，綁定成功即發。

注意：會員管理 → 自動行銷劇本 的「新會員加入」觸發類型已於 2026-06-22 從「新增劇本」下拉移除（就是為了收斂到本頁這個唯一入口），現在無法再用它建立新劇本。2026-06-22 之前建立的舊劇本仍會照常執行、也還能編輯，但新的入會禮請一律在本頁設定。

重要差別：

• 推薦人獎勵 → 本頁 「推薦獎勵」頁籤（每次推薦立刻發 / 推薦好友任務）。
• 被推薦人獎勵（簡易，限推薦來源） → 本頁 「加入禮」頁籤 → 新好友加入好禮；僅在透過推薦連結綁定成功時觸發。
• 被推薦人獎勵（進階，所有新會員） → 2026-06-22 之前是在「自動行銷劇本」用「新會員加入」觸發設定（所有新會員都會觸發，不限是否透過推薦）。該觸發類型已不能新建，既有劇本仍照常執行。現在要對「所有新會員」做進階獎勵，請改用「被貼上特定標籤」等觸發類型搭配自動貼標。

複雜條件（如「推薦人有 VIP tag 才送」）建議走自動行銷劇本。

推薦戰績（會員端）

會員專區「推薦好友」頁面通常會顯示推薦人的累計推薦人數、累計獎勵、邀請紀錄等資訊。實際呈現以該租戶的會員端設計為準。

推薦人數計算（referral_count，2026-06-24 修正）

會員列表 / 推薦戰績頁面的「推薦人數」=members.referral_count 欄位。bump 時機改在 `bindReferrer` 成功當下立刻 +1（不再等到 tier 真的發出獎才 +1）。

修正原因：舊版「等發獎才 +1」會導致設了 tiers=[]（純用 per-bind / ma_rule）或所有 tier 被擋下時，referral_count 永遠停留在 0，會員 stats 頁面顯示「推薦人數 0」（曾有客戶租戶踩到此問題）。

副作用：bind-by-line（顧客自己點推薦連結加好友）的失敗情境（推薦碼無效、自我推薦、冷卻期內等）會留一筆 audit_logs.action='referral_bind_failed'，後台可在「系統 → 操作紀錄」查到，方便排查「客戶說我有點連結但沒綁到」。

常見問題

Q1　會員推薦了朋友但獎勵沒發放

請依序檢查：

第一　推薦機制總開關是否啟用。

第二　被推薦人是否真的透過推薦連結進來（直接搜尋加好友不會綁定）。

第三　「獎勵觸發時機」設為「首次消費才發」時，被推薦人是否已完成首購。

第四　「推薦好友任務」是否已新增對應門檻並儲存（會員端會即時顯示階梯進度）。

第五　是否被「阻擋同手機自我推薦」或「冷卻期」擋下。

Q2　可以多階梯獎勵嗎

可以。切到 「推薦獎勵」頁籤 → 「推薦好友任務」區，按「＋ 新增任務」可加 N 筆，常見配置：

• 任務 1：達 1 人，每位都發 100 點
• 任務 2：達 5 人，達標只發一次 500 點
• 任務 3：達 10 人，達標只發一次 1000 點 + 發 VIP 票券

系統會依推薦累計人數套用所有符合的任務。「每個新推薦人都發」=達門檻後每多一個新推薦都會觸發；「達標只發一次」=達標當下觸發一次後此推薦人不再觸發。

若需更複雜的觸發條件（限定 tag / 限定期間 / 多重組合），請至「自動行銷劇本」用 trigger「會員推薦人數達到」自訂規則。

Q3　可以結合線下推薦嗎

可。會員到店時：

• 店員出示會員的 QR：其他客戶掃描即可加入官方帳號並綁定該會員為推薦人。
• 會員出示自己的推薦碼 QR：其他客戶掃描加入即綁定推薦關係。

線下推薦適合餐飲、零售等有實體店面的業態。

Q4　被推薦人後續封鎖了還算成功推薦嗎

依「獎勵觸發時機」判斷：

• 加入即發：已觸發的獎勵不會自動回收，可由管理員手動處理。
• 首次消費才發：若被推薦人未完成首購，推薦獎勵不會發放。

建議採用「首次消費才發」以避免封鎖刷量。

Q5　Banner 跟歡迎圖片差在哪裡

• Banner 橫幅：頁面最頂端的紅色背景區的橫幅圖片，建議寬幅。
• 歡迎圖片：白色卡片內頂端的圖片，建議方形或長方形。

兩者可獨立設定，留空對應位置即不顯示。