Emarsysコネクタの構成ガイド

Emarsysは、データサイエンスと人工知能マーケティングを駆使して、顧客価値を最大化する包括的なクラウドベースのB2C（ビジネスから消費者へ）マーケティングプラットフォームです。

コネクタのアクション

アクション名	AudienceStream	EventStream
連絡先を連絡先リストに追加（非推奨v1）	✓	✗
連絡先を連絡先リストに追加	✓	✗
メール連絡先を作成または更新（非推奨v1）	✓	✗
メール連絡先を作成または更新	✓	✗
連絡先を連絡先リストから削除（非推奨v1）	✓	✗
連絡先を連絡先リストから削除	✓	✗
トランザクションメールをトリガー（非推奨v1）	✓	✗
トランザクションメールをトリガー	✓	✗
メールキャンペーンから連絡先の購読解除	✓	✗
外部イベントをトリガー	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する方法の一般的な手順については、コネクタについての記事を参照してください。

コネクタを追加した後、次の構成を構成します：

• ユーザー名：Emarsys APIDにアクセスするための権限を持つユーザー名。Emarsys APIDのユーザー名の詳細については、Emarsysのはじめにの記事を参照してください。
• パスワード：提供されたユーザー名のパスワード。
• 環境：API呼び出しを行う環境。

アクションの構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでコネクタのアクションを構成します。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション - 連絡先を連絡先リストに追加（非推奨v1）

パラメータ

パラメータ	説明
Target Contact List	必須 連絡先を追加する連絡先リスト ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。
名前
姓
Eメール
生年月日
性別
婚姻状態
子供
教育
役職
住所
市区町村
都道府県
郵便番号
国
電話番号
ファックス番号
職種
会社
部署
業界
オフィスの電話番号
オフィスのファックス番号
従業員数
年間売上高（OOO EUR）
URL
希望のメール形式
オプトイン
登録言語
携帯電話番号
パートナーの名前
パートナーの誕生日
記念日
会社の住所
オフィスの郵便番号
オフィスの市区町村
オフィスの都道府県
オフィスの国
敬称

アクション - 連絡先を連絡先リストに追加

パラメータ

パラメータ	説明
Target Contact List	必須 連絡先を追加する連絡先リスト ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。
連絡先の検索	必須 連絡先を識別するためのフィールドと対応するフィールドデータ ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。 詳細については、Emarsys APIドキュメントを参照してください。

アクション - メール連絡先を作成または更新（非推奨v1）

パラメータ

パラメータ	説明
存在しない場合は作成する	有効にすると、連絡先が存在しない場合に自動的に作成されます。
ソースID	顧客の外部アプリケーションに割り当てられたオプションのIDで、外部アプリケーションによって作成または変更された連絡先を識別するために使用されます。
連絡先識別フィールド	必須 連絡先を識別するために使用されるフィールドです。
名前
姓
Eメール
生年月日
性別
婚姻状態
子供
教育
役職
住所
市区町村
都道府県
郵便番号
国
電話番号
ファックス番号
職種
会社
部署
業界
オフィスの電話番号
オフィスのファックス番号
従業員数
年間売上高（OOO EUR）
URL
希望のメール形式
オプトイン
登録言語
携帯電話番号
パートナーの名前
パートナーの誕生日
記念日
会社の住所
オフィスの郵便番号
オフィスの市区町村
オフィスの都道府県
オフィスの国
敬称

アクション - メール連絡先を作成または更新

パラメータ

パラメータ	説明
存在しない場合は作成する	有効にすると、連絡先が存在しない場合に自動的に作成されます。
ソースID	顧客の外部アプリケーションに割り当てられたオプションのIDで、外部アプリケーションによって作成または変更された連絡先を識別するために使用されます。
連絡先識別フィールド	必須 連絡先を識別するために使用されるフィールドです。 ターゲット連絡先フィールドのIDを手動で構成する場合は、カスタム値を使用します。
構成する連絡先フィールドデータ	更新されるフィールドと対応するフィールドデータ 連絡先を識別するためには少なくとも1つのフィールドが必要です。 連絡先フィールドでサポートされているのはYYYY-MM-DDのみの日付形式です。 一部の連絡先フィールドには制限された許容値があります。詳細については、Emarsysドキュメントを参照してください。 ターゲット連絡先フィールドのIDを手動で構成する場合は、カスタム値を使用します。

