Salesforce CRM 接続

Last update: Tue Nov 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
宛先

作成対象：

管理者
ユーザー

概要 overview

Salesforce CRM は一般的な顧客関係管理（CRM）プラットフォームであり、以下に説明するプロファイルのタイプをサポートしています。

リード - リードとは、販売する製品やサービスに興味を持つ（持たない）可能性のある人物や会社の名前です。
連絡先 – 連絡先は、担当者の 1 人が関係を確立し、潜在的な顧客として認定された個人です。

この Adobe Experience Platform 宛先は Salesforce composite API を活用します。これは、前述の両方のタイプのプロファイルをサポートします。

セグメントのアクティブ化を行う際に、リードまたは連絡先を選択し、属性とオーディエンスデータを Salesforce CRM に更新することができます。

Salesforce CRM は、Salesforce REST API と通信するための認証メカニズムとして、パスワード付与を使用した OAuth 2 を使用します。 Salesforce CRM インスタンスを認証する手順は、さらに下の宛先に対する認証の節にあります。

ユースケース use-cases

マーケターは、Adobe Experience Platform プロファイルの属性に基づいて、ユーザーにパーソナライズされたエクスペリエンスを提供できます。オフラインデータからオーディエンスを作成し、これらのオーディエンスをSalesforce CRM に送信して、Adobe Experience Platformでオーディエンスとプロファイルが更新されるとすぐに CRM メンバーシップを更新できます。

前提条件 prerequisites

Experience Platformの前提条件 prerequisites-in-experience-platform

Salesforce CRM 宛先へのデータをアクティブ化する前に、schema、dataset および segments を Experience Platform で作成する必要があります。

Salesforce CRM の前提条件 prerequisites-destination

Experience PlatformからSalesforce アカウントにデータを書き出すには、Salesforce CRM で次の前提条件に注意してください。

Salesforce アカウントが必要です prerequisites-account

Salesforce アカウントをまだお持ちでない場合は、体験版 Salesforce ページに移動し、登録して作成してください。

Salesforce 内での接続アプリケーションの設定 prerequisites-connected-app

まず、Salesforce アカウント内に接続されたアプリ Salesforce がない場合は、設定する必要があります。 Salesforce CRM は、接続されたアプリを利用して Salesforce に接続します。

次に、OAuth Settings for API Integration の Salesforce connected app を有効にします。詳しくは、Salesforce ドキュメントを参照してください。

また、ージに対して以下に説明するスコープ Salesforce connected app が選択されていることを確認します。

chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access

最後に、password アカウント内で Salesforce 付与が有効になっていることを確認します。ガイダンスが必要な場合は、Salesforce OAuth 2.0 ユーザー名 – パスワードフロー特別なシナリオに関するドキュメントを参照してください。

IMPORTANT

Salesforce アカウント管理者が信頼できる IP 範囲へのアクセスを制限している場合、Experience Platformの IP を許可リストに加えるするには、管理者に連絡する必要あります。追加のガイダンスが必要な場合は、Salesforce 接続されたアプリの信頼できる IP 範囲へのアクセスの制限ドキュメントを参照してください。

Salesforce 内でのカスタムフィールドの作成 prerequisites-custom-field

Salesforce CRM の宛先に対してオーディエンスをアクティブ化する場合、Mapping ID オーディエンススケジュール 手順で、アクティブ化された各オーディエンスの フィールドに値を入力する必要があります。

Salesforce CRM では、Experience Platformから受信するオーディエンスを正しく読み取って解釈し、Salesforce 内でオーディエンスステータスを更新するためにこの値が必要です。オーディエンスのステータスに関するガイダンスが必要な場合は、オーディエンスメンバーシップの詳細スキーマフィールドグループに関するExperience Platform ドキュメントを参照してください。

Experience Platformから Salesforce CRM に対してアクティブ化するオーディエンスごとに、Text Area (Long) 内に Salesforce タイプのカスタムフィールドを作成する必要があります。ビジネス要件に応じて、256～131,072 文字の任意のサイズのフィールド文字の長さを定義できます。カスタムフィールドタイプについて詳しくは、Salesforce カスタムフィールドタイプのドキュメントページを参照してください。また、フィールドの作成に関してサポートが必要な場合は、Salesforce のドキュメントを参照してカスタムフィールドの作成を確認してください。

IMPORTANT

