(API) Salesforce Marketing Cloud 连接

概述

(API) Salesforce Marketing Cloud (以前称为 ExactTarget)是一款数字营销套件，可让您为访客和客户构建和自定义历程，以个性化其体验。

比较对象 Salesforce Marketing Cloud Account Engagement 更加面向 B2B 营销， (API) Salesforce Marketing Cloud 目标非常适合 B2C 事务性决策周期较短的用例。 您可以合并表示目标受众行为的较大数据集，以通过优先排序和划分联系人（尤其是来自外部数据集）来调整和改进营销活动 Salesforce. 请注意，Experience Platform还连接了 Salesforce Marketing Cloud Account Engagement.

此 Adobe Experience Platform 目标 利用 Salesforce Marketing Cloud 更新联系人 API，允许您 添加联系人并更新联系人数据 满足贵机构的业务需求，并在新版本中激活它们 Salesforce Marketing Cloud 区段。

Salesforce Marketing Cloud 使用带有客户端凭据的OAuth 2作为身份验证机制以与 Salesforce Marketing Cloud API。 向您的验证的说明 Salesforce Marketing Cloud 实例位于 向目标进行身份验证 部分。

用例

为了帮助您更好地了解您应该如何以及何时使用 (API) Salesforce Marketing Cloud 目标，以下是Adobe Experience Platform客户可以使用此目标解决的示例用例。

向营销活动的联系人发送电子邮件

家庭租赁平台的销售部门希望向目标客户受众广播营销电子邮件。 平台的营销团队可以添加新联系人/更新现有联系人 （及其电子邮件地址） 通过Adobe Experience Platform，根据受众自己的离线数据构建受众，并将这些受众发送至 Salesforce Marketing Cloud，然后将其用于发送营销活动电子邮件。

先决条件

Experience Platform中的先决条件

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

中的先决条件 (API) Salesforce Marketing Cloud

请注意以下先决条件，以便将数据从Platform导出到 Salesforce Marketing Cloud 帐户：

您需要拥有 Salesforce Marketing Cloud 帐户

A Salesforce Marketing Cloud 订购 Marketing Cloud Engagement 必须提供产品才能继续。

联系 Salesforce 支持 如果您没有 Salesforce Marketing Cloud 帐户或您的帐户缺少 Marketing Cloud Engagement 产品订阅。

在中创建属性 Salesforce Marketing Cloud

将受众激活到 (API) Salesforce Marketing Cloud 目标，则必须在 映射Id 每个已激活受众的字段，位于 受众计划 步骤。

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

对于从Platform激活的每个受众 Salesforce Marketing Cloud，您需要创建类型的属性 Text 范围 Salesforce. 使用 Salesforce Marketing Cloud Contact Builder 创建属性。 属性字段名称用于 (API) Salesforce Marketing Cloud 以下时间内的目标字段 映射 步骤。 您可以根据业务需求定义最多4000个字符的字段字符。 请参阅 Salesforce Marketing Cloud 数据扩展数据类型 文档页面，以了解有关属性类型的更多信息。

请参阅 Salesforce Marketing Cloud 文档目标 创建属性 如果您需要有关创建属性的指导。

中的数据设计器屏幕示例 Salesforce Marketing Cloud，您将向其中添加属性，如下所示：

查看 Salesforce Marketing Cloud Email Demographics attribute-set如下所示：

此 (API) Salesforce Marketing Cloud 目标使用 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 以动态检索在中定义的属性及其属性集 Salesforce Marketing Cloud.

这些组件显示在 目标字段 选择窗口 映射 在至的工作流中 将受众激活到目标.

中的属性创建示例 Salesforce Marketing Cloud，如下所示：

在中分配用户角色和权限 Salesforce Marketing Cloud

作为 Salesforce Marketing Cloud 支持自定义角色根据您的用例，应该为您的用户分配相关的角色，以更新您的中的属性 Salesforce Marketing Cloud 属性集。 下面显示了分配给用户的角色示例：

根据您所使用的角色 Salesforce Marketing Cloud 用户已分配，您还需要将权限分配给 Salesforce Marketing Cloud 属性集，其中包含您要更新的字段。

由于此目标需要访问 attribute-set，您需要允许这些实例。 例如， Email attribute-set 您需要允许，如下所示：

要限制访问级别，您还可以使用粒度权限覆盖单个访问。

请参阅 Marketing Cloud Roles 和 Marketing Cloud Roles and Permissions 详细指导页面。

收集 Salesforce Marketing Cloud 凭据

在对进行身份验证之前，请记下以下各项 (API) Salesforce Marketing Cloud 目标。

护栏

• Salesforce施加了特定的 速率限制.
  • 请参阅 Salesforce Marketing Cloud 文档 解决您可能会遇到的任何可能限制并减少执行过程中的错误。
  • 请参阅 Salesforce Marketing Cloud 参与定价 页面至 下载完整版比较表 作为一个pdf，详细说明您的计划所施加的限制。
  • 此 API概述 页面详细信息其他限制。
  • 参考 此处 用于整理这些详细信息的页面。
• 计数 每个对象允许的自定义字段 因您的Salesforce版本而异。
  • 请参阅 Salesforce 文档 以获取更多指导。
  • 如果您已达到为定义的限制 每个对象允许的自定义字段 范围 Salesforce Marketing Cloud 您将需要
    • 在中添加新属性之前，请删除旧属性 Salesforce Marketing Cloud.
    • 更新或删除Platform目标中的任何激活受众，这些受众会使用这些较旧的属性名称作为提供的值 映射Id 时段 受众调度 步骤。

