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. |

显示如何进行身份验证的平台UI屏幕截图。

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

填写目标详细信息

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

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

显示目标详细信息的平台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开发人员门户 如下所示:

在此页面上