メインコンテンツまでスキップ

顧客データインポート（外部 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 メッセンジャー ID ベースの照合

タグモード：

  • append：既存のタグに新しいタグを追加（デフォルト）
  • replace：既存のすべてのタグを新しいタグで置き換え

重要な注意事項：

  • merge_key が指定されていない場合、組織のデフォルトのマージキーが使用されます
  • identifier_field の説明：会員の識別に使用するフィールド名を指定します。API が会員情報の検索と紐付けに使用するフィールドを決定します。identifier_field が指定されていない場合、member_sn を使用して検索と紐付けが行われます。
  • OneAudience が有効な組織では、'brand' と顧客識別フィールドの両方が必須です
  • カスタムフィールドは組織設定で事前に設定されている必要があります
  • 会員未登録者は 'is_headless_account' を true に設定してください

Request​

Responses​