Salesforce CRM连接
概述 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_apilightningvisualforcecontentopenidfullapiwebrefresh_tokenoffline_access
最后，确保在您的Salesforce帐户中启用password授权。 如果需要指导，请参阅Salesforce OAuth 2.0特殊方案的用户名 — 密码流程文档。
在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文档以创建自定义字段。
(_)字符作为分隔符。在Salesforce内，您必须为每个激活的Platform区段创建具有 字段名称 的自定义字段，该字段与 映射ID 中指定的值完全匹配。 例如，下面的屏幕截图显示了一个名为
crm_2_seg的自定义字段。 将受众激活到此目标时，请添加crm_2_seg作为 映射ID，以将受众从Experience Platform填充到此自定义字段中。下面显示了Salesforce，步骤1 — 选择数据类型 中的自定义字段创建示例：
Salesforce中的自定义字段创建示例，步骤2 — 输入自定义字段 的详细信息，如下所示：
- 为了区分用于Platform受众的自定义字段和Salesforce中的其他自定义字段，在创建自定义字段时可以包含可识别的前缀或后缀。 例如，使用
Adobe_test_segment或test_segment_Adobe，而不是test_segment - 如果已在Salesforce中创建了其他自定义字段，则可以使用与Platform区段相同的名称，以便轻松地识别Salesforce中的受众。
- Salesforce中的对象限制为25个外部字段，请参阅自定义字段属性。
- 此限制意味着在任何时候，最多只能有25个处于活动状态的Experience Platform受众成员资格。
- 如果您在Salesforce中已达到此限制，则必须先从Salesforce中删除用于针对Experience Platform中的旧受众存储受众状态的自定义属性，然后才能使用新的 映射ID。
收集Salesforce CRM凭据 gather-credentials
在对Salesforce CRM目标进行身份验证之前，请记下以下项目：
UsernamePasswordSecurity TokenCustom Domain请参阅Salesforce 文档以了解如何从Salesforce界面获取此值。
d5i000000isb4eak-dev-ed.my.salesforce.com，需要
d5i000000isb4eak-dev-ed作为值。Client IDClient Secret护栏 guardrails
Salesforce通过强制实施请求、速率和超时限制来平衡事务加载。 有关详细信息，请参阅API请求限制和分配。
如果Salesforce帐户管理员已强制执行IP限制，则需要将Experience PlatformIP地址添加到您的Salesforce帐户的受信任IP范围。 如果您需要其他指导，请参阅Salesforce 限制对连接应用程序的受信任IP范围的访问文档。
支持的身份 supported-identities
Salesforce CRM支持更新下表中描述的标识。 了解有关标识的更多信息。
SalesforceId导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息，请参阅下表。
- 您正在根据字段映射导出区段的所有成员，以及所需的架构字段 （例如：电子邮件地址、电话号码、姓氏）。
- 根据受众计划步骤期间提供的 映射ID 值，Salesforce CRM中的每个受众状态都将通过平台中的相应受众状态进行更新。
- 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案，连接器就会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。
连接到目标 connect
要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。
在 目标 > 目录 中，搜索Salesforce CRM。 或者，您可以在 CRM 类别下找到它。
验证目标 authenticate
要验证到目标，请填写下面的必填字段，然后选择 连接到目标。 有关任何指导，请参阅收集 Salesforce CRM 凭据部分。
连接值采用
{PASSWORD}{TOKEN}的形式。注意，不要使用任何大括号或空格。
例如，如果您的Salesforce密码为
MyPa$$w0rd123，Salesforce安全令牌为TOKEN12345....0000，则您在 密码 字段中使用的串联值为MyPa$$w0rd123TOKEN12345....0000。例如，如果您的域是
d5i000000isb4eak-dev-ed.my.salesforce.com，则需要提供d5i000000isb4eak-dev-ed作为值。Consumer Key。Consumer Secret。
如果提供的详细信息有效，则UI会以绿色复选标记显示 已连接 状态，然后您可以继续执行下一步。
填写目标详细信息 destination-details
要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
-
名称：将来用于识别此目标的名称。
-
描述：可帮助您将来识别此目标的描述。
-
Salesforce ID类型：
- 如果要导出或更新身份为 联系人 类型，请选择 联系人。
- 如果要导出或更新身份为 潜在客户 类型，请选择 潜在客户。
启用警报 enable-alerts
您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。
完成提供目标连接的详细信息后，选择 下一步。
激活此目标的受众 activate
有关将受众激活到此目标的说明，请阅读将配置文件和受众激活到流式受众导出目标。
映射注意事项和示例 mapping-considerations-example
要将受众数据从Adobe Experience Platform正确发送到Salesforce CRM目标，您需要完成字段映射步骤。 映射包括在您的Platform帐户中的Experience Data Model (XDM)架构字段与其在目标目标中的相应等效字段之间创建链接。
在 目标字段 中指定的属性的名称应与属性映射表中所述完全相同，因为这些属性将构成请求正文。
在 Source字段 中指定的属性不遵循任何此类限制。 您可以根据需要进行映射，但请根据Salesforce 文档确保输入数据的格式有效。 如果输入数据无效，则对Salesforce的更新调用将失败，您的联系人/潜在客户将无法更新。
要将XDM字段正确映射到(API) Salesforce CRM目标字段，请执行以下步骤：
-
在 映射 步骤中，选择 添加新映射，您将在屏幕上看到一个新映射行。
-
在 选择源字段 窗口中，选择 选择属性 类别并选择XDM属性，或选择 选择身份命名空间 并选择身份。
-
在 选择目标字段 窗口中，选择 选择身份命名空间 并选择身份，或者根据需要选择 选择自定义属性 类别并选择属性或使用 属性名称 字段定义属性。 有关支持的属性的指导，请参阅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: crmIDIdentity: SalesforceIdMandatoryxdm: person.name.lastNameAttribute: LastNameMandatory的问题。联系人的姓氏，最多80个字符。xdm: person.name.firstNameAttribute: FirstName联系人的名字最多可包含40个字符。 xdm: personalEmail.addressAttribute: Email联系人的电子邮件地址。 -
下面显示了使用这些映射的示例：
使用潜在客户
-
如果您正在区段中使用 潜在客户，请参阅Salesforce中的潜在客户的对象引用，以便为要更新的字段定义映射。
-
您可以通过搜索单词 必需 来标识必填字段，上述链接中的字段描述中提到了该单词。
-
根据要导出或更新字段，在XDM配置文件架构和(API) Salesforce CRM之间添加映射：
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 源字段 目标字段 注释 IdentityMap: crmIDIdentity: SalesforceIdMandatoryxdm: person.name.lastNameAttribute: LastNameMandatory的问题。潜在客户的姓氏最多为80个字符。xdm: b2b.companyNameAttribute: CompanyMandatory的问题。潜在客户的公司。xdm: personalEmail.addressAttribute: Email商机的电子邮件地址。 -
下面显示了使用这些映射的示例：
完成提供目标连接的映射后，请选择 下一步。
计划受众导出和示例 schedule-segment-export-example
在执行计划受众导出步骤时，您必须手动将从Platform激活的受众映射到Salesforce中相应的自定义字段。
为此，请选择每个区段，然后在Salesforce CRM 映射ID 字段中输入来自Salesforce的自定义字段名称。 有关在Salesforce中创建自定义字段的指导和最佳实践，请参阅在 Salesforce中创建自定义字段。
例如，如果Salesforce自定义字段为crm_2_seg，请在Salesforce CRM 映射ID 中指定此值以将Experience Platform的受众填充到此自定义字段中。
以下显示了Salesforce中的自定义字段示例：
下面显示了一个示例，用于指示Salesforce CRM 映射ID 的位置：
如上所示，Salesforce 字段名称 与Salesforce CRM 映射ID 中指定的值完全匹配。
根据您的用例，所有激活的受众都可以映射到同一Salesforce自定义字段或Salesforce CRM中的不同 字段名称。 基于上述图像的典型示例可能是。
crm_1_segcrm_1_segcrm_2_segcrm_2_seg对每个激活的Platform区段重复此部分。
验证数据导出 exported-data
要验证您是否正确设置了目标，请执行以下步骤：
-
选择 目标 > 浏览 以导航到目标列表。
-
选择目标并验证状态为 已启用。
-
切换到 激活数据 选项卡，然后选择受众名称。
-
监控受众摘要，并确保用户档案计数对应于在区段内创建的计数。
-
最后，登录Salesforce网站并验证受众中的配置文件是否已添加或更新。
使用联系人
-
如果您在您的Platform区段中选择了 联系人，请导航到 Apps > Contacts 页面。
-
选择 联系人 并检查字段是否已更新。 您可以看到，根据受众计划期间提供的 映射ID 值，Salesforce CRM中的每个受众状态都更新为来自Platform的相应受众状态。
使用潜在客户
-
如果您在您的Platform区段中选择了 潜在客户，请导航到 Apps > Leads 页面。
-
选择 潜在客户 并检查字段是否已更新。 您可以看到，根据受众计划期间提供的 映射ID 值，Salesforce CRM中的每个受众状态都更新为来自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.
- 要修复此错误，请验证您在激活工作流中提供的 映射ID 到Salesforce CRM目标的值与您在Salesforce中创建的自定义字段类型的值是否完全匹配。 有关指导，请参阅在 Salesforce中创建自定义字段。
-
激活区段时，您可能会收到错误消息：
The client's IP address is unauthorized for this account. Allowlist the client's IP address...- 若要修复此错误，请与Salesforce帐户管理员联系，将Experience PlatformIP地址添加到你的Salesforce帐户的受信任IP范围。 如果您需要其他指导，请参阅Salesforce 限制对连接应用程序的受信任IP范围的访问文档。
其他资源 additional-resources
来自Salesforce开发人员门户的其他有用信息如下：
- 快速入门
- 创建记录
- 自定义推荐受众
- 使用复合资源
- 此目标利用Upsert Multiple Records API而不是Upsert Single Record API调用。