ドキュメントExperience Platform宛先ガイド

Salesforce CRM 接続

Last update: Thu Mar 26 2026 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宛先にデータをアクティブ化する前に、で スキーマ 、 データセット 、および セグメント 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 Username-Password フローを参照してください。 ドキュメント

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

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制限を適用している場合は、Experience Platform IP アドレス ​をSalesforce アカウントの信頼できるIP範囲に追加する必要があります。 追加のガイダンスが必要な場合は、Salesforce 接続アプリの信頼できるIP範囲へのアクセスの制限 ドキュメントを参照してください。

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

サポートされる ID supported-identities

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

ターゲット ID
説明
注意点
SalesforceId
セグメントを通じてエクスポートまたは更新した連絡先またはリード IDのSalesforce CRM識別子。
必須

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスの由来
サポートあり
説明
Segmentation Service
○
Experience Platform ​ セグメント化サービス ​を通じて生成されたオーディエンス。
その他すべてのオーディエンスの生成元
×

このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。

  • カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
  • 類似オーディエンス，
  • 連合オーディエンス，
  • Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
  • その他。

オーディエンスのデータタイプ別にサポートされるオーディエンス：

オーディエンスのデータタイプ
サポートあり
説明
ユースケース
人物オーディエンス ​
○
顧客プロファイルにもとづいて、マーケティング施策の特定のグループをターゲットにすることができます。
買い物客やカートの放棄が多い
​ アカウントオーディエンス ​
×
アカウントベースドマーケティング戦略のために、特定の組織内の個人をターゲットにします。
B2B マーケティング
見込みオーディエンス ​
×
まだ顧客ではないが、ターゲットオーディエンスと特徴を共有する個人をターゲットにします。
サードパーティデータによる見込み顧客の開拓
​ データセットの書き出し
×
Adobe Experience Platform データ レイクに保存されている構造化データのコレクション。
レポート，データサイエンスワークフロー

書き出しのタイプと頻度 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​を選択します。 ガイダンスについては、収集 Salesforce CRM 資格情報 セクションを参照してください。

資格情報
説明
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 ​ アクセス制御権限が必要です。
    ​ ワークフローで強調表示されているID名前空間を選択して、オーディエンスを宛先にアクティブ化します。 {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 宛先フィールドに正しくマッピングするには、次の手順に従います。

  1. Mapping ステップで「Add new mapping」を選択すると、新しいマッピング行が画面に表示されます。
    新しいマッピングを追加するExperience Platform UIのスクリーンショット例。

  2. Select source field ウィンドウで、Select attributes カテゴリを選択してXDM属性を選択するか、Select identity namespace​を選択してIDを選択します。

  3. 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 連絡先のメールアドレス。

    • これらのマッピングの使用例を次に示します。
      Target マッピングを示すExperience Platform UI スクリーンショットの例。

    リードの操作

    • セグメント内で​ リード ​を操作している場合は、​ リード ​の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 リードのメールアドレス。

    • これらのマッピングの使用例を次に示します。
      Target マッピングを示すExperience Platform UI スクリーンショットの例。

宛先接続のマッピングの提供が完了したら、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_1_seg
crm_2_seg
crm_2_seg
crm_2_seg

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

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

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

  1. 宛先のリストに移動するには、Destinations > Browse​を選択します。
    宛先を参照を示すExperience Platform UIのスクリーンショット。

  2. 宛先を選択し、ステータスが​ enabled ​であることを検証します。
    宛先データフロー実行を示す Experience Platform UIのスクリーンショット。

  3. 「Activation data」タブに切り替えて、オーディエンス名を選択します。
    宛先アクティベーションデータを示す Experience Platform UI スクリーンショットの例。

  4. オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数に対応していることを確認します。
    セグメントを示す Experience Platform UI スクリーンショットの例。

  5. 最後に、Salesforceのweb サイトに移動し、オーディエンスのプロファイルが更新されているかどうかを検証します。

    連絡先の操作

    • Experience Platform セグメント内で​ 連絡先 ​を選択した場合は、Apps > Contacts ページに移動します。
      セグメントのプロファイルを含む連絡先ページを示すSalesforce CRMのスクリーンショット。

    • 連絡先​を選択し、フィールドが更新されているかどうかを確認します。 Salesforce CRMの各オーディエンスステータスが、Mapping ID オーディエンススケジュール 中に提供された値に基づいて、Experience Platformからの対応するオーディエンスステータスで更新されていることがわかります。
      オーディエンスのステータスが更新された連絡先の詳細ページを示すSalesforce CRMのスクリーンショット。

    リードの操作

    • Experience Platform セグメント内で​ リード ​を選択した場合は、Apps > Leads ページに移動します。
      セグメントのプロファイルを含むリードページを示すSalesforce CRMのスクリーンショット。

    • リード​を選択し、フィールドが更新されているかどうかを確認します。 Salesforce CRMの各オーディエンスステータスが、Mapping ID オーディエンススケジュール 中に提供された値に基づいて、Experience Platformからの対応するオーディエンスステータスで更新されていることがわかります。
      オーディエンスのステータスが更新されたリードの詳細ページを示すSalesforce CRMのスクリーンショット。

データの使用とガバナンス 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.
    エラーを示す Experience Platform UI スクリーンショット。

    • このエラーを修正するには、アクティベーションワークフローで​ Mapping ID ​宛先に指定したSalesforce CRMが、Salesforceで作成したカスタムフィールドタイプの値と完全に一致することを確認してください。 ガイダンスについては、内の Salesforce カスタムフィールドの作成の節を参照してください。

  • セグメントをアクティブ化すると、次のエラーメッセージが表示される場合があります：The client's IP address is unauthorized for this account. Allowlist the client's IP address...

その他のリソース additional-resources

Salesforce デベロッパーポータル ​の役に立つ追加情報を以下に示します。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6