Salesforce コネクタ構成ガイド

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタ概要の記事を読んでください。

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

• アカウントタイプ: 接続するアカウントタイプを選択します：Developer、Production、または Sandbox。
  • 接続を確立 をクリックして OAuth プロセスを開始し、プロンプトに従って完了させます。
  • サンドボックスについての詳細は、Salesforce: アカウントエンゲージメントのためのサンドボックスを作成するを参照してください。

アクション

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

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

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

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

パラメータ

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

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

パラメータ

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

リードを挿入

パラメータ

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

リードを更新

パラメータ

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

リードをアップサート

パラメータ

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

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

パラメータ

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

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

パラメータ

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

コンタクトの挿入

パラメータ

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

コンタクトの更新

パラメータ

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

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

パラメータ

パラメータ	説明
コンタクト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をルックアップするデータ。

データマッピング

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

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

バッチ制限

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

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

パラメータ

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

ルックアップ

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

データマッピング

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