(API) Salesforce Marketing Cloud连接
概述 overview
(API) Salesforce Marketing Cloud （以前称为ExactTarget）是一个数字营销套件，它允许您为访客和客户构建和自定义历程，以个性化其体验。
与更面向 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中的数据设计器屏幕的示例（您将向其中添加属性）如下所示：
下面显示了Salesforce Marketing Cloud Email Data属性组的视图，该属性组的属性与Email Demographics数据扩展中的受众状态相对应：
(API) Salesforce Marketing Cloud目标使用Salesforce Marketing Cloud Search Attribute-Set Definitions REST API动态检索Salesforce Marketing Cloud中定义的数据扩展及其链接属性。
当您在工作流中设置映射到将受众激活到目标时，这些内容显示在 目标字段 选择窗口中。
salesforce_mc_segment_1的属性。 将受众激活到此目标时，请添加salesforce_mc_segment_1作为 映射ID，以将受众从Experience Platform填充到此属性中。下面显示了Salesforce Marketing Cloud中属性创建的示例：
- 创建属性时，请勿在字段名称中包含空白字符。 请改用下划线
(_)字符作为分隔符。 - 为了区分用于PlatformAdobe的属性和Salesforce Marketing Cloud内的其他属性，您可以为用于受众区段的属性包含一个可识别的前缀或后缀。 例如，使用
Adobe_test_segment或test_segment_Adobe，而不是test_segment。 - 如果您已在Salesforce Marketing Cloud中创建了其他属性，则可以使用与Platform区段相同的名称，以便轻松地识别Salesforce Marketing Cloud中的受众。
在Salesforce Marketing Cloud中分配用户角色和权限 prerequisites-roles-permissions
由于Salesforce Marketing Cloud支持自定义角色（取决于您的用例），因此应该为您的用户分配相关角色，以更新Salesforce Marketing Cloud中的属性。 下面显示了分配给用户的角色示例：
根据您的Salesforce Marketing Cloud用户被分配的角色，您还需要向Salesforce Marketing Cloud数据扩展分配权限，这些权限链接到您要更新的字段。
由于此目标需要访问data extension，因此您需要允许这些访问。 例如，对于Email data extension，您需要允许，如下所示：
要限制访问级别，您还可以使用粒度权限覆盖单个访问。
有关详细指导，请参阅Marketing Cloud Roles和Marketing Cloud Roles and Permissions页。
收集Salesforce Marketing Cloud凭据 gather-credentials
在对(API) Salesforce Marketing Cloud目标进行身份验证之前，请记下以下项目。
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com，您需要提供
mcq4jrssqdlyc4lph19nnqgzzs84作为值。护栏 guardrails
-
Salesforce施加了某些速率限制。
- 请参阅Salesforce Marketing Cloud 文档以解决您在执行过程中可能遇到的任何限制并减少错误。
- 请参阅Salesforce Marketing Cloud 参与定价页以 以PDF格式下载完整版比较表，其中详细说明了计划规定的限制。
- API概述页面详细介绍了其他限制。
- 有关整理这些详细信息的页面，请参阅此处。
-
每个对象 允许的 自定义字段的计数因您的Salesforce Edition而异。
支持的身份 supported-identities
(API) Salesforce Marketing Cloud支持激活下表中描述的标识。 了解有关标识的更多信息。
支持的受众 supported-audiences
此部分介绍哪些类型的受众可以导出到此目标。
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息，请参阅下表。
- 您正在根据字段映射导出区段的所有成员，以及所需的架构字段 （例如：电子邮件地址、电话号码、姓氏）。
- 根据受众计划步骤期间提供的 映射ID 值，Salesforce Marketing Cloud中的每个区段状态都将通过平台中的相应受众状态进行更新。
连接到目标 connect
要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。
在 目标 > 目录 中，搜索(API) Salesforce Marketing Cloud。 或者，您可以在 电子邮件营销 类别下找到它。
验证目标 authenticate
要验证到目标，请填写下面的必填字段，然后选择 连接到目标。 有关任何指导，请参阅收集 Salesforce Marketing Cloud 凭据部分。
例如，如果您的域是
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com，您需要提供
mcq4jrssqdlyc4lph19nnqgzzs84作为值。Client ID。Client Secret。
如果提供的详细信息有效，则UI会以绿色复选标记显示 已连接 状态，然后您可以继续执行下一步。
填写目标详细信息 destination-details
要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
- 名称：将来用于识别此目标的名称。
- 描述：可帮助您将来识别此目标的描述。
启用警报 enable-alerts
您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。
完成提供目标连接的详细信息后，选择 下一步。
激活此目标的受众 activate
有关将受众激活到此目标的说明，请阅读将配置文件和受众激活到流式受众导出目标。
映射注意事项和示例 mapping-considerations-example
要将受众数据从Adobe Experience Platform正确发送到(API) Salesforce Marketing Cloud目标，您需要完成字段映射步骤。 映射包括在您的Platform帐户中的Experience Data Model (XDM)架构字段与其在目标目标中的相应等效字段之间创建链接。
要将XDM字段正确映射到(API) Salesforce Marketing Cloud目标字段，请执行以下步骤。
-
尽管您的属性名称与您的Salesforce Marketing Cloud帐户相同，但
contactKey和personalEmail.address的映射是必需的。 -
与Salesforce Marketing Cloud API的集成受Experience Platform可从Salesforce检索的属性数量的分页限制。 这意味着，在 映射 步骤中，目标字段架构最多可以显示2000个Salesforce帐户属性。
-
在 映射 步骤中，选择 添加新映射。 您将在屏幕上看到一个新映射行。
-
在 选择源字段 窗口中，选择 选择属性 类别并选择XDM属性，或选择 选择身份命名空间 并选择身份。
-
在 选择目标字段 窗口中，选择 选择身份命名空间 并选择身份，或者选择 选择属性 类别并从根据需要显示的数据扩展中选择属性。 (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: contactKeyIdentity: salesforceContactKeyMandatoryxdm: personalEmail.address来自Salesforce Marketing Cloud Email Addresses数据扩展的 Attribute: Email Address。Mandatory，添加新联系人时。xdm: person.name.firstName所需Salesforce Marketing Cloud数据扩展中的 Attribute: First Name。- -
下面显示了使用这些映射的示例：
-
完成提供目标连接的映射后，请选择 下一步。
计划受众导出和示例 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中的示例属性：
下面显示了一个示例，用于指示(API) Salesforce Marketing Cloud 映射ID 的位置：
如图所示，(API) Salesforce Marketing Cloud 映射ID 应与Salesforce Marketing Cloud FIELD NAME 中指定的值完全匹配。
对每个激活的Platform区段重复此部分。
基于上述图像的典型示例可能是。
salesforce_mc_segment_1salesforce_mc_segment_1salesforce_mc_segment_2salesforce_mc_segment_2验证数据导出 exported-data
要验证您是否正确设置了目标，请执行以下步骤：
-
选择 目标 > 浏览 以导航到目标列表。
-
选择目标并验证状态为 已启用。
-
切换到 Activation data 选项卡，然后选择受众名称。
-
监控受众摘要，并确保用户档案计数对应于在区段内创建的计数。
-
登录到Salesforce Marketing Cloud网站。 然后导航到 Audience Builder > Contact Builder > All contacts > Email 页面，并检查受众中的配置文件是否已添加。
-
要检查是否已更新任何配置文件，请导航到 电子邮件 页面，并验证受众中配置文件的属性值是否已更新。 如果成功，您可以看到根据受众计划步骤中提供的 映射ID 值，Salesforce Marketing Cloud中的每个受众状态都已更新为平台中的相应受众状态。
数据使用和治理 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.
- 要修复此错误，请验证您在激活工作流中提供的 映射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
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 月 | 文档更新 | |
| 2023 年 4 月 | 文档更新 |
|
| 2023 年 2 月 | 文档更新 | 我们更新了(API) SalesforceMarketing Cloud🔗中的先决条件，以包含一个引用链接，指出Salesforce Marketing Cloud Engagement是使用此目标的必需订阅。 |
| 2023 年 2 月 | 功能更新 | 我们修复了目标中的错误配置导致向Salesforce发送格式错误的JSON的问题。 这导致某些用户看到大量激活时失败的身份。 (PLATIR-26299) |
| 2023 年 1 月 | 文档更新 | |
| 2022 年 10 月 | 初始版本 | 初始目标版本和文档发布。 |