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中的以下先决条件，以便将数据从Experience Platform导出到您的Salesforce帐户：
您需要拥有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_apilightningvisualforcecontentopenidfullapiwebrefresh_tokenoffline_access
最后，确保在您的password帐户中启用Salesforce授权。 如果需要指导，请参阅Salesforce OAuth 2.0特殊方案的用户名 — 密码流程文档。
在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文档以创建自定义字段。
(_)字符作为分隔符。在Salesforce内，您必须创建其自定义字段的Field Name，该字段与在 Mapping ID 内为每个激活的Experience Platform区段指定的值完全匹配。 例如，下面的屏幕截图显示了一个名为
crm_2_seg的自定义字段。 将受众激活到此目标时，请将crm_2_seg添加为 Mapping ID 以将受众从Experience Platform填充到此自定义字段中。下面显示了Salesforce，步骤1 — 选择数据类型中的自定义字段创建示例：
Salesforce中的自定义字段创建示例，步骤2 — 输入自定义字段的详细信息，如下所示：
- 为了区分用于Experience Platform受众的自定义字段和Salesforce中的其他自定义字段，在创建自定义字段时可以包含可识别的前缀或后缀。 例如，使用
test_segment或Adobe_test_segment，而不是test_segment_Adobe - 如果已在Salesforce中创建了其他自定义字段，则可以使用与Experience Platform区段相同的名称，以便轻松地识别Salesforce中的受众。
- Salesforce中的对象限制为25个外部字段，请参阅自定义字段属性。
- 此限制意味着在任何时候，您最多只能有25个Experience Platform受众成员处于活动状态。
- 如果您在Salesforce中达到了此限制，则必须先从Salesforce中删除用于根据Experience Platform中的旧受众存储受众状态的自定义属性，然后才能使用新的Mapping 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 Platform IP地址添加到您的Salesforce帐户的受信任IP范围。 如果您需要其他指导，请参阅Salesforce 限制对连接应用程序的受信任IP范围的访问文档。
支持的身份 supported-identities
Salesforce CRM支持更新下表中描述的标识。 了解有关标识的更多信息。
SalesforceId导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息，请参阅下表。
- 您正在根据字段映射导出区段的所有成员，以及所需的架构字段（例如：电子邮件地址、电话号码、姓氏）。
- 根据Salesforce CRM受众计划 Mapping ID 步骤期间提供的值，中的每个受众状态都会根据Experience Platform中的相应受众状态进行更新。
- 流目标为基于API的“始终运行”连接。 根据受众评估在Experience Platform中更新用户档案后，连接器会立即将更新发送到下游目标平台。 阅读有关流式目标的更多信息。
连接到目标 connect
要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。
在Destinations > Catalog内，搜索Salesforce CRM。 或者，您可以在 CRM 类别下找到它。
验证目标 authenticate
要验证目标，请填写下面的必填字段并选择Connect to destination。 有关任何指导，请参阅收集 Salesforce CRM 凭据部分。
连接值采用
{PASSWORD}{TOKEN}的形式。注意，不要使用任何大括号或空格。
例如，如果您的Salesforce密码为
MyPa$$w0rd123，Salesforce安全令牌为TOKEN12345....0000，则您在 Password 字段中使用的串联值为MyPa$$w0rd123TOKEN12345....0000。例如，如果您的域是
d5i000000isb4eak-dev-ed.my.salesforce.com，则需要提供d5i000000isb4eak-dev-ed作为值。Consumer Key。Consumer Secret。
如果提供的详细信息有效，则UI会以绿色复选标记显示 Connected 状态，之后您可以继续执行下一步。
填写目标详细信息 destination-details
要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
-
Name：将来用于识别此目标的名称。
-
Description：可帮助您将来识别此目标的描述。
-
Salesforce ID Type：
- 如果要导出或更新身份为 Contact 联系人类型，请选择。
- 如果要导出或更新身份为 Lead 潜在客户类型，请选择。
启用警报 enable-alerts
您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。
完成提供目标连接的详细信息后，选择Next。
激活此目标的受众 activate
有关将受众激活到此目标的说明，请阅读将配置文件和受众激活到流式受众导出目标。
映射注意事项和示例 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 并选择身份。
-
在 Select target field 窗口中，选择 Select identity namespace 并选择身份或选择 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: 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商机的电子邮件地址。 -
下面显示了使用这些映射的示例：
完成提供目标连接的映射后，请选择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 CRM Mapping ID位置的示例：
如上所示，Salesforce Field Name与Salesforce CRM Mapping ID中指定的值完全匹配。
根据您的用例，所有激活的受众都可以映射到同一Salesforce自定义字段或 Field Name 中的不同Salesforce CRM。 基于上述图像的典型示例可能是。
crm_1_segcrm_1_segcrm_2_segcrm_2_seg对每个激活的Experience Platform区段重复此部分。
验证数据导出 exported-data
要验证您是否正确设置了目标，请执行以下步骤：
-
选择Destinations > Browse以导航到目标列表。
-
选择目标并验证状态为enabled。
-
切换到 Activation data 选项卡，然后选择受众名称。
-
监控受众摘要，并确保用户档案计数对应于在区段内创建的计数。
-
最后，登录Salesforce网站并验证受众中的配置文件是否已更新。
使用联系人
-
如果您在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 Multiple Records API而不是Upsert Single Record API调用。