アクション - 連絡先を連絡先リストから削除（非推奨v1）

パラメータ

パラメータ	説明
Target Contact List	必須 連絡先を削除する連絡先リスト ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。
名前
姓
Eメール
生年月日
性別
婚姻状態
子供
教育
役職
住所
市区町村
都道府県
郵便番号
国
電話番号
ファックス番号
職種
会社
部署
業界
オフィスの電話番号
オフィスのファックス番号
従業員数
年間売上高（OOO EUR）
URL
希望のメール形式
オプトイン
登録言語
携帯電話番号
パートナーの名前
パートナーの誕生日
記念日
会社の住所
オフィスの郵便番号
オフィスの市区町村
オフィスの都道府県
オフィスの国
敬称

アクション - 連絡先を連絡先リストから削除

パラメータ

パラメータ	説明
Target Contact List	必須 連絡先を削除する連絡先リスト ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。
連絡先の検索	必須 連絡先を識別するためのフィールドと対応するフィールドデータ ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。 詳細については、Emarsys APIドキュメントを参照してください。

アクション - トランザクションメールをトリガー（非推奨v1）

パラメータ

パラメータ	説明
外部イベント	必須 メールをトリガーするために構成されたイベントを選択します
名前
姓
Eメール
生年月日
性別
婚姻状態
子供
教育
役職
住所
市区町村
都道府県
郵便番号
国
電話番号
ファックス番号
職種
会社
部署
業界
オフィスの電話番号
オフィスのファックス番号
従業員数
年間売上高（OOO EUR）
URL
希望のメール形式
オプトイン
登録言語
携帯電話番号
パートナーの名前
パートナーの誕生日
記念日
会社の住所
オフィスの郵便番号
オフィスの市区町村
オフィスの都道府県
オフィスの国
敬称
コンテンツパーソナライゼーションデータの構成	オプション メール内のプレースホルダーと置換する値。

アクション - トランザクションメールをトリガー

パラメータ

パラメータ	説明
外部イベント	必須 メールをトリガーするために構成されたイベントを選択します。
コンテンツパーソナライゼーションデータの構成	オプション メール内のプレースホルダーと置換する値。
Target Contact List	必須 連絡先を削除する連絡先リスト ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。
連絡先の検索	必須 連絡先を識別するためのフィールドと対応するフィールドデータ ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。 詳細については、Emarsys APIドキュメントを参照してください。

アクション - メールキャンペーンから連絡先の購読解除

パラメータ

パラメータ	説明
起動リストID	(必須) メール内の購読解除リンクから起動リストIDを指定します。
メールキャンペーンID	(必須) メール内の購読解除リンクからメールキャンペーンIDを指定します。
連絡先ID	(必須) ランダムに生成された文字列を連絡先IDにマッピングします。メール内の購読解除リンクで提供されます。

アクション - 外部イベントをトリガー

パラメータ

パラメータ	説明
外部イベント	トリガーするイベントを選択します。
連絡先の検索	必須 連絡先を識別するためのフィールドと対応するフィールドデータ ターゲット連絡先リストのIDを手動で構成する場合は、カスタム値を使用します。 詳細については、Emarsys APIドキュメントを参照してください。
イベントの時間	イベントの時間。
イベントデータ	トリガーに使用される外部データ。
テンプレート変数	テンプレートにデータ入力として提供されるテンプレート変数を指定します。詳細については、Webhook Send Custom Request Template Variables Guideを参照してください。ネストされたテンプレート変数はドット表記（例：items.name）で命名されます。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	外部イベントデータで参照されるテンプレートを指定します。詳細については、Webhook Send Custom Request Trimou Templating Engine Guideを参照してください。テンプレートは二重中括弧で名前を指定し、サポートされるフィールドに挿入されます（例：{{SomeTemplateName}}）。