Salesforce CRM 连接

概述

Salesforce CRM 是一个流行的客户关系管理(CRM)平台，它支持以下内容：

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

此 Adobe Experience Platform 目标 利用 Salesforce composite API，它支持上述两种类型的用户档案。

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

Salesforce CRM 将带有密码授予的OAuth 2用作与Salesforce REST API通信的身份验证机制。 向您的验证的说明 Salesforce CRM 实例位于 向目标进行身份验证 部分。

用例

作为营销人员，您可以根据用户的Adobe Experience Platform配置文件中的属性，为其提供个性化体验。 您可以从离线数据构建区段，并将这些区段发送到Salesforce CRM，以在Adobe Experience Platform中更新区段和配置文件后立即显示在用户的馈送中。

先决条件

Experience Platform中的先决条件

在将数据激活到Salesforce CRM目标之前，您必须拥有 架构， a 数据集、和 区段 创建于 Experience Platform.

中的先决条件 Salesforce CRM

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

您需要拥有 Salesforce 帐户

转到 Salesforce 试用版 页面以注册和创建 Salesforce 帐户（如果您还没有帐户）。

在中配置连接的应用程序 Salesforce

首先，您需要配置 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用户名 — 密码流程 文档（如果您需要指南）。

在中创建自定义字段 Salesforce

将区段激活到 Salesforce CRM 目标，则必须在 映射Id 每个已激活区段的字段，位于 区段计划 步骤。

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

对于您从Platform激活到的每个区段 Salesforce CRM，您需要创建类型的自定义字段 Text Area (Long) 范围 Salesforce. 您可以根据业务需求定义任意大小的字段字符长度，长度为256 - 131,072个字符。 请参阅 Salesforce 自定义字段类型 文档页面，以了解有关自定义字段类型的更多信息。 另请参阅 Salesforce 文档目标 创建自定义字段 如果您在字段创建方面需要帮助。

中的自定义字段创建示例 Salesforce， 步骤1 — 选择数据类型，如下所示：

中的自定义字段创建示例 Salesforce， 步骤2 — 输入自定义字段的详细信息，如下所示：

收集 Salesforce CRM 凭据

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

护栏

Salesforce 通过设置请求、速率和超时限制来平衡事务加载。 请参阅 API请求限制和分配 了解详细信息。

如果您的 Salesforce 帐户管理员已强制执行IP限制，您需要添加 Experience PlatformIP地址 敬您的 Salesforce 帐户的受信任IP范围。 请参阅 Salesforce 限制对连接应用程序的受信任IP范围的访问 文档（如果您需要其他指导）。

支持的身份

Salesforce CRM 支持更新下表中描述的标识。 详细了解 身份.

导出类型和频率

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

连接到目标

要连接到此目标，请按照 目标配置教程. 在配置目标工作流中，填写下面两节中列出的字段。

范围 目标 > 目录 搜索 Salesforce CRM. 或者，您也可以在 CRM 类别。

向目标进行身份验证

要向目标进行身份验证，请填写以下必填字段并选择 连接到目标. 请参阅 收集 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中字段旁边的星号表示该字段为必填字段。

• 名称：将来用于识别此目标的名称。
• 描述：可帮助您将来识别此目标的描述。
• Salesforce ID类型：
  • 选择 联系人 如果您要导出或更新身份属于类型 联系人.
  • 选择 商机 如果您要导出或更新身份属于类型 商机.

启用警报

您可以启用警报，以接收有关流向目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的更多信息，请参阅以下指南中的 使用UI订阅目标警报.

完成提供目标连接的详细信息后，选择 下一个.

将区段激活到此目标

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

映射注意事项和示例

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

中指定的属性 目标字段 应按照“属性映射”表中的说明进行命名，因为这些属性将构成请求正文。

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

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

1. 在 映射 步骤，选择 添加新映射，您将在屏幕上看到一个新映射行。
   

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

3. 在 选择目标字段 窗口中，选择 选择身份命名空间 并选择身份或选择 选择自定义属性 类别并选择属性，或者使用 属性名称 字段。 请参阅 Salesforce CRM 文档 以获取有关支持的属性的指导。

   • 重复这些步骤以在XDM配置文件架构和 (API) Salesforce CRM：

   使用联系人

   • 如果您使用的是 联系人 在区段中，请参阅Salesforce中的对象引用，以了解 联系人 为要更新的字段定义映射。

   • 您可以通过搜索单词来标识必填字段 必需，如上述链接中的字段描述中所述。

   • 根据要导出或更新字段，在XDM配置文件架构和 (API) Salesforce CRM： |源字段|目标字段|注释 | | — | — | — | |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： |源字段|目标字段|注释 | | — | — | — | |IdentityMap: crmID|Identity: SalesforceId|Mandatory| |xdm: person.name.lastName|Attribute: LastName| Mandatory. 潜在客户的姓氏最多为80个字符。 |\

     |xdm: b2b.companyName|Attribute: Company| Mandatory. 潜在客户的公司。 | |xdm: personalEmail.address|Attribute: Email|商机的电子邮件地址。 |

   • 下面显示了使用这些映射的示例：

     

完成提供目标连接的映射后，选择 下一个.

计划区段导出和示例

执行 计划区段导出 步骤您必须手动将从Platform激活的区段映射到中对应的自定义字段 Salesforce.

要实现此目的，请选择每个区段，然后从中输入自定义字段名称 Salesforce 在 Salesforce CRM 映射Id 字段。 请参阅 在中创建自定义字段 Salesforce 有关在中创建自定义字段的指导和最佳实践的部分 Salesforce.

例如，如果您的 Salesforce 自定义字段为 crm_2_seg，请在 Salesforce CRM 映射Id 用于将Experience Platform中的区段受众填充到此自定义字段中。

中的自定义字段示例 Salesforce 如下所示：

一个示例，指示的位置 Salesforce CRM 映射Id 如下所示：

如上所示 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区段重复此部分。

验证数据导出

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

1. 选择 目标 > 浏览 导航到目标列表。
   

2. 选择目标并验证状态为 已启用.
   

3. 切换到 激活数据 选项卡，然后选择区段名称。
   

4. 监控区段摘要，并确保配置文件计数对应于在区段内创建的计数。
   

5. 最后，登录Salesforce网站并验证区段中的用户档案是否已添加或更新。

   使用联系人

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

     

   • 选择 联系人 并检查字段是否已更新。 您可以在中看到每个区段状态 Salesforce CRM 已根据，从Platform更新了相应的区段状态 映射Id 在以下时段提供的值： 区段调度.

     

   使用潜在客户

   • 如果已选择 潜在客户 在Platform区段中，导航到 Apps > Leads 页面。

     

   • 选择 商机 并检查字段是否已更新。 您可以在中看到每个区段状态 Salesforce CRM 已根据，从Platform更新了相应的区段状态 映射Id 在以下时段提供的值： 区段调度.

     

数据使用和管理

全部 Adobe Experience Platform 目标在处理您的数据时符合数据使用策略。 有关以下方面的详细信息： Adobe Experience Platform 强制执行数据管理，请参见 数据治理概述.

错误和疑难解答

将事件推送到目标时遇到了未知错误

• 在检查数据流运行时，您可能会遇到以下错误消息： 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范围的访问 文档（如果您需要其他指导）。

其他资源

其他有用信息来自 Salesforce开发人员门户 如下所示：

• 快速入门
• 创建记录
• 自定义推荐受众
• 使用复合资源
• 此目标利用 更新插入多个记录 API而不是 更新插入单个记录 API调用。

Business.Adobe.com 资源