Microsoft Dynamics 365 连接

概述 overview

Microsoft Dynamics 365 是一个基于云的业务应用程序平台,它将企业资源规划(ERP)、客户关系管理(CRM)与生产效率应用程序和AI工具相结合,以实现端到端更顺畅、更可控的运营、更好的增长潜力和更低的成本。

此 Adobe Experience Platform 目标 利用 Contact Entity Reference API,可让您将受众中的身份更新为 Dynamics 365.

Dynamics 365 使用具有授权授予的OAuth 2作为身份验证机制以与 Contact Entity Reference API. 向您的验证的说明 Dynamics 365 实例位于 向目标进行身份验证 部分。

用例 use-cases

作为营销人员,您可以根据用户的Adobe Experience Platform配置文件中的属性,为其提供个性化体验。 您可以从离线数据构建受众并将这些受众发送到 Dynamics 365,以便在Adobe Experience Platform中更新受众和配置文件后立即显示在用户的信息源中。

先决条件 prerequisites

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

将数据激活到之前 Dynamics 365 目标,您必须拥有 架构, a 数据集、和 受众 创建于 Experience Platform.

请参阅Adobe的文档,了解 受众成员资格详细信息架构字段组 如果您需要有关受众状态的指南。

Microsoft Dynamics 365 先决条件 prerequisites-destination

请注意中的以下先决条件 Dynamics 365,以便将数据从Platform导出到 Dynamics 365 帐户:

您需要拥有 Microsoft Dynamics 365 帐户 prerequisites-account

转到 Dynamics 365 试用版 页面注册并创建帐户(如果尚未注册)。

在中创建字段 Dynamics 365 prerequisites-custom-field

创建类型的自定义字段 Simple 字段数据类型为 Single Line of Text 使用哪个Experience Platform来更新中的受众状态 Dynamics 365.

请参阅 Dynamics 365 创建或编辑字段(属性) 文档(如果您需要其他指导)。

记下 自定义前缀 中创建的自定义字段的 Dynamics 365. 在以下时段中,您将需要此前缀: 填写目标详细信息 步骤。 请参阅 创建和编辑字段 的部分 Dynamics 365 文档,以了解更多详细信息。
显示自定义前缀的Dynamics 365 UI屏幕截图。

中的设置示例 Dynamics 365 如下所示:
显示自定义字段的Dynamics 365 UI屏幕截图。

在Azure Active Directory中注册应用程序和应用程序用户 prerequisites-app-user

要启用 Dynamics 365 要访问资源,您需要使用 Azure Account 到 Azure Active Directory 并创建以下内容:

  • An Azure Active Directory 应用程序
  • 服务主体
  • 应用程序密码

您还需要 创建应用程序用户 在 Azure Active Directory 并将其与新创建的应用程序关联。

收集 Dynamics 365 凭据 gather-credentials

在对进行身份验证之前,请记下以下各项 Dynamics 365 CRM目标:

凭据
描述
示例
Client ID
此 Dynamics 365 您的客户端ID Azure Active Directory 应用程序。 请参阅 Dynamics 365 文档 作为指导。
ababbaba-abab-baba-acac-acacacacacac
Client Secret
此 Dynamics 365 您的客户端密钥 Azure Active Directory 应用程序。 您应使用#2 Dynamics 365 文档.
abcde~abcdefghijklmnopqrstuvwxyz12345678 作为指导。
Tenant ID
此 Dynamics 365 您的租户ID Azure Active Directory 应用程序。 请参阅 Dynamics 365 文档 作为指导。
1234567-aaaa-12ab-ba21-1234567890
Region
与环境URL关联的Microsoft区域。
请参阅 Dynamics 365 文档 作为指导。
如果您的域如下所示,在对进行身份验证时,您需要在下拉选择器中为CRM字段提供突出显示的值 目标.
org57771b33。crm.dynamics.com
例如:如果您的公司是在北美(NAM)地区配置的,则您的URL将是 crm.dynamics.com 您需要选择 crm. 如果您的公司位于加拿大(CAN)地区,则您的URL应为 crm3.dynamics.com 您需要选择 crm3.
Environment URL
请参阅 Dynamics 365 文档 作为指导。
如果您的 Dynamics 365 域如下所示,您需要高亮显示的值。
org57771b33.crm.dynamics.com

护栏 guardrails

请求限制和分配 页面详细信息 Dynamics 365 与您的 Dynamics 365 许可证。 您需要确保数据和有效负载均在这些限制之内。

支持的身份 supported-identities

Dynamics 365 支持更新下表中描述的标识。 了解有关 身份.

目标身份
示例
描述
注意事项
contactid
7eb682f1-ca75-e511-80d4-00155d2a68d1
联系人的唯一标识符。
必需. 请参阅 Dynamics 365 文档 以了解更多详细信息。

支持的受众 supported-audiences

此部分介绍可导出到此目标的所有受众。

此目标支持激活通过Experience Platform生成的所有受众 分段服务.

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

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

项目
类型
注释
导出类型
基于配置文件
  • 您正在导出受众的所有成员以及所需的架构字段 (例如:电子邮件地址、电话号码、姓氏),根据您的字段映射。
  • 中的每个受众状态 Dynamics 365 将根据 映射Id 值在 受众调度 步骤。
导出频率
  • 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案,连接器就会将更新发送到下游目标平台。 详细了解 流目标.

连接到目标 connect

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

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

范围 目标 > 目录 搜索 Dynamics 365. 或者,您可以将其定位到 CRM 类别。

