Emarsysコネクタ構成ガイド

構成

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

コネクタを追加した後、以下の構成を行います：

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

アクション

アクション名	AudienceStream	EventStream
Add Contact to Contact List (Real-Time)	✓	✗
Add Contact to Contact List (Batched)	✓	✗
Create or Update Email Contact (Real-Time)	✓	✗
Create or Update Email Contact (Batched)	✓	✗
Remove Contact From Contact List (Real-Time)	✓	✗
Remove Contact From Contact List (Batched)	✓	✗
Trigger Transactional Email (Real-Time)	✓	✗
Trigger Transactional Email (Batched)	✓	✗
Unsubscribe Contact From Email Campaign	✓	✗
Trigger an External Event (Real-Time)	✓	✓
Trigger an External Event (Batched)	✓	✓
Upsert record in an RDS table (Real-Time)	✓	✗
Upsert record in an RDS table (Batched)	✓	✗
Delete record in an RDS table (Real-Time)	✓	✗
Delete record in an RDS table (Batched)	✓	✗

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

バッチ制限

このコネクタは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

• リクエストの最大数：1000
• 最古のリクエストからの最大時間：4分45秒
• リクエストの最大サイズ：10 MB

Add Contact to Contact List (Real-Time)

パラメータ

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

Add Contact to Contact List (Batched)

パラメータ

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

Create or Update Email Contact (Real-Time)

パラメータ

パラメータ	説明
Create If Not Exists	有効にすると、連絡先が存在しない場合、自動的に作成されます。
Contact Identifier Data	必須 これは連絡先を識別するためのフィールドです。 ターゲットの連絡先フィールドのIDを知っていて、手動で構成したい場合は、カスタム値を使用します。
Contact Data	必須 連絡先を識別するためのフィールドと対応するフィールドデータ。 連絡先を識別するためには少なくとも1つのフィールドが必要です。 連絡先フィールドがサポートする日付形式はYYYY-MM-DDのみです。 一部の連絡先フィールドは、受け入れ可能な値が限られています。詳細については、Emarsys: Core API Referenceを参照してください。 ターゲットの連絡先フィールドのIDを知っていて、手動で構成したい場合は、カスタム値を使用します。

オプション

パラメータ	説明
Source ID	顧客の外部アプリケーションに割り当てられたIDで、外部アプリケーションによって作成または変更された連絡先を識別するために使用されます。

Create or Update Email Contact (Batched)

パラメータ

パラメータ	説明
Create If Not Exists	有効にすると、連絡先が存在しない場合、自動的に作成されます。
Contact Identifier Data	必須 これは連絡先を識別するためのフィールドです。 ターゲットの連絡先フィールドのIDを知っていて、手動で構成したい場合は、カスタム値を使用します。
Contact Data	必須 連絡先を識別するためのフィールドと対応するフィールドデータ。 連絡先を識別するためには少なくとも1つのフィールドが必要です。 連絡先フィールドがサポートする日付形式はYYYY-MM-DDのみです。 一部の連絡先フィールドは、受け入れ可能な値が限られています。詳細については、Emarsys: Core API Referenceを参照してください。 ターゲットの連絡先フィールドのIDを知っていて、手動で構成したい場合は、カスタム値を使用します。

オプション

パラメータ	説明
Source ID	顧客の外部アプリケーションに割り当てられたIDで、外部アプリケーションによって作成または変更された連絡先を識別するために使用されます。

Remove Contact From Contact List (Real-Time)

パラメータ

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

Remove Contact From Contact List (Batched)

パラメータ

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

Trigger Transactional Email (Real-Time)

パラメータ

パラメータ	説明
External Event	必須 メールをトリガーするイベントを選択します。
Contact Data	必須 連絡先を識別するためのフィールドと対応するフィールドデータ。 ターゲットの連絡先リストのIDを知っていて、手動で構成したい場合は、カスタム値を使用します。

