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中更新区段和配置文件后立即显示在用户的馈送中。
在将数据激活到Salesforce CRM目标之前,您必须拥有 架构, a 数据集、和 区段 创建于 Experience Platform.
请注意中的以下先决条件 Salesforce CRM,以便将数据从Platform导出到您的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 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, 步骤2 — 输入自定义字段的详细信息,如下所示:
test_segment
,使用 Adobe_test_segment
或 test_segment_Adobe
在对进行身份验证之前,请记下以下各项 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. 或者,您也可以在 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订阅目标警报.
完成提供目标连接的详细信息后,选择 下一个.
读取 将配置文件和区段激活到流式区段导出目标 有关将受众区段激活到此目标的说明。
要正确地将受众数据从Adobe Experience Platform发送到 Salesforce CRM 目标,您需要完成字段映射步骤。 映射包括在Platform帐户中的Experience Data Model (XDM)架构字段与其与目标目标中的相应等效字段之间创建链接。
中指定的属性 目标字段 应按照“属性映射”表中的说明进行命名,因为这些属性将构成请求正文。
中指定的属性 源字段 请勿遵守任何此类限制。 您可以根据需要进行映射,但请确保输入数据的格式根据 Salesforce 文档. 如果输入数据无效,则更新调用 Salesforce 将失败,您的联系人/潜在客户将无法更新。
要将XDM字段正确映射到 (API) Salesforce CRM 目标字段,请执行以下步骤:
在 映射 步骤,选择 添加新映射,您将在屏幕上看到一个新映射行。
在 选择源字段 窗口中,选择 选择属性 类别并选择XDM属性或选择 选择身份命名空间 并选择身份。
在 选择目标字段 窗口中,选择 选择身份命名空间 并选择身份或选择 选择自定义属性 类别并选择属性,或者使用 属性名称 字段。 请参阅 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区段重复此部分。
要验证您是否正确设置了目标,请执行以下步骤:
选择 目标 > 浏览 导航到目标列表。
选择目标并验证状态为 已启用.
切换到 激活数据 选项卡,然后选择区段名称。
监控区段摘要,并确保配置文件计数对应于在区段内创建的计数。
最后,登录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.
激活区段时,您可能会收到一条错误消息: The client's IP address is unauthorized for this account. Allowlist the client's IP address...
其他有用信息来自 Salesforce开发人员门户 如下所示: