Salesforce（顧客提供クレデンシャル）コネクタ構成ガイド

既存のSalesforceコネクタが認証タイプとして**Tealium提供クレデンシャル（非推奨）**を表示している場合は、Salesforce（Tealium提供クレデンシャル）コネクタに移行するか、認証タイプをクライアントクレデンシャルに変更してください。移行するまでコネクタはデータを送信し続けます。

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、コネクタについてを参照してください。

Tealiumが管理するOAuthクレデンシャルを使用する代わりに、独自の接続アプリを使用する場合は、Salesforce（Tealium提供クレデンシャル）を参照してください。

Salesforce接続アプリの構成

このコネクタを構成する前に、クライアントクレデンシャルフローが有効なSalesforce接続アプリを構成します：

Salesforceセットアップで、アプリマネージャーに移動し、新しい接続アプリを作成します。
OAuth構成を有効にし、次のコールバックURLを追加します：https://my.tealiumiq.com/oauth/salesforce/callback.html
必要なOAuthスコープを選択します。必要最低限のスコープはapiとrefresh_tokenです。
OAuth構成の下でクライアントクレデンシャルフローを有効にします。
クライアントクレデンシャルフローの下で、Run Asユーザーを指名します。Run Asユーザーの権限がコネクタがアクセスできるデータを決定します。
保存してから数分待ち、アプリがアクティブになるのを待ちます。
消費者キーと消費者秘密鍵をコピーして、以下のフィールドに使用します。

コネクタの接続

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

ログインURL（マイドメイン）：（必須）SalesforceマイドメインURLを入力します（例：https://mycompany.my.salesforce.com）。クライアントクレデンシャルフローでは、組織固有のマイドメインURLが必要です。login.salesforce.comやtest.salesforce.comは使用しないでください。
消費者キー（クライアントID）：（必須）Salesforce接続アプリまたは外部クライアントアプリからの消費者キーを入力します。
消費者秘密鍵（クライアント秘密鍵）：（必須）Salesforce接続アプリまたは外部クライアントアプリからの消費者秘密鍵を入力します。アプリのアクティブ化には作成後数分かかる場合があります。

接続テストをクリックして接続を確認します。

アクション

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

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

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

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

パラメータ

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

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

パラメータ

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

リードの挿入

パラメータ

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

リードの更新

パラメータ

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

リードのアップサート

パラメータ

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

データマッピング

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