(API) Salesforce Marketing Cloud连接

概述 overview

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

IMPORTANT
请注意此连接与电子邮件营销目录分区中存在的其他Salesforce Marketing Cloud 连接之间的区别。 另一个SalesforceMarketing Cloud连接允许您将文件导出到指定的存储位置,而这是一个基于API的流连接。

与更面向​ B2B ​营销的Salesforce Marketing Cloud Account Engagement相比,(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实例进行身份验证的说明。

用例 use-cases

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

向营销活动的联系人发送电子邮件 use-case-send-emails

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

先决条件 prerequisites

Experience Platform中的先决条件 prerequisites-in-experience-platform

在将数据激活到(API) Salesforce Marketing Cloud目标之前,您必须在Experience Platform中创建一个架构数据集区段

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

请注意以下先决条件,以便将数据从Platform导出到您的Salesforce Marketing Cloud帐户:

您需要拥有Salesforce Marketing Cloud帐户 prerequisites-account

必须有一个订阅Marketing Cloud Engagement产品的Salesforce Marketing Cloud帐户才能继续。

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

在Salesforce Marketing Cloud中创建属性 prerequisites-attribute

将受众激活到(API) Salesforce Marketing Cloud目标时,必须在​ 受众计划 ​步骤中为每个激活的受众在​ 映射ID ​字段中输入值。

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

对于从Platform激活到Salesforce的每个受众,您必须在Salesforce Marketing Cloud内具有链接到Email Demographics数据扩展的Text类型的属性。 使用Salesforce Marketing Cloud Contact Builder创建属性。 如果您需要有关创建属性的指导,请参阅Salesforce Marketing Cloud文档以创建属性

在​ 映射 ​步骤期间,(API) Salesforce Marketing Cloud目标字段使用了属性字段名称。 您可以根据业务需求定义最多4000个字符的字段字符。 有关属性类型的更多信息,请参阅Salesforce Marketing Cloud 数据扩展数据类型文档页面。

Salesforce Marketing Cloud中的数据设计器屏幕的示例(您将向其中添加属性)如下所示:
SalesforceMarketing CloudUI数据设计器。

下面显示了Salesforce Marketing Cloud Email Data属性组的视图,该属性组的属性与Email Demographics数据扩展中的受众状态相对应:
SalesforceMarketing CloudUI电子邮件数据属性组。

(API) Salesforce Marketing Cloud目标使用Salesforce Marketing Cloud Search Attribute-Set Definitions REST API动态检索Salesforce Marketing Cloud中定义的数据扩展及其链接属性。

当您在工作流中设置映射将受众激活到目标时,这些内容显示在​ 目标字段 ​选择窗口中。

IMPORTANT
在Salesforce Marketing Cloud内,您必须为每个激活的Platform区段创建与​ 映射ID ​中指定的值完全匹配的​ 字段名称 ​属性。 例如,下面的屏幕截图显示了名为salesforce_mc_segment_1的属性。 将受众激活到此目标时,请添加salesforce_mc_segment_1作为​ 映射ID,以将受众从Experience Platform填充到此属性中。

下面显示了Salesforce Marketing Cloud中属性创建的示例:
显示属性的SalesforceMarketing CloudUI屏幕截图。

TIP
  • 创建属性时,请勿在字段名称中包含空白字符。 请改用下划线(_)字符作为分隔符。
  • 为了区分用于PlatformAdobe的属性和Salesforce Marketing Cloud内的其他属性,您可以为用于受众区段的属性包含一个可识别的前缀或后缀。 例如,使用Adobe_test_segmenttest_segment_Adobe,而不是test_segment
  • 如果您已在Salesforce Marketing Cloud中创建了其他属性,则可以使用与Platform区段相同的名称,以便轻松地识别Salesforce Marketing Cloud中的受众。

在Salesforce Marketing Cloud中分配用户角色和权限 prerequisites-roles-permissions

由于Salesforce Marketing Cloud支持自定义角色(取决于您的用例),因此应该为您的用户分配相关角色,以更新Salesforce Marketing Cloud中的属性。 下面显示了分配给用户的角色示例:
选定用户的SalesforceMarketing CloudUI,显示为其分配的角色。

根据您的Salesforce Marketing Cloud用户被分配的角色,您还需要向Salesforce Marketing Cloud数据扩展分配权限,这些权限链接到您要更新的字段。

由于此目标需要访问data extension,因此您需要允许这些访问。 例如,对于Email data extension,您需要允许,如下所示:

SalesforceMarketing CloudUI显示具有允许权限的电子邮件数据扩展。

要限制访问级别,您还可以使用粒度权限覆盖单个访问。
SalesforceMarketing CloudUI显示具有粒度权限的电子邮件数据扩展。

有关详细指导,请参阅Marketing Cloud RolesMarketing Cloud Roles and Permissions页。

收集Salesforce Marketing Cloud凭据 gather-credentials

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

凭据
描述
示例
Subdomain
请参阅Salesforce Marketing Cloud domain prefix以了解如何从Salesforce Marketing Cloud接口获取此值。
如果您的Salesforce Marketing Cloud域是
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com
您需要提供mcq4jrssqdlyc4lph19nnqgzzs84作为值。
客户端 ID
请参阅Salesforce Marketing Cloud 文档以了解如何从Salesforce Marketing Cloud界面获取此值。
r23kxxxxxxxx0z05xxxxxx
客户端密码
请参阅Salesforce Marketing Cloud 文档以了解如何从Salesforce Marketing Cloud界面获取此值。
ipxxxxxxxxxxT4xxxxxxxxxx

护栏 guardrails

  • Salesforce施加了某些速率限制

    • 请参阅Salesforce Marketing Cloud 文档以解决您在执行过程中可能遇到的任何限制并减少错误。
    • 请参阅Salesforce Marketing Cloud 参与定价页以​ 以PDF格式下载完整版比较表,其中详细说明了计划规定的限制。
    • API概述页面详细介绍了其他限制。
    • 有关整理这些详细信息的页面,请参阅此处
  • 每个对象​ 允许的 ​自定义字段的计数因您的Salesforce Edition而异。

    • 有关其他指导,请参阅Salesforce 文档

    • 如果已达到Salesforce Marketing Cloud内每个对象​ 允许的 ​自定义字段定义的限制,您将需要

      • 在Salesforce Marketing Cloud中添加新属性之前,请先删除旧属性。
      • 受众计划步骤期间,更新或删除Platform目标中任何使用这些旧属性名称作为​ 映射ID ​提供的值的激活受众。

支持的身份 supported-identities

(API) Salesforce Marketing Cloud支持激活下表中描述的标识。 了解有关标识的更多信息。

目标身份
描述
注意事项
contactKey
Salesforce Marketing Cloud联系人密钥。 如需其他指导,请参阅Salesforce Marketing Cloud 文档
必需

支持的受众 supported-audiences

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

受众来源
支持
描述
Segmentation Service
✓ {\f13 }
通过Experience Platform分段服务生成的受众。
自定义上传
X
受众已将从CSV文件导入到Experience Platform中。

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

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

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

连接到目标 connect

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

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

在​ 目标 > 目录 ​中,搜索(API) Salesforce Marketing Cloud。 或者,您可以在​ 电子邮件营销 ​类别下找到它。

验证目标 authenticate

要验证到目标,请填写下面的必填字段,然后选择​ 连接到目标。 有关任何指导,请参阅收集 Salesforce Marketing Cloud 凭据部分。

(API) Salesforce Marketing Cloud目标
Salesforce Marketing Cloud
子域
您的Salesforce Marketing Cloud域前缀。
例如,如果您的域是
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com
您需要提供mcq4jrssqdlyc4lph19nnqgzzs84作为值。
客户端ID
您的Salesforce Marketing Cloud Client ID
客户端密码
您的Salesforce Marketing Cloud Client Secret

显示如何对SalesforceMarketing Cloud进行身份验证的Platform UI屏幕截图。

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

填写目标详细信息 destination-details

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

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

启用警报 enable-alerts

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

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

激活此目标的受众 activate

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

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

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

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

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

IMPORTANT
  • 尽管您的属性名称与您的Salesforce Marketing Cloud帐户相同,但contactKeypersonalEmail.address的映射是必需的。

  • 与Salesforce Marketing Cloud API的集成受Experience Platform可从Salesforce检索的属性数量的分页限制。 这意味着,在​ 映射 ​步骤中,目标字段架构最多可以显示2000个Salesforce帐户属性。

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

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

  3. 在​ 选择目标字段 ​窗口中,选择​ 选择身份命名空间 ​并选择身份,或者选择​ 选择属性 ​类别并从根据需要显示的数据扩展中选择属性。 (API) Salesforce Marketing Cloud目标使用Salesforce Marketing Cloud Search Attribute-Set Definitions REST API动态检索Salesforce Marketing Cloud中定义的数据扩展及其链接属性。 当您在激活受众工作流中设置映射时,这些内容会显示在​ 目标字段 ​弹出窗口中。

    • 重复这些步骤以在XDM配置文件架构和(API) Salesforce Marketing Cloud之间添加以下映射:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      源字段 目标字段 必需
      IdentityMap: contactKey Identity: salesforceContactKey Mandatory
      xdm: personalEmail.address 来自Salesforce Marketing Cloud Email Addresses数据扩展的Attribute: Email Address Mandatory,添加新联系人时。
      xdm: person.name.firstName 所需Salesforce Marketing Cloud数据扩展中的Attribute: First Name -
    • 下面显示了使用这些映射的示例:

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

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

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

执行计划受众导出步骤时,必须手动将Platform受众映射到Salesforce Marketing Cloud中的属性

为此,请选择每个区段,然后在(API) Salesforce Marketing Cloud 映射ID ​字段中输入Salesforce Marketing Cloud中属性的名称。 有关在Salesforce Marketing Cloud中创建属性的指导和最佳实践,请参阅在 Salesforce Marketing Cloud中创建属性。

例如,如果您的Salesforce Marketing Cloud属性是salesforce_mc_segment_1,请在(API) Salesforce Marketing Cloud 映射ID ​中指定此值以将受众受众从Experience Platform填充到此属性中。

以下显示了Salesforce Marketing Cloud中的示例属性:
显示属性的SalesforceMarketing CloudUI屏幕截图。

下面显示了一个示例,用于指示(API) Salesforce Marketing Cloud 映射ID ​的位置:
显示计划受众导出的Platform UI屏幕截图示例。

如图所示,(API) Salesforce Marketing Cloud 映射ID ​应与Salesforce Marketing Cloud FIELD NAME ​中指定的值完全匹配。

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

基于上述图像的典型示例可能是。
| (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 |

验证数据导出 exported-data

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

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

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

  3. 切换到​ Activation data ​选项卡,然后选择受众名称。
    显示目标激活数据的Platform UI屏幕快照示例。

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

  5. 登录到Salesforce Marketing Cloud网站。 然后导航到​ Audience Builder > Contact Builder > All contacts > Email ​页面,并检查受众中的配置文件是否已添加。
    SalesforceMarketing CloudUI屏幕截图显示了“联系人”页面,该页面具有区段中使用的配置文件。

  6. 要检查是否已更新任何配置文件,请导航到​ 电子邮件 ​页面,并验证受众中配置文件的属性值是否已更新。 如果成功,您可以看到根据受众计划步骤中提供的​ 映射ID ​值,Salesforce Marketing Cloud中的每个受众状态都已更新为平台中的相应受众状态。
    SalesforceMarketing CloudUI屏幕截图显示了已选择的“联系人电子邮件”页面,该页面具有更新的Audience状态。

数据使用和治理 data-usage-governance

在处理您的数据时,所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息,请参阅数据治理概述

错误和故障排除 errors-and-troubleshooting

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

  • 检查数据流运行时,您可能会遇到以下错误消息: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
    平台UI屏幕快照显示错误。

    • 要修复此错误,请验证您在激活工作流中提供的​ 映射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范围。 列入允许列表如果您需要其他指导,请参阅Marketing Cloud🔗文档中的Salesforce Marketing Cloud IP地址以包含。

其他资源 additional-resources

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

Changelog changelog

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

查看更改日志
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
发行月份 更新类型 描述
2023 年 10 月 文档更新
  • 我们更新了(API) SalesforceMarketing Cloud中的先决条件部分,并且通常删除了对该文档中的属性组的不必要的引用。
  • 更新了文档以指示受众状态的属性应仅在Email Demographics数据扩展内的Salesforce Marketing Cloud内创建。
  • 我们更新了映射注意事项和示例部分中的映射表,Email Addresses数据扩展中Email Address属性的映射标记为必需,标有IMPORTANT的标注中提到了此要求,但表中忽略了该要求。
2023 年 4 月 文档更新
  • 我们更正了 (API) SalesforceMarketing Cloud中的先决条件部分中的语句和引用链接,以指出Salesforce Marketing Cloud Engagement是使用此目标的必需订阅。 以前错误地指出用户需要订阅Marketing Cloud 帐户 ​参与才能继续。
  • 我们在先决条件下添加了一个部分,用于将角色和权限分配给要工作的此目标的Salesforce用户。 (PLATIR-26299)
2023 年 2 月 文档更新 我们更新了(API) SalesforceMarketing Cloud🔗中的先决条件,以包含一个引用链接,指出Salesforce Marketing Cloud Engagement是使用此目标的必需订阅。
2023 年 2 月 功能更新 我们修复了目标中的错误配置导致向Salesforce发送格式错误的JSON的问题。 这导致某些用户看到大量激活时失败的身份。 (PLATIR-26299)
2023 年 1 月 文档更新
  • 我们更新了 Salesforce🔗中的先决条件部分,以指出需要在Salesforce端创建属性。 此部分现在包含有关如何执行此操作的详细说明以及有关命名Salesforce中的属性的最佳实践。 (PLATIR-25602)
  • 我们在受众计划步骤中添加了有关如何为每个激活的受众使用映射ID的明确说明。 (PLATIR-25602)
2022 年 10 月 初始版本 初始目标版本和文档发布。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6