您在此处:
适用于 Marketing Cloud Engagement 的 Salesforce OAuth 2.0 连接
使用 Salesforce Marketing Cloud Engagement OAuth 2.0 连接器创建远程连接,以将数据从 Engagement 同步到 CRM Analytics。
创建连接
- 在“数据管理器连接”选项卡中单击新建连接。
- 单击连接器的名称,然后单击下一步。
- 输入连接器设置。
- 要验证您的设置并尝试连接到源,请单击保存并测试。如果连接失败,CRM Analytics 会显示可能原因。
此连接器需要使用租户特定端点和 OAuth 2.0 身份验证的 Marketing Cloud Engagement 包。软件包权限必须至少:
- “列表和订阅者”的读取权限
- “数据扩展”的读取和写入权限
- “Marketing Cloud Connect”的读取和写入权限
- “客户”的读取权限
- “用户”的读取权限
用于连接的用户的安全设置决定了可用于同步的对象和字段。
除非另行说明,否则所有设置需要值。
| 连接设置 | 描述 |
|---|---|
| 连接名称 | 识别连接。使用约定,可让您在区分不同连接。 |
| 开发人员名称 | 连接的 API 名称。此名称不能包含空格。API 名称会在模式中使用,以引用通过此连接提取的数据。您无法在创建连接后更改开发人员名称。 |
| 描述 | 供内部使用的连接的描述。 |
| API 类型 | 要使用的 API。选项是 SOAP API 或 REST 的SOAP(默认)。 |
| ClientSecret | Marketing Cloud Engagement 所需的客户端密码会生成有效的访问令牌。 |
| ClientId | Marketing Cloud Engagement 所需的客户端 ID 会生成有效的访问令牌。 |
| Salesforce Marketing Cloud URL | URL 用于连接到 Marketing Cloud Engagement WSDL。要构建 URL,请使用基本 URL 替换默认 https://mcxxx.soap.marketingcloudapis.com/etframework.wsdl 中的“mcxxx”。检索基本 URL:
例如,如果基本 URL 是 mc7f4m1tsgmxz8862chq5qar2k4q,Salesforce Marketing Cloud URL 值是 https://mc7f4m1tsgmxz8862chq5qar2k4q.soap.marketingcloudapis.com/etframework.wsdl |
| UTC 偏差 | 可选设置。在 UTC 偏差时区中,用于从 Marketing Cloud Engagement 中读取数据。 |
| 显示子数据扩展 | 可选设置。使用格式 Parentname_childnameID,在 MID 对象中显示顶级和子业务单位 MID 信息。当前业务部门的数据扩展在带有和不带有后缀的情况下显示,并且它们的数据是相同的。 |
筛选同步到 CRM Analytics 的数据
在同步到 CRM Analytics 时,使用数据同步筛选器将不必要或敏感的数据排除。筛选器在源对象上运行,并通过仅将您需要的数据拉入 CRM Analytics 来加快数据同步。
- 在数据管理器中,单击连接选项卡。
- 选择与要筛选的对象相关联的连接。
- 单击要筛选的对象的名称。
- 单击数据同步筛选器。
- 输入筛选器。
- 单击保存。
对于 Marketing Cloud Engagement OAuth 2.0 连接器,使用 SQL 语法输入与 Filterpart 帮助等效的筛选器。筛选器可以包含布尔语句(AND、OR)、数值比较(>、>=、<、<=)、等于(=、!=)和 LIKE 运算符。SOAP 对象仅支持筛选。
例如,返回带有筛选器Name="Marc"的名称字段为 Marc 的条目。使用这种类型的简单筛选器以获得最佳性能和查询响应。对于更复杂的情况,使用 AND 或 OR 逻辑运算符组合两个筛选器部分,例如 (Name="Marc") AND (Age=57)。您也可以在括号中嵌套筛选器,例如 (Name="Marc")
AND ((Age=57) OR (Age=37))。
要使用日期进行筛选,请以支持的格式存储日期数据。例如,column_date >
'2010-12-31T22:00:00.000Z'
Salesforce Marketing Cloud Engagement OAuth 2.0 连接器注意事项
在使用 Salesforce Marketing Cloud Engagement 连接器时,请谨记这些行为。
- 连接的对象名称必须以字母开头,并且只包含字母、数字或下划线。对象名不能以下划线结尾。
- 仅支持包含字母数字、点、下划线或破折号字符组合的字段名称。如果连接器中存在含有其他字符(例如空格或括号)的字段名称,则同步会失败。
- 连接器最多可以同步 2000 万行或每个对象 10 GB,以先达到的限制为准。
- 支持标准 Marketing Cloud Engagement 和自定义对象,但由于您的软件包访问权限或权限配置,可能不可用。备注 JourneyActivities 对象不可用。
- 请勿在数据同步期间覆盖数据扩展。如果并发覆盖数据扩展,Marketing Cloud 的参与 SOAP API 可以从数据扩展读取操作中返回不完整数据。
- 该连接器无法读取存储在 Marketing Cloud Engagement 中的十六进制字符数据(例如 0x1B),并且会生成 HTTP 302 错误。若要引入列,请删除所有十六进制值。
- 查看 Marketing Cloud Engagement 数据扩展时,名称的开头添加了文本“ungrouped__”,并带有双下划线。例如,数据扩展
MC_East将显示为Ungrouped__MC_East。