オプション

パラメータ	説明
Content Personalization Data	オプション メール内のプレースホルダーとそれを置き換える値。

Trigger Transactional Email (Batched)

パラメータ

パラメータ	説明
External Event	必須 メールをトリガーするイベントを選択します。
連絡先データ	必須 連絡先を識別するためのフィールドと対応するフィールドデータ。 ターゲットの連絡先リストのIDを知っていて、それを手動で構成したい場合は、カスタム値を使用します。

任意

パラメータ	説明
コンテンツパーソナライゼーションデータ	任意 メールのプレースホルダーとそれを置き換える値。

メールキャンペーンからの連絡先の退会

パラメータ

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

外部イベントのトリガー（リアルタイム）

パラメータ

パラメータ	説明
外部イベント	トリガーするイベントを選択します。
連絡先データ	必須 連絡先を識別するためのフィールドと対応するフィールドデータ。 ターゲットの連絡先リストのIDを知っていて、それを手動で構成したい場合は、カスタム値を使用します。 詳細については、Emarsys: Core API Referenceを参照してください。

任意

パラメータ	説明
外部イベントデータ	トリガーに使用する外部データ。
テンプレート変数	テンプレートのデータ入力としてテンプレート変数を提供します。詳細については、Webhook Send Custom Request Template Variables Guideを参照してください。ネストされたテンプレート変数はドット表記法で名前を付けます（例：items.name）。ネストされたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
テンプレート	外部イベントデータで参照されるテンプレートを提供します。詳細については、Webhook Send Custom Request Trimou Templating Engine Guideを参照してください。テンプレートは名前で二重中括弧を使用してサポートされるフィールドに挿入されます（例：{{SomeTemplateName}}）。

外部イベントのトリガー（バッチ）

パラメータ

パラメータ	説明
外部イベント	トリガーするイベントを選択します。
連絡先データ	必須 連絡先を識別するためのフィールドと対応するフィールドデータ。 ターゲットの連絡先リストのIDを知っていて、それを手動で構成したい場合は、カスタム値を使用します。 詳細については、Emarsys: Core API Referenceを参照してください。

任意

パラメータ	説明
外部イベントデータ	トリガーに使用する外部データ。
テンプレート変数	テンプレートのデータ入力としてテンプレート変数を提供します。詳細については、Webhook Send Custom Request Template Variables Guideを参照してください。ネストされたテンプレート変数はドット表記法で名前を付けます（例：items.name）。ネストされたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
テンプレート	外部イベントデータで参照されるテンプレートを提供します。詳細については、Webhook Send Custom Request Trimou Templating Engine Guideを参照してください。テンプレートは名前で二重中括弧を使用してサポートされるフィールドに挿入されます（例：{{SomeTemplateName}}）。

RDSテーブルにレコードをアップサート（リアルタイム）

パラメータ

パラメータ	説明
接続名	関係データサービス（RDS）への接続の名前。
テーブル名	RDSのテーブルの名前。
テーブルレコード	新規または更新レコードに含める属性。各属性をテーブルの列にマッピングします。

RDSテーブルにレコードをアップサート（バッチ）

パラメータ

パラメータ	説明
接続名	RDSへの接続の名前。
テーブル名	RDSのテーブルの名前。
テーブルレコード	新規または更新レコードに含める属性。各属性をテーブルの列にマッピングします。

RDSテーブルのレコードを削除（リアルタイム）

パラメータ

パラメータ	説明
接続名	RDSへの接続の名前。
テーブル名	RDSのテーブルの名前。
テーブルレコード	削除するレコードを識別する属性。各属性をテーブルの列にマッピングします。

RDSテーブルのレコードを削除（バッチ）

パラメータ

パラメータ	説明
接続名	RDSへの接続の名前。
テーブル名	RDSのテーブルの名前。
テーブルレコード	削除するレコードを識別する属性。各属性をテーブルの列にマッピングします。