SmartPush 現已支援串接 Open API，店家可從外部系統（如第三方 CRM、自架網站或其他平台）回傳用戶資料與自訂事件。
連接外部資料至 SmartPush 後，您可以：
依據自訂事件啟動自動化流程
透過自訂屬性與事件條件篩選目標受眾
基於整合資料，打造跨平台的精準行銷活動
|
＊注意:
|
目錄
SmartPush Open API 的重要性
許多店家同時使用多套資料系統，例如 CRM、自架網站或外部行銷工具。若這些系統之間無法互通，資料就會被分散在不同位置，難以進行統一分析與整合營運。透過 SmartPush Open API，您可以將多平台資料整合至 SmartPush，並帶來以下優勢：
- 依據自訂事件啟動自動化流程
- 使用匯入的屬性來篩選與分析客群
- 取得更深入的顧客洞察，打造更個人化的行銷策略
使用方式
| 方式 | 說明 |
| 1. 新增開發者權限 | 店長需先授權用戶帳號「開發者」權限，開發者即可前往 SmartPush 後台「設定 > 數據 & 其他 > API 金鑰」取得 API 金鑰。 |
| 2. 新增聯絡人自訂屬性 | 開發者可透過「Profile API」建立或更新聯絡人資訊，並新增聯絡人屬性（如會員等級、來源平台）。 |
| 3. 新增自訂事件與事件屬性 | 開發者可透過「Custom Metric API」建立或更新自訂事件或事件屬性（如報名網路研討會、線下購買）。 |
| 4. 篩選聯絡人自訂屬性 | 所有具備權限的用戶皆可在分眾群組中使用這些屬性，建立電子郵件、簡訊或自動化任務的分眾群組。 |
| 5. 依自訂事件設定自動化任務 | 您也可以將回傳的事件作為自動化的觸發條件，並搭配聯絡人屬性，打造更精準的行銷流程。 |
＊舉例：
某店家將自架網站的顧客行為回傳至 SmartPush，用於發送個人化的購後關懷郵件。
某店家將外部行為資料（例如 App 使用情況或活動參與紀錄）回傳至 SmartPush，並以此觸發後續的精準行銷活動。
如何設定並使用 SmartPush Open API
步驟一：授權開發者權限
- 前往 SmartPush 後台，點選右上角商店名稱進入「商店管理 > 商店權限管理」頁面，點選「新增授權用戶」 按鈕，於彈窗中「身份」欄位選擇「開發者」。權限管理相關資訊請參考：了解如何授權用戶共同管理。
- 在左側目錄中選擇「設定 > 數據 & 其他」頁面，於「API 金鑰」中點選「複製」。
| ＊備註：僅「店長」及「開發者」身份的帳號可查看「API 金鑰」，其他身份的帳號將顯示權限不足的提示。 |
步驟二：透過 Profile API 更新聯絡人與屬性
- Endpoint（API 端點）： POST /createContact
- 用途： 建立或更新聯絡人資料或屬性。
- 限制：
- 支援字元類型： 字串（String）、整數（Integer）、小數（Float）、布林值（Boolean）、日期（Date）
- 命名規則： Email 不區分大小寫，其他字元區分大小寫。
- 每個商店最多可自訂 20 個自訂屬性（預設以 cus_ 為前綴）。
| ＊備註：姓名、電話、地址、身分證字號等敏感個人資料將自動加密。 |
步驟三：透過 Custom Metric API 更新自訂事件
- Endpoint（API 端點）： POST /createCustomMetric
- 用途： 建立新的事件類型與事件屬性，用於追蹤行為數據。
- 限制：
- 每個商店最多可建立 50 個自訂事件。
- 每個事件最多支援 20 個事件屬性。
- 重複的 EventCode 將無法建立。
步驟四：在 SmartPush 中查看與管理資料
- 聯絡人
- 於「聯絡人 > 自訂用戶屬性管理」頁面可查看自訂屬性。
- 於「分眾群組」頁面新增篩選條件時，依照「基本屬性 > 自訂」屬性建立群組。
- 於「分眾群組」頁面新增篩選條件時，依照「其他 > API 標籤」屬性建立群組。
- 數據分析 > 數據指標
- 於「數據分析 > 數據指標」中查看 API 事件。
- 查看事件狀態（待同步／同步中／已暫停）。
- 編輯或刪除不再使用的事件與屬性。
- 自動化
- 選擇「事件觸發 > API 觸發器」作為觸發事件。
- 依據「用戶屬性」或「事件屬性」設定過濾條件。
- 舉例：當回傳「線下購買」事件時，觸發電子郵件發送。
注意事項
- 每個商店最多可新增 20 個自訂用戶屬性及 50 個自訂事件。
- 已刪除的屬性或事件將自動從相關的分眾群組與自動化任務中移除。
- 回傳的資料僅儲存於 SmartPush 中，不會同步至 SHOPLINE 商店顧客列表。
- 為保障個人隱私與安全，SmartPush 會自動加密所有包含個人資訊的內容（如信箱、電話、地址等）。
評論