フィールド名に空白文字を含めないでください。代わりに、アンダースコア (_) 文字を区切り文字として使用します。
Salesforce 内では、アクティブ化された各Experience Platform セグメントの Field Name 内で指定された値と完全に一致する Mapping ID を持つカスタムフィールドを作成する必要があります。例えば、以下のスクリーンショットは、crm_2_seg という名前のカスタムフィールドを示しています。この宛先に対してオーディエンスをアクティブ化する際に、crm_2_seg を Mapping ID として追加し、Experience Platformのオーディエンスオーディエンスをこのカスタムフィールドに入力します。

Salesforce でのカスタムフィールド作成の例 手順 1 - データタイプを選択 を以下に示します。
カスタムフィールドの作成を示すSalesforce UI のスクリーンショット、手順 1 - データタイプの選択

Salesforce でのカスタムフィールド作成の例 手順 2 - カスタムフィールドの詳細を入力 は、次のとおりです。
カスタムフィールドの作成を示すSalesforce UI のスクリーンショット、手順 2 - カスタムフィールドの詳細を入力

TIP

Experience Platform オーディエンスに使用されるカスタムフィールドと、Salesforce 内の他のカスタムフィールドを区別するために、カスタムフィールドの作成時に認識できるプレフィックスやサフィックスを含めることができます。例えば、test_segment の代わりに、Adobe_test_segment または test_segment_Adobe を使用します
Salesforce で既に他のカスタムフィールドを作成している場合は、Experience Platform セグメントと同じ名前を使用して、Salesforce でオーディエンスを簡単に識別できます。

NOTE

Salesforceのオブジェクトは、25 個の外部フィールドに制限されます。カスタムフィールド属性を参照してください。
この制限は、Experience Platform オーディエンスメンバーシップを常に最大 25 個のみアクティブにできることを意味します。
Salesforce内でこの制限に達した場合は、新しい Mapping ID を使用する前に、Salesforce内で古いオーディエンスに対するオーディエンスステータスの保存に使用されていたExperience Platformからカスタム属性を削除する必要があります。

Salesforce CRM 資格情報の収集 gather-credentials

Salesforce CRM の宛先に対して認証を行う前に、以下の項目をメモしておきます。

資格情報

説明

例

Username

Salesforce アカウントのユーザー名。

Password

Salesforce アカウントのパスワード。

Security Token

Salesforce セキュリティトークン：後で Salesforce パスワードの末尾に追加して、Password 宛先への認証時にとして使用される連結文字列を作成します。
セキュリティトークンがない場合に Salesforce インターフェイスからセキュリティトークンを再生成する方法については、のドキュメントセキュリティトークンのリセット Salesforce を参照してください。

Custom Domain

Salesforce ドメインのプレフィックス。
インターフェイスからこの値を取得する方法については、Salesforce ドキュメントを参照してくださ Salesforce。

Salesforce ドメインが
の場合 d5i000000isb4eak-dev-ed.my.salesforce.com,
値として d5i000000isb4eak-dev-ed が必要です。

Client ID

Salesforceの Consumer Key。
Salesforce インターフェイスからこの値を取得する方法については、ドキュメント Salesforce を参照してください。

Client Secret

Salesforceの Consumer Secret。
Salesforce インターフェイスからこの値を取得する方法については、ドキュメント Salesforce を参照してください。

ガードレール guardrails

Salesforce は、リクエスト、レート、タイムアウトの制限を課すことにより、トランザクションの負荷を分散させます。詳しくは、API リクエストの制限と割り当てを参照してください。

Salesforce アカウント管理者が IP 制限を適用している場合は、アカウントの信頼済み IP 範囲に 1}Experience Platform IP アドレス } を追加する必要があります。 Salesforce追加のガイダンスが必要な場合は、Salesforce 接続されたアプリの信頼できる IP 範囲へのアクセスの制限ドキュメントを参照してください。

IMPORTANT

セグメントをアクティブ化する際は、連絡先 タイプまたは リード タイプのいずれかを選択する必要があります。選択したタイプに応じた適切なデータマッピングがオーディエンスにあることを確認する必要があります。

サポートされる ID supported-identities

Salesforce CRM では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。

ターゲット ID

説明

注意点

SalesforceId

セグメントを通じて書き出しまたは更新する連絡先またはリード ID の Salesforce CRM 識別子。

必須

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目

タイプ

メモ

書き出しタイプ

Profile-based

セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します（例：メールアドレス、電話番号、姓）。
Salesforce CRM の各オーディエンスステータスは、Mapping ID オーディエンスのスケジュール設定手順で指定された値に基づいて、Experience Platformの対応するオーディエンスステータスとともに更新されます。

書き出し頻度

Streaming

ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT

宛先に接続するには、View Destinations および Manage Destinations アクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

Destinations > Catalog 内で Salesforce CRM を検索します。または、CRM カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

