教學｜獎項管理-兌換券 & 兌換獎項 API

💁🏻‍♀️ 可做到

• 引導 LINE 好友拜訪線下門市，並追蹤好友使用獎項狀態
• 能蒐集 LINE 好友的線下資訊，若 POS 有會員資訊並使用獎項核銷 API ，可瞬間完成會員綁定
• 紀錄 LINE 好友於線下的消費行為及數據

▶︎ 適用對象為

➤ 獎項管理-兌換券

• 所有使用 MAAC 品牌
• 有線下門市或實體活動之品牌

➤ 獎項管理-獎項核銷 API

• 須額外加購 Open API - 兌換獎項
• POS 機需能串接 API 

▶︎ 設定步驟

➤ 獎項管理-兌換券設定

1. 選擇獎項類型為兌換券後，輸入獎項名稱及獎項使用期限
2. 序號類型依照使用情境分為以下類別
   • 批量一般序號：好友收到與其他人相同或不同的序號，總數有限領完為止，如：
     • 上傳「Love100」100 組
     • 上傳「A001」、「A002」...「A100」100 組
   • 批量專屬序號：好友收到唯一的專屬序號，總數有限領完為止。可透過 OpenAPI 自動核銷、對好友貼標與綁定。
   • 固定序號：好友收到與其他人相同的序號，且序號不會被領取完畢。
   • 不使用序號：兌換頁面不會顯示序號。
3. 在序號設定欄位上傳 csv 或是直接輸入序號。
   
   
4. 如在兌獎時有 POS 機刷 barcode 需求，請開啟「條碼」按鈕，如不需刷條碼則不需勾選。
5. 開啟條碼後，需選擇條碼類型，目前支援以下 POS 機條碼格式：
   • Code 39
   • Code 128
   • PZN
   • EAN-13
   • EAN-8
   • JAN
   • ISBN-13
   • ISBN-10
   • ISSN
   • UPC-A
6. 可開啟「兌換按鈕」，門市專員也可以透過點擊按鈕來兌換獎項。
   
   
7. 可以選填設定「領取標籤」及「兌換標籤」（最多可設定 10 個標籤）
8. 可以選填設定「獎項圖片」及「規則說明文字」
   
   
9. 建立兌換券後，可以點擊成效按鈕 > 增加/ 刪除序號 > 上傳需新增的序號或是刪除要移除的序號。
   
   

➤ 兌換獎項 API 設定

Open API 串接 MAAC 與 POS，讓客戶能透過 POS 核銷 MAAC 的門市兌換券，店員輕鬆一掃即完成獎券核銷。客戶能蒐集 LINE 好友的線下資訊，包含分店、消費金額、標籤。除此之外，若 POS 有會員資訊，更可以瞬間完成會員綁定（包含會員編號、性別、電話）。

（行銷部門）

1. 選擇獎項類型為兌換券後，輸入獎項名稱及獎項使用期限
2. 序號類型必須選擇「批量專屬序號」後上傳序號
   
   
   
3. 需打開「條碼」按鈕，並選擇適用您的 POS 機條碼格式
4. 建議開啟「兌換按鈕」
5. 建議設定「領取標籤」及「兌換標籤」
6. 可以選填設定「獎項圖片」及「規則說明文字」
   🚨 注意：如果要使用獎項核銷 API，序號僅可以上傳到「批量專屬序號」，不可上傳到其他序號類型。如果使用在其他序號類型，會導致兌換時出錯。
   💡 提醒：建議避免同時按兌換按及POS機掃 barcode來兌換獎券。

（工程部門）

1. 使用 Open API - 兌換獎項
2. 品牌行銷部門事先將序號上傳至兌換券的「批量專屬序號」類型，當發送「批量專屬序號」給 LINE 好友時，系統會將序號和 LINE 好友 LINE UID 配對
3. 接著以序號為 Key 值，如打出 API 後並得到 Response success ，表示兌換成功。
4. 亦可同時將 Customer ID、Mobile、Gender、分店名稱、營收同步更新回 MAAC 後台。如果有一併更新 Customer ID，兌換成功當下即能完成綁定。
   🔑參考：請參考 MAAC Open API - 兌換獎項
   

▶︎ 成效報表

1. 點選獎項管理，可以查看獎項類型、名稱、相對應的序號、領取數量、兌換數量及營收。營收顯示如下：
   • 上傳「批量專屬序號」
     • 已啟用獎項 API：數字 或 0
     • 未啟用獎項 API：-
       
       
   • 上傳「批量一般序號」、「固定序號」、不使用序號：-
     
     
2. 點選個別獎項後，除了可以查看該獎項的上傳序號數、領取數量、兌換數量外，也可搜尋特定的序號使用狀況。
   
   

▶︎ 常見問題

➤ 獎項核銷 API 

• 網路斷線的話，如果 POS 機一樣有記錄到序號，是否可以後續比對、完成人工綁定？
  • 現場店員已手動點選「兌換按鈕」：因為該序號已被兌換，無法補打兌換獎項 API
  • 現場店員尚未手動點選「兌換按鈕」：可以事後補打兌換獎項 API
• 如果核銷時，該 LINE 好友已經有 customer id、phone、gender，系統會如何紀錄？
  • MAAC 會維持原有的資料，不會將新資料覆蓋。
• 兌換後的獎券是否可以取消兌換?
  • 兌換後及無法取消兌換，因此刷條碼務必請門市人員確認。
• 報表營收的幣值是如何決定的?
  • 店家可以自行決定要輸入的幣值，建議與 GA 相同幣值比較容易比較，如新台幣、美金等。