文档Experience Platform目标指南

Salesforce CRM连接

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined
  • undefined

概述 overview

Salesforce CRM是一个流行的客户关系管理(CRM)平台，它支持如下所述的配置文件类型：

  • 潜在客户 — 潜在客户是可能对您销售的产品或服务感兴趣（也可能不感兴趣）的人员或公司的名称。
  • 联系人 — 联系人是您的代表之一已建立关系并已被授予潜在客户资格的个人。

此Adobe Experience Platform 目标利用支持上述两种配置文件类型的Salesforce composite API。

在激活区段时，您可以在潜在客户或联系人之间进行选择，并将属性和受众数据更新到Salesforce CRM中。

Salesforce CRM使用带有密码授予的OAuth 2作为身份验证机制，与Salesforce REST API进行通信。 下面的向目标身份验证部分中进一步提供了向您的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

请注意Salesforce CRM中的以下先决条件，以便将数据从Platform导出到您的Salesforce帐户：

您需要拥有Salesforce帐户 prerequisites-account

转到Salesforce 试用版页面以注册并创建Salesforce帐户（如果尚未注册）。

在Salesforce中配置连接的应用 prerequisites-connected-app

首先，您需要在Salesforce帐户中配置Salesforce 连接的应用（如果尚未配置）。 Salesforce CRM将利用连接的应用连接到Salesforce。

接下来，为Salesforce connected app启用OAuth Settings for API Integration。 有关指导，请参阅Salesforce文档。

另外，请确保为Salesforce connected app选择下面提到的范围。

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

最后，确保在您的Salesforce帐户中启用password授权。 如果需要指导，请参阅Salesforce OAuth 2.0特殊方案的用户名 — 密码流程文档。

IMPORTANT
如果Salesforce帐户管理员限制了对受信任IP范围的访问，则需要联系他们以获取Experience Platform列入允许列表 IP的。 如果您需要其他指导，请参阅Salesforce 限制对连接应用程序的受信任IP范围的访问文档。

在Salesforce中创建自定义字段 prerequisites-custom-field

将受众激活到Salesforce CRM目标时，必须在​ 受众计划 ​步骤中为每个激活的受众在​ 映射ID ​字段中输入值。

Salesforce CRM需要此值才能正确读取和解释从Experience Platform传入的受众，并在Salesforce内更新其受众状态。 如果您需要受众状态的指导，请参阅受众成员资格详细信息架构字段组的Experience Platform文档。

对于从Platform激活到Salesforce CRM的每个受众，您需要在Salesforce中创建类型为Text Area (Long)的自定义字段。 您可以根据业务要求定义字段字符长度，长度不限，可为256 - 131,072个字符。 有关自定义字段类型的更多信息，请参阅Salesforce 自定义字段类型文档页面。 如果您在字段创建方面需要帮助，另请参阅Salesforce文档以创建自定义字段。

IMPORTANT
请勿在字段名称中包含空白字符。 请改用下划线(_)字符作为分隔符。
在Salesforce内，您必须为每个激活的Platform区段创建具有​ 字段名称 ​的自定义字段，该字段与​ 映射ID ​中指定的值完全匹配。 例如，下面的屏幕截图显示了一个名为crm_2_seg的自定义字段。 将受众激活到此目标时，请添加crm_2_seg作为​ 映射ID，以将受众从Experience Platform填充到此自定义字段中。

下面显示了Salesforce，步骤1 — 选择数据类型 中的自定义字段创建示例：
显示自定义字段创建的Salesforce UI屏幕截图，步骤1 — 选择数据类型。

Salesforce中的自定义字段创建示例，步骤2 — 输入自定义字段 的详细信息，如下所示：
显示自定义字段创建的Salesforce UI屏幕截图，步骤2 — 输入自定义字段的详细信息。

TIP
  • 为了区分用于Platform受众的自定义字段和Salesforce中的其他自定义字段，在创建自定义字段时可以包含可识别的前缀或后缀。 例如，使用Adobe_test_segment或test_segment_Adobe，而不是test_segment
  • 如果已在Salesforce中创建了其他自定义字段，则可以使用与Platform区段相同的名称，以便轻松地识别Salesforce中的受众。
NOTE
  • Salesforce中的对象限制为25个外部字段，请参阅自定义字段属性。
  • 此限制意味着在任何时候，最多只能有25个处于活动状态的Experience Platform受众成员资格。
  • 如果您在Salesforce中已达到此限制，则必须先从Salesforce中删除用于针对Experience Platform中的旧受众存储受众状态的自定义属性，然后才能使用新的​ 映射ID。