宛先に対する認証を行うには、以下の必須フィールドに入力し、「Connect to destination」を選択します。詳しくは、Gather Salesforce CRM credentials の節を参照してください。

資格情報

説明

Username

Salesforce アカウントのユーザー名。

Password

Salesforce アカウントのパスワードと Salesforce セキュリティトークンで構成される連結文字列。
連結された値は、{PASSWORD}{TOKEN} の形式になります。
注意：中括弧やスペースは使用しないでください。
例えば、Salesforce パスワードが MyPa$$w0rd123 で Salesforce セキュリティトークンが TOKEN12345....0000 の場合、Password フィールドで使用する連結された値は MyPa$$w0rd123TOKEN12345....0000 になります。

Custom Domain

Salesforce ドメインのプレフィックス。
例えば、ドメインが d5i000000isb4eak-dev-ed.my.salesforce.com の場合、値として d5i000000isb4eak-dev-ed を指定する必要があります。

Client ID

Salesforce で接続されたアプリ Consumer Key。

Client Secret

Salesforce で接続されたアプリ Consumer Secret。

認証方法を示すExperience Platform UI のスクリーンショット。

指定した詳細が有効な場合、UI で Connected ステータスに緑色のチェックマークが付き、次の手順に進むことができます。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。

Name：今後この宛先を認識するための名前。
Description：今後この宛先を識別するのに役立つ説明。
Salesforce ID Type：
- 書き出しまたは更新する ID のタイプが Contact 連絡先 の場合は、 を選択します。
- 書き出しまたは更新する ID のタイプが Lead リード の場合は、「」を選択します。

宛先の詳細を示すExperience Platform UI のスクリーンショット。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続への詳細の入力を終えたら「Next」を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT

データをアクティブ化するには、View Destinations、Activate Destinations、View Profiles、View Segments アクセス制御権限が必要です。アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
ID を書き出すには、View Identity Graph アクセス制御権限が必要です。
{width="100" modal="regular"}

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

マッピングの考慮事項と例 mapping-considerations-example

Adobe Experience Platform から Salesforce CRM 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Experience Platform アカウント内の Experience Data Model （XDM）スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。

Target field で指定する属性には、属性マッピングテーブルで説明されているとおりに正確に名前を付ける必要があります。これらの属性はリクエスト本文を形成するからです。

Source field で指定された属性は、そのような制限には従いません。必要に応じてマッピングできますが、入力データの形式が Salesforce ドキュメントに従って有効であることを確認してください。入力データが無効な場合、Salesforce への更新呼び出しは失敗し、連絡先/リードが更新されません。

XDM フィールドを (API) Salesforce CRM 宛先フィールドに正しくマッピングするには、次の手順に従います。

Mapping の手順で「Add new mapping」を選択すると、新しいマッピング行が画面に表示されます。
Select source field ウィンドウで、Select attributes カテゴリを選択して XDM 属性を選択するか、Select identity namespace を選択して ID を選択します。

Select target field ウィンドウで、Select identity namespace を選択して ID を選択するか、カテゴリ Select custom attributes 選択して属性を選択するか、必要に応じて Attribute name フィールドを使用して属性を定義します。サポートされる属性について詳しくは、Salesforce CRM ドキュメントを参照してください。

これらの手順を繰り返して、XDM プロファイルスキーマと (API) Salesforce CRM の間に次のマッピングを追加します。

連絡先の操作

セグメント内で 連絡先 を使用している場合は、Salesforceのオブジェクト参照で連絡先の情報を参照し、更新するフィールドのマッピングを定義してください。
必須フィールドは、上記のリンクのフィールドの説明で説明されている必須という単語を検索することで識別できます。

書き出しまたは更新するフィールドに応じて、XDM プロファイルスキーマと (API) Salesforce CRM の間のマッピングを追加します。

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
ソースフィールド	ターゲットフィールド	メモ
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`。連絡先の姓（最大 80 文字）。
`xdm: person.name.firstName`	`Attribute: FirstName`	連絡先の名（最大 40 文字）。
`xdm: personalEmail.address`	`Attribute: Email`	連絡先のメールアドレス。

これらのマッピングの使用例を次に示します。

リードの使用

セグメント内で リード を使用している場合は、Salesforceのリードのオブジェクト参照を参照して、更新するフィールドのマッピングを定義します。
必須フィールドは、上記のリンクのフィールドの説明で説明されている必須という単語を検索することで識別できます。

書き出しまたは更新するフィールドに応じて、XDM プロファイルスキーマと (API) Salesforce CRM の間のマッピングを追加します。

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
ソースフィールド	ターゲットフィールド	メモ
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`。リードの姓（最大 80 文字）。
`xdm: b2b.companyName`	`Attribute: Company`	`Mandatory`。リードの会社。
`xdm: personalEmail.address`	`Attribute: Email`	リードのメールアドレス。

