MAAC 提供 OpenAPI 介面,協助品牌可透過 MAAC OpenAPI 發送訊息,或將 LINE 訊息推播整合至各大自動化行銷平台(如 Emarsys、Insider)。品牌可透過 API 傳送個人化訊息,包含購物提醒、生日優惠、活動邀請等,提升自動化溝通效率。
MAAC 進一步支援 自動將 API 傳送訊息中的參數化 URL 轉換為 maac.io 短連結,以強化訊息點擊追蹤與成效歸因分析。
功能亮點
- 支援多平台整合:可搭配各種自動化行銷平台使用,如 Emarsys、Insider、Salesforce Marketing Cloud 等
- 簡化開發流程:透過 API 傳入參數,即可自動觸發 LINE 推播
- 支援短連結轉換:訊息內容中若包含 query string 或動態參數的 URL,系統將自動轉換為 maac.io 短連結
- 強化報表整合:短連結將綁定對應 Template ID,確保點擊數據正確歸屬於發送內容
運作邏輯
| 項目 | 系統行為說明 |
|---|---|
| 傳送方式 | Send Message API / Send-multicast-message API |
| 偵測條件 | 系統會自動偵測訊息內的 URL,若為參數化 URL(包含變數或 query string)且非 maac.io,將進行短連結轉換 |
| 轉換條件 | 每次訊息傳送皆建立新短連結,即使 URL 相同,也會因參數不同而轉換 |
| 排除條件 | 已為 maac.io 格式的短連結將不會重複轉換 |
| 報表連動 | 短連結將綁定訊息所使用的 Template ID,支援後續報表點擊統計 |
設定教學|如何整合 MAAC OpenAPI 傳送 LINE 推播訊息
Step 1:啟用 OpenAPI 功能
請聯繫漸強實驗室 CSM 確認您的方案是否已開啟 MAAC OpenAPI 權限。
Step 2:取得 Access Token
登入 MAAC 後台:https://maac.cresclab.com
前往 API > 取得 API token,點擊【取得 token】即可產出 Access Token。
Step 3:建立訊息範本(Message Template)
- 在 MAAC 建立要發送的 LINE 訊息內容,支援文字、按鈕、圖片與參數變數
- 每組訊息內容皆對應唯一的 Template ID
📘 參考教學: 教學|訊息範本庫
Step 4:於行銷平台設定串接內容
將 Access Token 與 Template ID 提供給品牌 IT 夥伴或設定至所使用的行銷平台中(如 Emarsys、Insider),並依需求傳送參數化內容(如 coupon code、活動網址等)。
系統將自動轉換為短連結,並完成訊息推播。
📘 MAAC OpenAPI 文件:https://cresclab.docs.apiary.io/#reference/3
常見問題(FAQ)
Q1:哪些情況下 URL 會被轉換為短連結?
A1:只要訊息內容中包含帶有 query string 或參數的 URL,且非 maac.io 格式,系統會自動轉換為短連結。
Q2:是否每次傳送相同的 URL 都會建立新短連結?
A2:是的。系統會根據實際傳送內容生成新的短連結,即使 URL 相同,只要包含不同參數或變數,也會建立不同短連結。
Q3:若我手動貼上 maac.io 短連結,會被再轉換嗎?
A3:不會。系統會跳過已是 maac.io 開頭的短連結,避免重複轉換。
Q4:我可以在哪裡看到短連結的點擊數據?
A4:短連結會綁定訊息的 Template ID,相關點擊數據可於 MAAC 的訊息成效報表中查詢。
https://maac.cresclab.com/apibroadcast
報表的連結明細會列出每一條短連結各自的成效:
- 點擊數:先前固定顯示為 0,現已改為顯示實際點擊次數。
- 新增「不重複點擊數」與「加入購物車商品」兩個欄位。不重複點擊數由 MAAC 依短連結點擊紀錄計算,不需串接 GA。
- 連結明細會列出訊息中的所有短連結,包含尚未有人點擊者。
OpenAPI 的介面與串接方式不變,本次僅調整報表的數據來源與呈現。
👉 各項指標的計算方式與數字變動原因,請參考:常見問題|不重複點擊的數字為何改變?
Q5:是否支援非 LINE 渠道的訊息也進行短連結轉換?
A5:目前僅支援透過 OpenAPI 傳送的 LINE 訊息,其他渠道(如 SMS)暫不支援自動轉換。