Salesforce CRM连接

概述 overview

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

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

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

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

Salesforce CRM支持两种与Salesforce REST API通信的身份验证机制:OAuth 2密码​和​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

注意Salesforce CRM中的以下先决条件,以将数据从Experience 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有关受众成员资格详细信息架构字段组的文档。

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

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

下面显示了Salesforce,步骤1 — 选择数据类型中的自定义字段创建示例:
显示自定义字段创建的Salesforce UI屏幕截图,步骤1 — 选择数据类型。 {modal="regular"}

Salesforce中的自定义字段创建示例,步骤2 — 输入自定义字段的详细信息,如下所示:
显示自定义字段创建的Salesforce UI屏幕截图,步骤2 — 输入自定义字段的详细信息。 {modal="regular"}

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

收集Salesforce CRM凭据 gather-credentials

在对Salesforce CRM目标进行身份验证之前,请记下以下项目。 所需的凭据取决于在对目标进行身份验证时选择的​身份验证类型。

OAuth 2密码

如果您选择​ OAuth 2密码 ​作为身份验证类型,请收集以下凭据。

凭据
描述
示例
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界面获取此值。

OAuth 2客户端凭据

如果您选择​ OAuth 2客户端凭据 ​作为身份验证类型,请收集以下凭据。 此选项允许您在不使用Salesforce用户名、密码或安全令牌的情况下使用服务帐户进行身份验证。

凭据
描述
示例
Subdomain
您的Salesforce域前缀。
请参阅Salesforce 文档以了解如何从Salesforce界面获取此值。
如果您的Salesforce域是
sampleorg.login.my.salesforce.com,
您需要提供sampleorg作为值。
Client ID
您的Salesforce Client ID。
请参阅Salesforce 文档以了解如何从Salesforce界面获取此值。
Client Secret
您的Salesforce Client Secret。
请参阅Salesforce 文档以了解如何从Salesforce界面获取此值。

护栏 guardrails

Salesforce通过强制实施请求、速率和超时限制来平衡事务加载。 有关详细信息,请参阅API请求限制和分配。

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

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

支持的身份 supported-identities

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

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

支持的受众 supported-audiences

此部分介绍哪些类型的受众可以导出到此目标。

受众来源
受支持
描述
Segmentation Service
是
通过Experience Platform 分段服务生成的受众。
所有其他受众来源
否

此类别包括通过Segmentation Service生成的受众之外的所有受众来源。 了解各种受众源。 一些示例包括:

  • 自定义上传受众从CSV文件导入到Experience Platform,
  • 相似的受众,
  • 联合受众,
  • 其他Experience Platform应用程序(如Adobe Journey Optimizer)中生成的受众,
  • 等等。

按受众数据类型划分的受众支持:

受众数据类型
受支持
描述
用例
人员受众
是
根据客户个人资料,允许您针对特定的营销活动人群组进行定位。
频繁购买者,购物车放弃者
帐户受众
否
针对特定组织内的个人,制定基于帐户的营销策略。
B2B营销
潜在客户受众
否
定位尚未成为客户但与目标受众具有共同特征的个人。
利用第三方数据发现潜在客户
数据集导出
否
存储在Adobe Experience Platform数据湖中的结构化数据的集合。
报告、数据科学工作流

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

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

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

连接到目标 connect

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

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

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

验证目标 authenticate

若要对目标进行身份验证,请选择​身份验证类型,填写下面的必填字段,然后选择​连接到目标。 有关任何指导,请参阅收集 Salesforce CRM 凭据部分。

OAuth 2密码

如果您选择​ OAuth 2密码 ​作为身份验证类型,请填写下面的字段。

凭据
描述
帐户名
帮助您识别Experience Platform中此目标连接的名称。 如果您与同一个目标有多个连接,这个名称将特别有用。
描述(可选)
帮助您或您的团队在Experience Platform中识别此目标连接的详细信息,如连接的目的或相关的业务上下文。
用户名
您的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。

