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 帐户管理员限制了对受信任IP范围的访问,您需要联系他们以获取 Experience PlatformIP的 已列入允许列表 请参阅 Salesforce 限制对连接应用程序的受信任IP范围的访问 文档(如果您需要其他指导)。

在中创建自定义字段 Salesforce

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

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

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

重要

请勿在字段名称中包含空白字符。 请改用下划线 (_) 字符。
范围 Salesforce 您必须使用创建自定义字段 字段名称 与中指定的值完全匹配的值 映射Id 每个已激活的Platform区段。 例如,下面的屏幕快照显示了一个名为的自定义字段 crm_2_seg. 将区段激活到此目标时,添加 crm_2_seg 作为 映射Id 用于将Experience Platform中的区段受众填充到此自定义字段中。

中的自定义字段创建示例 Salesforce, 步骤1 — 选择数据类型,如下所示:
显示自定义字段创建的Salesforce UI屏幕快照,步骤1 — 选择数据类型。

中的自定义字段创建示例 Salesforce, 步骤2 — 输入自定义字段的详细信息,如下所示:
显示自定义字段创建的Salesforce UI屏幕快照,步骤2 — 输入自定义字段的详细信息。

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

收集 Salesforce CRM 凭据

在对进行身份验证之前,请记下以下各项 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 界面。

护栏

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

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

重要

时间 激活区段 您必须选择以下任一选项 联系人商机 类型。 您需要确保区段具有适合选定类型的数据映射。

支持的身份

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

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

导出类型和频率

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

项目 类型 注释
导出类型 基于配置文件
  • 您正在导出区段的所有成员以及所需的架构字段 (例如:电子邮件地址、电话号码、姓氏),根据您的字段映射。
  • 中的每个区段状态 Salesforce CRM 将根据 映射Id 在以下时段提供的值: 区段调度 步骤。
导出频率
  • 流目标为基于API的“始终运行”连接。 一旦根据区段评估在Experience Platform中更新了用户档案,连接器就会将更新发送到下游目标平台。 详细了解 流式目标.

连接到目标

重要

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

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

范围 目标 > 目录 搜索 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. |

显示如何进行身份验证的Platform UI屏幕快照。

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

填写目标详细信息

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

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

显示目标详细信息的Platform UI屏幕快照。

启用警报

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

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

将区段激活到此目标

重要

要激活数据,您需要 管理目标激活目标查看配置文件、和 查看区段 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。

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

映射注意事项和示例

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

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

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

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

  1. 映射 步骤,选择 添加新映射,您将在屏幕上看到一个新映射行。
    “添加新映射”的平台UI屏幕快照示例。

  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|联系人的电子邮件地址。 |

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

      显示Target映射的平台UI屏幕快照示例。

    使用潜在客户

    • 如果您使用的是 潜在客户 在区段中,请参阅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|商机的电子邮件地址。 |

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

      显示Target映射的平台UI屏幕快照示例。

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

计划区段导出和示例

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

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

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

中的自定义字段示例 Salesforce 如下所示:
Salesforce 显示自定义字段的UI屏幕快照。

一个示例,指示的位置 Salesforce CRM 映射Id 如下所示:
显示计划区段导出的平台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区段重复此部分。

验证数据导出

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

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

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

  3. 切换到 激活数据 选项卡,然后选择区段名称。
    显示目标激活数据的平台UI屏幕截图示例。

  4. 监控区段摘要,并确保配置文件计数对应于在区段内创建的计数。
    显示区段的平台UI屏幕快照示例。

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

    使用联系人

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

      Salesforce CRM屏幕快照,其中显示具有区段用户档案的“联系人”页面。

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

      Salesforce CRM屏幕截图,其中显示具有更新后的区段状态的“联系人详细信息”页面。

    使用潜在客户

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

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

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

      Salesforce CRM屏幕截图,其中显示具有更新的区段状态的“潜在客户详细信息”页面。

数据使用和管理

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

错误和疑难解答

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

  • 在检查数据流运行时,您可能会遇到以下错误消息: 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...

其他资源

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

在此页面上