---
title: Emarsys コネクタ構成ガイド
description: この記事では、Emarsys コネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/emarsys-connector/
---
## 構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

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

* **認証タイプ**：
  * **OAuth**：クライアント資格情報を使用して Emarsys v3 API で認証します。詳細については、[Emarsys: v3 API での認証](https://dev.emarsys.com/docs/emarsys-core-api-guides/b3c3a1eba8515-authentication-in-v3-api)を参照してください。
  * **WSSE**：ユーザー名とパスワードを使用して Emarsys v2 API で認証します。詳細については、[Emarsys: v2 WSSE 認証](https://dev.emarsys.com/docs/emarsys-core-api-guides/branches/main/b3c3a1eba8515-authentication)を参照してください。
* **クライアントID**：  
OAuth 認証タイプに必要です。Emarsys v3 API で認証するためのクライアントID。
* **クライアントシークレット**：  
OAuth 認証タイプに必要です。Emarsys v3 API で認証するためのクライアントシークレット。
* **ユーザー名**：  
WSSE 認証タイプに必要です。Emarsys APID へのアクセス権を持つユーザー名。Emarsys APID ユーザー名についての詳細は、[Emarsys: アカウントの構成](https://dev.emarsys.com/docs/core-api-reference/branches/main/a12e08c686f0f-2-set-up-your-account)を参照してください。
* **パスワード**：  
WSSE 認証タイプに必要です。提供されたユーザー名のパスワード。
* **環境**：  
API コールを行う環境。

## アクション

|**アクション名**| **AudienceStream**| **EventStream**|
| --- | --- | --- |
| コンタクトリストへのコンタクト追加（リアルタイム） | ✓ | ✗ |
| コンタクトリストへのコンタクト追加（バッチ処理） | ✓ | ✗ |
| メールコンタクトの作成または更新（リアルタイム） | ✓ | ✗ |
| メールコンタクトの作成または更新（バッチ処理） | ✓ | ✗ |
| コンタクトリストからのコンタクト削除（リアルタイム） | ✓ | ✗ |
| コンタクトリストからのコンタクト削除（バッチ処理） | ✓ | ✗ |
| トランザクショナルメールのトリガー（リアルタイム） | ✓ | ✗ |
| トランザクショナルメールのトリガー（バッチ処理） | ✓ | ✗ |
| メールキャンペーンからのコンタクトの退会 | ✓ | ✗ |
| エンゲージメントイベントのトリガー | ✓ | ✓ |
| 外部イベントのトリガー（リアルタイム）（非推奨） | ✓ | ✓ |
| 外部イベントのトリガー（バッチ処理）（非推奨） | ✓ | ✓ |
| RDSテーブルへのレコードのアップサート（リアルタイム） | ✓ | ✗ |
| RDSテーブルへのレコードのアップサート（バッチ処理） | ✓ | ✗ |
| RDSテーブルのレコードの削除（リアルタイム） | ✓ | ✗ |
| RDSテーブルのレコードの削除（バッチ処理） | ✓ | ✗ |

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

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

#### バッチ制限

このコネクタは、バッチリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

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

### コンタクトリストへのコンタクト追加（リアルタイム）

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|対象コンタクトリスト|  <ul><li>(必須) コンタクトを追加するコンタクトリスト。</li><li>対象コンタクトリストのIDを知っている場合は、カスタム値を使用して手動で構成できます。</li></ul> |
|コンタクトデータ|  <ul><li>(必須) コンタクトを識別するためのフィールドおよび対応するフィールドデータ。</li><li>詳細については、[Emarsys: コアAPIリファレンス](https://dev.emarsys.com/docs/emarsys-api/365efd9f5e931-remove-contacts-from-a-contact-list)を参照してください。</li></ul> |

### コンタクトリストへのコンタクト追加（バッチ処理）

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|対象コンタクトリスト|  <ul><li>(必須) コンタクトを追加するコンタクトリスト。</li><li>対象コンタクトリストのIDを知っている場合は、カスタム値を使用して手動で構成できます。</li></ul>|
|コンタクトデータ|  <ul><li>(必須) コンタクトを識別するためのフィールドおよび対応するフィールドデータ。</li><li>詳細については、[Emarsys: コアAPIリファレンス](https://dev.emarsys.com/docs/emarsys-api/365efd9f5e931-remove-contacts-from-a-contact-list)を参照してください。</li></ul> |

### メールコンタクトの作成または更新（リアルタイム）

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|存在しない場合は作成| 有効にすると、コンタクトが存在しない場合は自動的に作成されます。|
|コンタクト識別データ|  <ul><li>(必須) コンタクトを識別するために使用されるフィールド。</li><li>対象コンタクトフィールドのIDを知っている場合は、カスタム値を使用して手動で構成できます。</li></ul> |
|コンタクトデータ|  <ul><li>(必須) コンタクトを識別するためのフィールドおよび対応するフィールドデータ。</li><li>コンタクトを識別するために少なくとも1つのフィールドが必要です。</li><li>コンタクトフィールドでサポートされている唯一の日付形式は `YYYY-MM-DD` です。</li><li>一部のコンタクトフィールドには受け入れ可能な値が限られています。詳細については、[Emarsys: コアAPIリファレンス](https://dev.emarsys.com/docs/emarsys-api/1a17c3d6fcebc-list-available-choices-of-a-single-choice-field)を参照してください。</li><li>対象コンタクトフィールドのIDを知っている場合は、カスタム値を使用して手動で構成できます。</li></ul> |

#### オプション

|**パラメータ**| **説明**|
|---| ---|
|ソースID|  <ul><li>顧客の外部アプリケーションに割り当てられたIDで、外部アプリケーションによって作成または変更されたコンタクトを識別するために使用されます。</li></ul> |

### メールコンタクトの作成または更新（バッチ処理）

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|存在しない場合は作成| 有効にすると、コンタクトが存在しない場合は自動的に作成されます。|
|コンタクト識別データ|  <ul><li>(必須) コンタクトを識別するために使用されるフィールド。</li><li>対象コンタクトフィールドのIDを知っている場合は、カスタム値を使用して手動で構成できます。</li></ul> |
|コンタクトデータ|  <ul><li>(必須) コンタクトを識別するためのフィールドおよび対応するフィールドデータ。</li><li>コンタクトを識別するために少なくとも1つのフィールドが必要です。</li><li>コンタクトフィールドでサポートされている唯一の日付形式は `YYYY-MM-DD` です。</li><li>一部のコンタクトフィールドには受け入れ可能な値が限られています。詳細については、[Emarsys: コアAPIリファレンス](https://dev.emarsys.com/docs/emarsys-api/1a17c3d6fcebc-list-available-choices-of-a-single-choice-field)を参照してください。</li><li>対象コンタクトフィールドのIDを知っている場合は、カスタム値を使用して手動で構成できます。</li></ul> |

#### オプション

|**パラメータ**| **説明**|
|---| ---|
|ソースID|  <ul><li>顧客の外部アプリケーションに割り当てられたIDで、外部アプリケーションによって作成または変更されたコンタクトを識別するために使用されます。</li></ul> |

### コンタクトリストからのコンタクト削除（リアルタイム）

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|対象コンタクトリスト| <ul><li>(必須) コンタクトを追加するコンタクトリスト。</li><li>対象コンタクトリストのIDを知っている場合は、カスタム値を使用して手動で構成できます。</li></ul> |
|コンタクトデータ|  <ul><li>(必須) コンタクトを識別するためのフィールドおよび対応するフィールドデータ。</li><li>対象コンタクトリストのIDを知っている場合は、カスタム値を使用して手動で構成できます。</li><li>詳細については、[Emarsys: コアAPIリファレンス](https://dev.emarsys.com/docs/emarsys-api/365efd9f5e931-remove-contacts-from-a-contact-list)を参照してください。</li></ul> |

### コンタクトリストからのコンタクト削除（バッチ処理）
#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|ターゲットコンタクトリスト| <ul><li>(必須) コンタクトを追加するコンタクトリスト。</li><li>ターゲットコンタクトリストのIDを知っていて、手動で構成したい場合はカスタム値を使用します。</li></ul> |
|コンタクトデータ|  <ul><li>(必須) コンタクトを識別するためのフィールドと対応するフィールドデータ。</li><li>ターゲットコンタクトリストのIDを知っていて、手動で構成したい場合はカスタム値を使用します。</li><li>詳細については、[Emarsys: Core API Reference](https://dev.emarsys.com/docs/emarsys-api/365efd9f5e931-remove-contacts-from-a-contact-list)を参照してください。</li></ul> |

### トランザクショナルメールのトリガー (リアルタイム)

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|外部イベント|  <ul><li>(必須) メールをトリガーするイベントセットを選択します。</li></ul> |
|コンタクトデータ|  <ul><li>(必須) コンタクトを識別するためのフィールドと対応するフィールドデータ。</li><li>ターゲットコンタクトリストのIDを知っていて、手動で構成したい場合はカスタム値を使用します。</li></ul> |

#### オプショナル

|**パラメータ**| **説明**|
|---| ---|
|コンテンツパーソナライゼーションデータ|  <ul><li>(オプション) メール内のプレースホルダーとそれに置き換える値。</li></ul> |

### トランザクショナルメールのトリガー (バッチ処理)

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|外部イベント|  <ul><li>(必須) メールをトリガーするイベントセットを選択します。</li></ul> |
|コンタクトデータ|  <ul><li>(必須) コンタクトを識別するためのフィールドと対応するフィールドデータ。</li><li>ターゲットコンタクトリストのIDを知っていて、手動で構成したい場合はカスタム値を使用します。</li></ul> |

#### オプショナル

|**パラメータ**| **説明**|
|---| ---|
|コンテンツパーソナライゼーションデータ|  <ul><li>(オプション) メール内のプレースホルダーとそれに置き換える値。</li></ul> |

### メールキャンペーンからコンタクトを退会させる

#### パラメータ

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

### エンゲージメントイベントのトリガー

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| インテグレーションID | (必須) Emarsysによって提供されるエンゲージメントイベントインテグレーションのID。 |
| イベント構成ID | (必須) EmarsysエンゲージメントイベントタイプのID。 |
| ドラフト | 有効にすると、イベントはEmarsysイベント構成のドラフトバージョンによって処理されます。 |
| テンプレート変数 | テンプレートにデータ入力としてテンプレート変数を提供します。詳細については、[connector-template-variables](https://docs.tealium.com/connector-template-variables/)を参照してください。ドット表記（例：`items.name`）でネストされたテンプレート変数を名前付けします。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
| テンプレート | イベントデータで参照されるテンプレートを提供します。詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。テンプレートは、サポートされるフィールドに名前で二重中括弧で注入されます。例えば、`{{SomeTemplateName}}`。 |

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

#### パラメータ

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

### バッチ処理でRDSテーブルにレコードをアップサート

#### パラメータ

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

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

#### パラメータ

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

### バッチ処理でRDSテーブルのレコードを削除

#### パラメータ

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