Loading
CRM Analytics
适用于 Marketing Cloud Engagement 的 Salesforce OAuth 2.0 连接

适用于 Marketing Cloud Engagement 的 Salesforce OAuth 2.0 连接

使用 Salesforce Marketing Cloud Engagement OAuth 2.0 连接器创建远程连接,以将数据从 Engagement 同步到 CRM Analytics。

创建连接

  1. 在“数据管理器连接”选项卡中单击新建连接
  2. 单击连接器的名称,然后单击下一步
  3. 输入连接器设置。
  4. 要验证您的设置并尝试连接到源,请单击保存并测试。如果连接失败,CRM Analytics 会显示可能原因。

此连接器需要使用租户特定端点和 OAuth 2.0 身份验证的 Marketing Cloud Engagement 包。软件包权限必须至少:

  • “列表和订阅者”的读取权限
  • “数据扩展”的读取和写入权限
  • “Marketing Cloud Connect”的读取和写入权限
  • “客户”的读取权限
  • “用户”的读取权限

用于连接的用户的安全设置决定了可用于同步的对象和字段。

除非另行说明,否则所有设置需要值。

连接设置描述
连接名称 识别连接。使用约定,可让您在区分不同连接。
开发人员名称 连接的 API 名称。此名称不能包含空格。API 名称会在模式中使用,以引用通过此连接提取的数据。您无法在创建连接后更改开发人员名称。
描述 供内部使用的连接的描述。
API 类型 要使用的 API。选项是 SOAP API 或 RESTSOAP(默认)。
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:

  1. 登录 Marketing Cloud Engagement
  2. 打开设置。
  3. 单击平台工具
  4. 单击应用程序
  5. 单击已安装的软件包
  6. 从列表中选择目标软件包,以打开详细信息。从详细信息中复制 SOAP 基础 URI。将此值用于 REST 或 SOAP API 调用。

例如,如果基本 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 来加快数据同步。

备注
备注 如果将来可能使用排除的数据,请使用模式筛选器来限制写入数据集的数据,而不是数据同步筛选器。
  1. 在数据管理器中,单击连接选项卡。
  2. 选择与要筛选的对象相关联的连接。
  3. 单击要筛选的对象的名称。
  4. 单击数据同步筛选器
  5. 输入筛选器。
  6. 单击保存

对于 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
 
正在加载
Salesforce Help | Article