收集Salesforce CRM凭据 gather-credentials

在对Salesforce CRM目标进行身份验证之前，请记下以下项目：

凭据
描述
示例
Username
您的Salesforce帐户用户名。
Password
您的Salesforce帐户密码。
Security Token
您的Salesforce安全令牌，稍后将附加到您的Salesforce密码的末尾，以创建在向目标进行身份验证时用作​ 密码 ​的串联字符串。
请参阅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 PlatformIP地址添加到您的Salesforce帐户的受信任IP范围。 如果您需要其他指导，请参阅Salesforce 限制对连接应用程序的受信任IP范围的访问文档。

IMPORTANT
在激活区段时，您必须选择​ 联系人 ​或​ 潜在客户 ​类型。 您需要确保受众具有符合所选类型的相应数据映射。

支持的身份 supported-identities

Salesforce CRM支持更新下表中描述的标识。 了解有关标识的更多信息。

目标身份
描述
注意事项
SalesforceId
您通过区段导出或更新之联系人或潜在客户身份的Salesforce CRM标识符。
必需

导出类型和频率 export-type-frequency

有关目标导出类型和频率的信息，请参阅下表。

项目
类型
注释
导出类型
基于配置文件
  • 您正在根据字段映射导出区段的所有成员，以及所需的架构字段​ （例如：电子邮件地址、电话号码、姓氏）。
  • 根据受众计划步骤期间提供的​ 映射ID ​值，Salesforce CRM中的每个受众状态都将通过平台中的相应受众状态进行更新。
导出频率
正在流式传输
  • 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案，连接器就会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。

连接到目标 connect

IMPORTANT
若要连接到目标，您需要​ 查看目标 ​和​ 管理目标 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。

要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。

在​ 目标 > 目录 ​中，搜索Salesforce CRM。 或者，您可以在​ CRM ​类别下找到它。

验证目标 authenticate

要验证到目标，请填写下面的必填字段，然后选择​ 连接到目标。 有关任何指导，请参阅收集 Salesforce CRM 凭据部分。

凭据
描述
用户名
您的Salesforce帐户用户名。
密码
由附加了Salesforce安全令牌的Salesforce帐户密码组成的连接字符串。
连接值采用{PASSWORD}{TOKEN}的形式。
注意，不要使用任何大括号或空格。
例如，如果您的Salesforce密码为MyPa$$w0rd123，Salesforce安全令牌为TOKEN12345....0000，则您在​ 密码 ​字段中使用的串联值为MyPa$$w0rd123TOKEN12345....0000。
自定义域
您的Salesforce域前缀。
例如，如果您的域是​ d5i000000isb4eak-dev-ed.my.salesforce.com，则需要提供d5i000000isb4eak-dev-ed作为值。
客户端ID
您的Salesforce已连接应用程序Consumer Key。
客户端密码
您的Salesforce已连接应用程序Consumer Secret。

显示如何进行身份验证的平台UI屏幕截图。

如果提供的详细信息有效，则UI会以绿色复选标记显示​ 已连接 ​状态，然后您可以继续执行下一步。

填写目标详细信息 destination-details

要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。

  • 名称：将来用于识别此目标的名称。

  • 描述：可帮助您将来识别此目标的描述。

  • Salesforce ID类型：

    • 如果要导出或更新身份为​ 联系人 ​类型，请选择​ 联系人。
    • 如果要导出或更新身份为​ 潜在客户 ​类型，请选择​ 潜在客户。

显示目标详细信息的平台UI屏幕截图。

启用警报 enable-alerts

您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。

完成提供目标连接的详细信息后，选择​ 下一步。

激活此目标的受众 activate

IMPORTANT
  • 若要激活数据，您需要​ 查看目标、激活目标、查看配置文件 ​和​ 查看区段 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。
  • 要导出​ 标识，您需要​ 查看标识图形 访问控制权限。
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

有关将受众激活到此目标的说明，请阅读将配置文件和受众激活到流式受众导出目标。

映射注意事项和示例 mapping-considerations-example

要将受众数据从Adobe Experience Platform正确发送到Salesforce CRM目标，您需要完成字段映射步骤。 映射包括在您的Platform帐户中的Experience Data Model (XDM)架构字段与其在目标目标中的相应等效字段之间创建链接。