これらのマッピングの使用例を次に示します。

宛先接続のマッピングの指定が完了したら、「Next」を選択します。

オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example

オーディエンスの書き出しをスケジュール手順を実行する際は、Experience Platformからアクティブ化されたオーディエンスを、Salesforce の対応するカスタムフィールドに手動でマッピングする必要があります。

それには、各セグメントを選択し、Salesforce からカスタムフィールド名を「Salesforce CRM Mapping ID」フィールドに入力します。でカスタムフィールドを作成する際のガイダンスとベストプラクティスについては、 Salesforce 内でのカスタムフィールドの作成 Salesforce の節を参照してください。

例えば、Salesforce カスタムフィールドが crm_2_seg の場合、Salesforce CRM Mapping ID でこの値を指定して、Experience Platformのオーディエンスオーディエンスをこのカスタムフィールドに入力します。

Salesforce のカスタムフィールドの例を以下に示します。
カスタムフィールドを示す Salesforce UI のスクリーンショット。

Salesforce CRM Mapping ID の場所を示す例を以下に示します。
オーディエンスの書き出しのスケジュールを示したExperience Platform UI のスクリーンショットの例。

上記のように、Salesforce Field Name は Salesforce CRM 内で指定された値と完全に一致 Mapping ID ます。

ユースケースに応じて、アクティブ化されたすべてのオーディエンスを同じ Salesforce カスタムフィールドまたは Field Name で異なる Salesforce CRM にマッピングできます。上記の画像に基づく典型的な例は、です。

Salesforce CRM セグメント名

Salesforce Field Name

Salesforce CRM Mapping ID

crm_1_seg

crm_1_seg

crm_2_seg

crm_2_seg

アクティブ化された各Experience Platform セグメントに対して、このセクションを繰り返します。

データの書き出しを検証する exported-data

宛先が正しく設定されていることを検証するには、次の手順に従います。

Destinations/Browse を選択して、宛先のリストに移動します。
宛先を選択し、ステータスが「enabled」であることを確認します。
「Activation data」タブに切り替えて、オーディエンス名を選択します。
オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数と一致していることを確認します。
最後に、Salesforce web サイトにログインし、オーディエンスのプロファイルが更新されたかどうかを検証します。

連絡先の操作
- Experience Platform セグメント内で 連絡先 を選択した場合は、Apps/Contacts ページに移動します。
- 連絡先 を選択し、フィールドが更新されているかどうかを確認します。 Salesforce CRM の各オーディエンスステータスが、Mapping ID オーディエンスのスケジュール設定の際に指定された値に基づいて、Experience Platformから対応するオーディエンスステータスに更新されたことがわかります。
リードの使用
- Experience Platform セグメント内で リード を選択した場合は、Apps/リー Leads ページに移動します。
- リード を選択し、フィールドが更新されたかどうかを確認します。 Salesforce CRM の各オーディエンスステータスが、Mapping ID オーディエンスのスケジュール設定の際に指定された値に基づいて、Experience Platformから対応するオーディエンスステータスに更新されたことがわかります。

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

エラーとトラブルシューティング errors-and-troubleshooting

イベントを宛先にプッシュする際に不明なエラーが発生しました unknown-errors

データフローの実行を確認すると、次のエラーメッセージが表示される場合があります。Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- このエラーを修正するには、アクティベーションワークフローで Mapping ID の宛先に指定した Salesforce CRM が、Salesforce で作成したカスタムフィールドタイプの値と完全に一致することを確認します。詳しくは、内でのカスタムフィールドの作成 Salesforce の節を参照してください。
セグメントをアクティブ化すると、次のエラーメッセージが表示される場合があります。The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- このエラーを修正するには、Salesforce アカウント管理者に連絡して、Experience Platformの IP アドレスを Salesforce アカウントの信頼できる IP 範囲に追加してください。追加のガイダンスが必要な場合は、Salesforce 接続されたアプリの信頼できる IP 範囲へのアクセスの制限ドキュメントを参照してください。

その他のリソース additional-resources

Salesforce開発者ポータルからのその他の役に立つ情報は次のとおりです。

クイックスタート
レコードの作成
カスタム推奨オーディエンス
複合リソースの使用
この宛先では、Upsert Single Record API 呼び出しの代わりに Upsert Multiple Records API を利用します。

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6