跳至主要内容

匯入顧客資料（外部 API）

POST 
/ma_audience/import-audience/

透過外部 API 匯入顧客資料，全面支援會員管理功能。 此端點允許外部系統在 OmniSegment 中建立或更新顧客資訊。

主要功能：

  • 顧客資料驗證與處理
  • 多種合併鍵選項（member_sn、phone、email、line_id）
  • 支援自訂欄位
  • 標籤管理（append/replace 模式）
  • 支援多站台組織
  • 資料加密功能
  • OneAudience ID 整合
  • 非會員顧客建立

合併鍵選項：

  • member_sn：主要會員識別碼
  • phone：以電話號碼比對
  • email：以電子郵件地址比對
  • line_id：以 LINE Messenger ID 比對

標籤模式：

  • append：將新標籤附加至現有標籤（預設值）
  • replace：以新標籤取代所有現有標籤

重要說明：

  • 若未指定 merge_key，則使用組織的預設合併鍵
  • identifier_field 說明：指定用於識別會員的欄位名稱，決定 API 搜尋與關聯會員資訊所使用的欄位。若未提供 identifier_field，預設使用 member_sn。
  • 已啟用 OneAudience 的組織，'brand' 與顧客識別欄位均為必填
  • 自訂欄位必須預先在組織設定中配置
  • 非會員顧客請將 'is_headless_account' 設為 true

Request​

Responses​