显示如何使用OAuth 2密码进行身份验证的Experience Platform UI屏幕截图。 {modal="regular"}

OAuth 2客户端凭据

如果您选择​ OAuth 2客户端凭据 ​作为身份验证类型,请填写下面的字段。

凭据
描述
帐户名
帮助您识别Experience Platform中此目标连接的名称。 如果您与同一个目标有多个连接,这个名称将特别有用。
描述(可选)
帮助您或您的团队在Experience Platform中识别此目标连接的详细信息,如连接的目的或相关的业务上下文。
子域
您的Salesforce域前缀。
例如,如果您的域是​sampleorg.login.my.salesforce.com,则需要提供sampleorg作为值。
客户端ID
您的Salesforce Client ID。
客户端密码
您的Salesforce Client Secret。

显示如何使用OAuth 2客户端凭据进行身份验证的Experience Platform UI屏幕截图。 {modal="regular"}

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

填写目标详细信息 destination-details

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

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

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

  • Salesforce ID类型:

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

Experience Platform UI屏幕截图显示目标详细信息。 {modal="regular"}

启用警报 enable-alerts

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

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

激活此目标的受众 activate

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

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

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

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

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

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

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

  1. 在​ 映射 ​步骤中,选择​添加新映射,您将在屏幕上看到一个新映射行。
    用于添加新映射的Experience Platform UI屏幕快照示例。 {modal="regular"}

  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映射的Experience Platform UI屏幕快照示例。 {modal="regular"}

    使用潜在客户

    • 如果您正在区段中使用​潜在客户,请参阅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屏幕快照示例。 {modal="regular"}

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

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

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

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

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

以下显示了Salesforce中的自定义字段示例:
显示自定义字段的 Salesforce UI屏幕截图。 {modal="regular"}

下面显示了一个示例,用于指示Salesforce CRM 映射ID​的位置:
显示计划受众导出的Experience Platform UI屏幕截图示例。 {modal="regular"}

如上所示,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

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

验证数据导出 exported-data

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

  1. 选择​目标 > 浏览​以导航到目标列表,然后选择目标并验证状态为​已启用。
    Experience Platform UI屏幕截图显示具有目标状态的浏览目标。 {modal="regular"}

  2. 切换到​ 激活数据 ​选项卡,然后选择受众名称。
    显示目标激活数据的Experience Platform UI屏幕截图示例。 {modal="regular"}

  3. 监控受众摘要,并确保用户档案计数对应于在区段内创建的计数。
    显示区段的Experience Platform UI屏幕快照示例。 {modal="regular"}

  4. 最后,转到Salesforce网站并验证受众中的配置文件是否已更新。

    使用联系人

    • 如果您在Experience Platform区段中选择了​联系人,请导航到​Apps > Contacts​页面。
      Salesforce CRM屏幕截图显示了包含区段中的配置文件的“联系人”页面。 {modal="regular"}

    • 选择​ 联系人 ​并检查字段是否已更新。 您可以看到,根据受众计划期间提供的​ 映射ID ​值,Salesforce CRM中的每个受众状态都更新了Experience Platform中的相应受众状态。
      Salesforce CRM屏幕截图显示“联系人详细信息”页面,该页面具有更新的受众状态。 {modal="regular"}

    使用潜在客户

    • 如果您在Experience Platform区段中选择了​潜在客户,请导航到​Apps > Leads​页面。
      Salesforce CRM屏幕截图显示具有此区段中的配置文件的“潜在客户”页面。 {modal="regular"}

    • 选择​ 潜在客户 ​并检查字段是否已更新。 您可以看到,根据受众计划期间提供的​ 映射ID ​值,Salesforce CRM中的每个受众状态都更新了Experience Platform中的相应受众状态。
      Salesforce CRM屏幕截图显示具有更新受众状态的“潜在客户详细信息”页面。 {modal="regular"}

数据使用和治理 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屏幕快照显示错误。 {modal="regular"}

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