支持的身份

(API) Salesforce Marketing Cloud 支持激活下表中描述的标识。 了解有关 身份.

导出类型和频率

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

连接到目标

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

范围 目标 > 目录，搜索 (API) Salesforce Marketing Cloud. 或者，您可以将其定位到 电子邮件营销 类别。

向目标进行身份验证

要向目标进行身份验证，请填写以下必填字段并选择 连接到目标. 请参阅 收集 Salesforce Marketing Cloud 凭据 部分获取任何指导。

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

填写目标详细信息

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

• 名称：将来用于识别此目标的名称。
• 描述：可帮助您将来识别此目标的描述。

启用警报

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

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

将受众激活到此目标

读取 将用户档案和受众激活到流式受众导出目标 有关将受众激活到此目标的说明。

映射注意事项和示例

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

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

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

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

3. 在 选择目标字段 窗口中，选择 选择身份命名空间 并选择身份或选择 选择属性 类别，并根据需要从显示的属性集中选择一个属性。 此 (API) Salesforce Marketing Cloud 目标使用 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 动态检索在中定义的属性及其属性集 Salesforce Marketing Cloud. 这些组件显示在 目标字段 设置时弹出窗口 映射 在 激活受众工作流.

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

     源字段	目标字段	必需
     IdentityMap: contactKey	Identity: salesforceContactKey	Mandatory
     xdm: person.name.firstName	Attribute: First Name 所需的属性集。	-
     xdm: personalEmail.address	Attribute: Email Address 所需的属性集。	-

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

     

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

计划受众导出和示例

执行 计划受众导出 步骤，您必须手动将Platform受众映射到 属性 在 Salesforce Marketing Cloud.

要执行此操作，请选择每个区段，然后输入属性名称，该属性来自 Salesforce Marketing Cloud 在 (API) Salesforce Marketing Cloud 映射Id 字段。 请参阅 在中创建属性 Salesforce Marketing Cloud 有关在中创建属性的指导和最佳实践的部分 Salesforce Marketing Cloud.

例如，如果您的 Salesforce Marketing Cloud 属性为 salesforce_mc_segment_1，请在 (API) Salesforce Marketing Cloud 映射Id 用于将Experience Platform中的受众填充到此属性中。

示例属性来自 Salesforce Marketing Cloud 如下所示：

一个示例，指示 (API) Salesforce Marketing Cloud 映射Id 如下所示：

如所示 (API) Salesforce Marketing Cloud 映射Id 应当完全匹配中指定的值 Salesforce Marketing Cloud 字段名称.

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

根据您的用例，所有激活的受众都可以映射到相同的 Salesforce Marketing Cloud 字段名称 或变更为其他 字段名称 在 (API) Salesforce Marketing Cloud. 基于上述图像的典型示例可能是。
| (API) Salesforce Marketing Cloud 区段名称 | Salesforce Marketing Cloud 字段名称 | (API) Salesforce Marketing Cloud 映射Id | | — | — | — | | salesforce mc audience 1 | salesforce_mc_segment_1 | salesforce_mc_segment_1 | | salesforce mc audience 2 | salesforce_mc_segment_2 | salesforce_mc_segment_2 |

验证数据导出

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

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

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

3. 切换到 Activation data 选项卡，然后选择受众名称。
   

4. 监控受众摘要，并确保用户档案计数对应于在区段内创建的计数。
   

5. 登录到 Salesforce Marketing Cloud 网站。 然后导航到 Audience Builder > Contact Builder > All contacts > Email 页面，并检查是否已添加受众中的配置文件。
   

6. 要检查是否已更新任何用户档案，请导航到 电子邮件 页面，并验证受众中配置文件的属性值是否已更新。 如果成功，您可以在中看到每个受众状态 Salesforce Marketing Cloud 已根据，从Platform更新了相应的受众状态 映射Id 值在 受众调度 步骤。
   

数据使用和治理

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

错误和故障排除

将事件推送到SalesforceMarketing Cloud时遇到未知错误

• 检查数据流运行时，您可能会遇到以下错误消息： Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
  

  • 要修复此错误，请验证 映射Id 您在激活工作流中提供的电子邮件至 (API) Salesforce Marketing Cloud 目标与您在中创建的属性的名称完全匹配 Salesforce Marketing Cloud. 请参阅 在中创建属性 Salesforce Marketing Cloud 部分提供指导。

• 激活区段时，您可能会收到一条错误消息： The client's IP address is unauthorized for this account. Allowlist the client's IP address...

  • 要修复此错误，请联系贵机构的 Salesforce Marketing Cloud 要添加的客户管理员 Experience PlatformIP地址 敬您的 Salesforce Marketing Cloud 帐户的受信任IP范围。 请参阅 Salesforce Marketing Cloud 列入允许列表 Marketing Cloud中包含的IP地址 文档（如果您需要其他指导）。

其他资源

• Salesforce Marketing Cloud API
• Salesforce Marketing Cloud 文档 说明如何使用指定属性组中的指定信息更新联系人。

Changelog

此部分捕获此目标连接器的功能和重要文档更新。

Business.Adobe.com 资源