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

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

コネクタを追加した後、Salesforce への接続を確立するために以下の構成を構成します：

* **アカウントタイプ**: 接続するアカウントタイプを選択します：**Developer**、**Production**、または **Sandbox**。
    * **接続を確立** をクリックして OAuth プロセスを開始し、プロンプトに従って完了させます。
    * サンドボックスについての詳細は、[Salesforce: アカウントエンゲージメントのためのサンドボックスを作成する](https://help.salesforce.com/s/articleView?id=mktg.pardot_sf_connector_sandbox.htm&type=5)を参照してください。

## アクション

| アクション名 | AudienceStream | EventStream|
|---| ---| ---|
|カスタムオブジェクトに挿入| ✓| ✗|
|カスタムオブジェクトを更新| ✓| ✗|
|リードを挿入| ✓| ✗|
|リードを更新| ✓| ✗|
|リードをアップサート| ✓| ✗|
|リードをコンタクトに変換| ✓| ✗|
|キャンペーンにリードを追加| ✓| ✗|
|コンタクトを挿入| ✓| ✗|
|コンタクトを更新| ✓| ✗|
|キャンペーンにコンタクトを追加| ✓| ✗|
|カスタム Apex に訪問全体を送信 | ✓ | ✗ |
|カスタム Apex にイベント全体を送信 | ✗ | ✓ |
|カスタムオブジェクトにアップサート（非バッチ処理）| ✓ | ✓ |
|カスタムオブジェクトにアップサート（バッチ処理）| ✓ | ✓ |

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

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

### カスタムオブジェクトに挿入

#### パラメータ

|パラメータ| 説明|
|---| ---|
|カスタムオブジェクト名| Salesforce のカスタムオブジェクトの名前。|
| データマップを挿入 | Tealium の属性を Salesforce のカスタムオブジェクトのフィールドにマッピングして選択します。マッピングされた各フィールドはレコード挿入の一部として送信されます。 |

### カスタムオブジェクトを更新

#### パラメータ

|パラメータ| 説明|
|---| ---|
|カスタムオブジェクト名| Salesforce のカスタムオブジェクトの名前。|
|カスタムオブジェクトID | Salesforce のカスタムオブジェクトのID。|
| 更新フィールド | レコードを更新するために Tealium の属性を Salesforce のフィールドにマッピングします。 |

### リードを挿入

#### パラメータ

|パラメータ| 説明|
|---| ---|
|構成するデータを挿入| Tealium の属性を Salesforce のリードフィールドにマッピングしてレコード作成のために選択します。|
| データマップを追加 | <ul><li>(オプション) このセクションを使用して、複数の AudienceStream 属性を同じ Salesforce テキストエリアフィールドに追加します。</li><li>必要に応じて複数の値を同じ Salesforce フィールドキーにマッピングします。</li><li>更新およびアップサートアクションの場合、既存のフィールド内容は保持され、新しい値は整形されたテキストで追加されます。</li><li>サポートされているのは Salesforce の TextArea タイプのフィールドのみです。</li><li>API エラーを防ぐために選択されたフィールドが十分な長さを持っていることを確認してください。</li><li>追加された値は AudienceStream のデータタイプ（例：Boolean、String、JSON）に応じて Salesforce で表現されます。</li><li>追加されたテキストには、提供された場合はオプションのエントリーラベル、現在の ISO UTC 日付、およびマッピングされたキーバリューペアが別々の行に含まれます。</li></ul> |
|追加データマップ - エントリーラベル|  <ul><li>(オプション) 提供された場合、このテキストは追加された列の値の先頭に追加されます。</li><li>使用しない場合は空のままにしてください。</li><li>正確な形式については「データマップを追加」セクションを参照してください。</li></ul> |
|ターゲット割り当てルールを選択|  <ul><li>(オプション) アカウントで使用可能な割り当てルールのリストが表示され、ターゲットリードに適用することができます。</li><li>**デフォルトの割り当てルールを使用** を選択すると、Salesforce はルールベースの割り当てのためにデフォルトのルールを使用するように強制されます。</li><li>割り当てルールオプションを API コールに含めないように、値を選択しないか **None** を選択してください。</li></ul> |

### リードを更新

#### パラメータ

|パラメータ| 説明|
|---| ---|
| リードID | (必須) 更新するリードを識別するために使用される Salesforce フィールドを選択します。|
|構成するデータを更新| Tealium の属性を Salesforce のリードフィールドにマッピングしてレコード更新のために選択します。|
| データマップを追加 | <ul><li>(オプション) このセクションを使用して、複数の AudienceStream 属性を同じ Salesforce テキストエリアフィールドに追加します。</li><li>必要に応じて複数の値を同じ Salesforce フィールドキーにマッピングします。</li><li>更新およびアップサートアクションの場合、既存のフィールド内容は保持され、新しい値は整形されたテキストで追加されます。</li><li>サポートされているのは Salesforce の TextArea タイプのフィールドのみです。</li><li>API エラーを防ぐために選択されたフィールドが十分な長さを持っていることを確認してください。</li><li>追加された値は AudienceStream のデータタイプ（例：Boolean、String、JSON）に応じて Salesforce で表現されます。</li><li>追加されたテキストには、提供された場合はオプションのエントリーラベル、現在の ISO UTC 日付、およびマッピングされたキーバリューペアが別々の行に含まれます。</li></ul> |
|追加データマップ - エントリーラベル|  <ul><li>(オプション) 提供された場合、このテキストは追加された列の値の先頭に追加されます。</li><li>使用しない場合は空のままにしてください。</li><li>正確な形式については「データマップを追加」セクションを参照してください。</li></ul> |
|ターゲット割り当てルールを選択|  <ul><li>(オプション) アカウントで使用可能な割り当てルールのリストが表示され、ターゲットリードに適用することができます。</li><li>**デフォルトの割り当てルールを使用** を選択すると、Salesforce はルールベースの割り当てのためにデフォルトのルールを使用するように強制されます。</li><li>割り当てルールオプションを API コールに含めないように、値を選択しないか **None** を選択してください。</li></ul> |

### リードをアップサート


#### パラメータ

|パラメータ| 説明|
|---| ---|
| 更新ルックアップID | <ul><li>(必須) 既存のリードを識別するために使用するSalesforceフィールドを選択します。</li><li>このフィールドの値によって、アクションが既存のレコードを更新するか新しいものを挿入するかが決まります。</li></ul> |
| 更新データの構成 | <ul><li>(必須) 既存のレコードが見つかった場合に更新するためにTealium属性をSalesforceリードフィールドにマッピングします。</li><li>同じSalesforceフィールドに複数のAudienceStream属性を追加するには、代わりにデータ追加マップセクションを使用してください。</li><li>ここでマッピングされた値はSalesforce内の既存のフィールド値に上書きされます。</li><li>両方のセクションで同じフィールドを構成しないでください。更新データの構成またはデータ追加マップのいずれかを使用してください。</li></ul>  |
| 挿入データの構成 | <ul><li>(必須) 新しいレコードを作成するためにTealium属性をSalesforceリードフィールドにマッピングします。</li><li>同じSalesforceフィールドに複数のAudienceStream属性を追加するには、代わりにデータ追加マップセクションを使用してください。</li><li>マッピングされた値は新しく作成されたリードレコードの指定されたフィールドに入力されます。</li><li>両方のセクションで同じフィールドを構成しないでください。挿入データの構成またはデータ追加マップのいずれかを使用してください。</li></ul>  |
| データ追加マップ | <ul><li>(オプション) このセクションを使用して、複数のAudienceStream属性を同じSalesforceテキストエリアフィールドに追加します。</li><li>必要に応じて複数の値を同じSalesforceフィールドキーにマッピングします。</li><li>更新およびアップサートアクションの場合、既存のフィールド内容は保持され、新しい値が整形されたテキストで追加されます。</li><li>サポートされているのはTextAreaタイプのSalesforceフィールドのみです。</li><li>APIエラーを防ぐために、選択されたフィールドが十分な長さを持っていることを確認してください。</li><li>追加された値は、そのAudienceStreamデータタイプ（例：Boolean、String、JSON）に従ってSalesforceで表現されます。</li><li>追加されたテキストには、提供された場合はオプションのエントリラベル、現在のISO UTC日付、およびマッピングされたキーバリューペアが別々の行に含まれます。</li></ul> |
|データ追加マップ - エントリラベル|  <ul><li>(オプション) 提供された場合、このテキストは追加された列の値の開始に追加されます。</li><li>使用しない場合は空のままにしてください。</li><li>"データ追加マップ"セクションで正確な形式を参照してください。</li></ul> |
|ターゲット割り当てルールの選択|  <ul><li>(オプション) リストには、ターゲットリードに適用できるアカウントの利用可能な割り当てルールが表示されます。</li><li>**デフォルトの割り当てルールを使用** を選択すると、Salesforceはルールベースの割り当てのためにデフォルトのルールを使用します。</li><li>割り当てルールオプションをAPIコールに含めないように、値を選択しないか **なし** を選択してください。</li></ul> |

### リードをコンタクトに変換

#### パラメータ

|パラメータ| 説明|
|---| ---|
| リードID | (必須) 更新するリードを識別するために使用するSalesforceフィールドを選択します。|
|所有者にメールを送信| 所有者にメールを送信します。|

### リードをキャンペーンに追加

#### パラメータ

|パラメータ| 説明|
|---| ---|
| リードID | (必須) 更新するリードを識別するために使用するSalesforceフィールドを選択します。|
|キャンペーン| リードのターゲットキャンペーンを選択します。|

### コンタクトの挿入

#### パラメータ

|パラメータ| 説明|
|---| ---|
| コンタクトの挿入 |  <ul><li>(必須) Salesforceのコンタクト識別フィールドにTealium属性をマッピングします。</li><li>これらのフィールドはSalesforceで作成されるコンタクトレコードを定義するために使用されます。</li></ul> |
|データ追加マップ - エントリラベル|  <ul><li>(オプション) 提供された場合、このテキストは追加された列の値の開始に追加されます。</li><li>使用しない場合は空のままにしてください。</li><li>"データ追加マップ"セクションで正確な形式を参照してください。</li></ul> |

### コンタクトの更新

#### パラメータ

|パラメータ| 説明|
|---| ---|
| コンタクトID | (必須) 更新するコンタクトを識別するために使用するSalesforceフィールドを選択します。|
|更新データの構成| Tealium属性をSalesforceコンタクトフィールドにマッピングしてレコードを更新します。|
| データ追加マップ | <ul><li>(オプション) このセクションを使用して、複数のAudienceStream属性を同じSalesforceテキストエリアフィールドに追加します。</li><li>必要に応じて複数の値を同じSalesforceフィールドキーにマッピングします。</li><li>更新およびアップサートアクションの場合、既存のフィールド内容は保持され、新しい値が整形されたテキストで追加されます。</li><li>サポートされているのはTextAreaタイプのSalesforceフィールドのみです。</li><li>APIエラーを防ぐために、選択されたフィールドが十分な長さを持っていることを確認してください。</li><li>追加された値は、そのAudienceStreamデータタイプ（例：Boolean、String、JSON）に従ってSalesforceで表現されます。</li><li>追加されたテキストには、提供された場合はオプションのエントリラベル、現在のISO UTC日付、およびマッピングされたキーバリューペアが別々の行に含まれます。</li></ul> |
|データ追加マップ - エントリラベル|  <ul><li>(オプション) 提供された場合、このテキストは追加された列の値の開始に追加されます。</li><li>使用しない場合は空のままにしてください。</li><li>"データ追加マップ"セクションで正確な形式を参照してください。</li></ul> |

### キャンペーンにコンタクトを追加

#### パラメータ

|パラメータ| 説明|
|---| ---|
| コンタクトID | (必須) 更新するコンタクトを識別するために使用するSalesforceフィールドを選択します。|
|キャンペーン| コンタクトのターゲットキャンペーンを選択します。|

### カスタムApexに訪問全体を送信

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| ApexエンドポイントURL | (必須) カスタムApex RESTエンドポイント。完全なURL（例：`https://myorg.my.salesforce.com/services/apexrest/TealiumVisitor`）または相対パス（例：`/services/apexrest/TealiumVisitor`）を入力します。パスには`/services/apexrest/`が含まれている必要があります。 |
| 現在の訪問データを含む | 訪問データに現在の訪問データを含めます。 |
| 属性名を印刷 | デフォルトでは、属性キーが使用されます。代わりに属性名をキーとして使用するには有効にします。 |

### カスタムApexにイベント全体を送信

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| ApexエンドポイントURL | (必須) カスタムApex RESTエンドポイント。完全なURL（例：`https://myorg.my.salesforce.com/services/apexrest/TealiumEvent`）または相対パス（例：`/services/apexrest/TealiumEvent`）を入力します。パスには`/services/apexrest/`が含まれている必要があります。 |
| 属性名を印刷 | デフォルトでは、属性キーが使用されます。代わりに属性名をキーとして使用するには有効にします。 |

### カスタムオブジェクトにアップサート（非バッチ処理）

#### パラメータ

| パラメータ | 説明 |
| --- | --- |
| カスタムオブジェクト | アップサートを実行するカスタムオブジェクトを選択します。 |

#### ルックアップ

| パラメータ | 説明 |
| --- | --- |
| ルックアップ | 外部IDをルックアップするデータ。|

#### データマッピング

| パラメータ | 説明 |
| --- | --- |
| データマッピング | レコードをアップサートする際に変更するデータ。 |

### カスタムオブジェクトにアップサート（バッチ処理）

#### バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加します。詳細については、[バッチ処理アクション](https://docs.tealium.com/batched-actions/)を参照してください。次のいずれかの閾値が満たされるか、プロファイルが公開されるまでリクエストはキューに入れられます：

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

#### パラメータ

| パラメータ | 説明 |
| --- | --- |
| カスタムオブジェクト | アップサートを実行するカスタムオブジェクトを選択します。 |

#### ルックアップ

| パラメータ | 説明 |
| --- | --- |
| ルックアップ | 外部IDをルックアップするデータ。|

#### データマッピング

| パラメータ | 説明 |
| --- | --- |
| データマッピング | レコードをアップサートする際に変更するデータ。 |