验证目标 authenticate

要验证目标,请选择 连接到目标.
显示如何进行身份验证的平台UI屏幕截图。

填写下面的必填字段。 请参阅 收集Dynamics 365凭据 部分获取任何指导。

  • 客户端ID:和 Dynamics 365 您的客户端ID Azure Active Directory 应用程序。
  • 租户ID:和 Dynamics 365 您的租户ID Azure Active Directory 应用程序。
  • 客户端密码:和 Dynamics 365 您的客户端密钥 Azure Active Directory 应用程序。
  • 区域:您的 Dynamics 365 区域。 例如:如果您的公司是在北美(NAM)地区配置的,则您的URL将是 crm.dynamics.com 您需要选择 crm. 如果您的公司位于加拿大(CAN)地区,则您的URL应为 crm3.dynamics.com 您需要选择 crm3.
  • 环境URL:您的 Dynamics 365 环境URL。

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

填写目标详细信息 destination-details

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

  • 名称:将来用于识别此目标的名称。
  • 描述:可帮助您将来识别此目标的描述。
  • 自定义前缀:和 Customization prefix 您在中创建的自定义字段的 Dynamics 365. 请参阅 创建和编辑字段 的部分 Dynamics 365 文档,以了解更多详细信息。

启用警报 enable-alerts

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

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

激活此目标的受众 activate

IMPORTANT
  • 要激活数据,您需要 查看目标激活目标查看配置文件、和 查看区段 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。

  • 要导出 身份,您需要 查看身份图 访问控制权限.

    img-md
    w-100 modal-image
    选择工作流中突出显示的身份命名空间以将受众激活到目标。

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

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

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

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

  2. 选择源字段 窗口中,选择 选择身份命名空间 类别并选择 contactid.
    源映射的平台UI屏幕截图示例。

  3. 选择目标字段 窗口中,选择要将源字段映射到的目标字段类型。

    • 选择身份命名空间:选择此选项可从列表中将源字段映射到身份命名空间。

      显示联系信息的Target映射的平台UI屏幕截图。

    • 在XDM配置文件架构与您的配置文件架构之间添加以下映射 Dynamics 365 实例: |XDM配置文件架构|Dynamics 365 实例| 必填| |—|—|—| |contactid|contactid| 是 |

    • 选择自定义属性:选择此选项可将源字段映射到您在中定义的自定义属性 属性名称 字段。 请参阅 Dynamics 365 文档 以获取支持的属性的完整列表。

      显示电子邮件的Target映射的平台UI屏幕截图。

      note important
      IMPORTANT
      • 目标字段名称应位于 lowercase.
      • 此外,如果您有一个日期或时间戳源字段,该字段已映射到 Dynamics 365 日期或时间戳 目标字段,请确保映射的值不为空。 如果导出的字段值为空,您将遇到 Bad request reported while pushing events to the destination. Please contact the administrator and try again. 错误消息和数据将不更新。 这是 Dynamics 365 限制。
    • 例如,根据要更新的值,在XDM配置文件架构和之间添加以下映射 Dynamics 365 实例: |XDM配置文件架构|Dynamics 365 实例| |—|—| |person.name.firstName|firstname| |person.name.lastName|lastname| |personalEmail.address|emailaddress1|

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

      显示Target映射的平台UI屏幕截图示例。

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

计划受众导出 在激活工作流的步骤中,您必须手动将Platform受众映射到中的自定义字段属性 Dynamics 365.

为此,请选择每个受众,然后从中输入相应的自定义字段属性 Dynamics 365 在 映射Id 字段。

IMPORTANT
用于 映射Id 应与在中创建的自定义字段属性的名称完全匹配 Dynamics 365. 请参阅 Dynamics 365 文档 如果您需要有关查找自定义字段属性的指南。

下面显示了一个示例:
显示计划受众导出的平台UI屏幕截图示例。

验证数据导出 exported-data

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

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

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

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

  4. 监控受众摘要,并确保用户档案计数对应于在受众中创建的计数。
    显示受众的平台UI屏幕截图示例。

  5. 登录到 Dynamics 365 网站,然后导航到 Customers > Contacts 页面,并检查是否已添加受众中的配置文件。 您可以在中看到每个受众状态 Dynamics 365 已根据,从Platform更新了相应的受众状态 映射Id 值在 受众调度 步骤。
    显示“联系人”页面且受众状态已更新的Dynamics 365 UI屏幕截图。

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

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

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

将事件推送到目标时报告了未知错误 unknown-errors

检查数据流运行时,如果收到以下错误消息: Bad request reported while pushing events to the destination. Please contact the administrator and try again.

平台UI屏幕截图显示错误请求错误。

要修复此错误,请验证 映射Id 您提供于 Dynamics 365 的有效受众,并且存在于中 Dynamics 365.

其他资源 additional-resources

其他有用信息来自 Dynamics 365 文档 如下所示:

Changelog

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

查看更改日志
table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto
发行月份 更新类型 描述
2023 年 10 月 文档更新 更新了指南,以指明所有目标属性名称都应小写,即 映射注意事项和示例 步骤。
2023 年 8 月 功能和文档更新 添加了对的支持 Dynamics 365 未在的默认解决方案中创建的自定义字段的自定义字段前缀 Dynamics 365. 新的输入字段, 自定义前缀,已添加在 填写目标详细信息 步骤。 (PLATIR-31602)。
2022年11月 初始版本 初始目标版本和文档发布。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6