在​ 目标字段 ​中指定的属性的名称应与属性映射表中所述完全相同，因为这些属性将构成请求正文。

在​ Source字段 ​中指定的属性不遵循任何此类限制。 您可以根据需要进行映射，但请根据Salesforce 文档确保输入数据的格式有效。 如果输入数据无效，则对Salesforce的更新调用将失败，您的联系人/潜在客户将无法更新。

要将XDM字段正确映射到(API) Salesforce CRM目标字段，请执行以下步骤：

  1. 在​ 映射 ​步骤中，选择​ 添加新映射，您将在屏幕上看到一个新映射行。
    用于添加新映射的Platform UI屏幕快照示例。

  2. 在​ 选择源字段 ​窗口中，选择​ 选择属性 ​类别并选择XDM属性，或选择​ 选择身份命名空间 ​并选择身份。

  3. 在​ 选择目标字段 ​窗口中，选择​ 选择身份命名空间 ​并选择身份，或者根据需要选择​ 选择自定义属性 ​类别并选择属性或使用​ 属性名称 ​字段定义属性。 有关支持的属性的指导，请参阅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映射的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映射的Platform UI屏幕快照示例。

完成提供目标连接的映射后，请选择​ 下一步。

计划受众导出和示例 schedule-segment-export-example

在执行计划受众导出步骤时，您必须手动将从Platform激活的受众映射到Salesforce中相应的自定义字段。

为此，请选择每个区段，然后在Salesforce CRM 映射ID ​字段中输入来自Salesforce的自定义字段名称。 有关在Salesforce中创建自定义字段的指导和最佳实践，请参阅在 Salesforce中创建自定义字段。

例如，如果Salesforce自定义字段为crm_2_seg，请在Salesforce CRM 映射ID ​中指定此值以将Experience Platform的受众填充到此自定义字段中。

以下显示了Salesforce中的自定义字段示例：
Salesforce显示自定义字段的UI屏幕截图。

下面显示了一个示例，用于指示Salesforce CRM 映射ID ​的位置：
显示计划受众导出的Platform UI屏幕截图示例。

如上所示，Salesforce 字段名称 ​与Salesforce CRM 映射ID ​中指定的值完全匹配。

根据您的用例，所有激活的受众都可以映射到同一Salesforce自定义字段或Salesforce CRM中的不同​ 字段名称。 基于上述图像的典型示例可能是。

Salesforce CRM区段名称
Salesforce 字段名称
Salesforce CRM 映射ID
crm_1_seg
crm_1_seg
crm_1_seg
crm_2_seg
crm_2_seg
crm_2_seg

对每个激活的Platform区段重复此部分。

验证数据导出 exported-data

要验证您是否正确设置了目标，请执行以下步骤：

  1. 选择​ 目标 > 浏览 ​以导航到目标列表。
    显示浏览目标的Platform UI屏幕截图。

  2. 选择目标并验证状态为​ 已启用。
    显示目标数据流运行的平台UI屏幕截图。

  3. 切换到​ 激活数据 ​选项卡，然后选择受众名称。
    显示目标激活数据的Platform UI屏幕快照示例。

  4. 监控受众摘要，并确保用户档案计数对应于在区段内创建的计数。
    显示区段的Platform UI屏幕快照示例。

  5. 最后，登录Salesforce网站并验证受众中的配置文件是否已添加或更新。

    使用联系人

    • 如果您在您的Platform区段中选择了​ 联系人，请导航到​ Apps > Contacts ​页面。

      Salesforce CRM屏幕截图显示具有区段中的配置文件的“联系人”页面。

    • 选择​ 联系人 ​并检查字段是否已更新。 您可以看到，根据受众计划期间提供的​ 映射ID ​值，Salesforce CRM中的每个受众状态都更新为来自Platform的相应受众状态。

      Salesforce CRM屏幕截图显示“联系人详细信息”页面，该页面具有更新的受众状态。

    使用潜在客户

    • 如果您在您的Platform区段中选择了​ 潜在客户，请导航到​ Apps > Leads ​页面。

      Salesforce CRM屏幕截图显示具有此区段中的配置文件的“潜在客户”页面。

    • 选择​ 潜在客户 ​并检查字段是否已更新。 您可以看到，根据受众计划期间提供的​ 映射ID ​值，Salesforce CRM中的每个受众状态都更新为来自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.
    平台UI屏幕快照显示错误。

    • 要修复此错误，请验证您在激活工作流中提供的​ 映射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