Microsoft Dynamics 365 连接

概述

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 实例位于 向目标进行身份验证 部分。

用例

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

先决条件

Experience Platform先决条件

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

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

Microsoft Dynamics 365 先决条件

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

您需要拥有 Microsoft Dynamics 365 帐户

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

在中创建字段 Dynamics 365

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

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

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

中的设置示例 Dynamics 365 如下所示：

在Azure Active Directory中注册应用程序和应用程序用户

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

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

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

收集 Dynamics 365 凭据

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

护栏

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

支持的身份

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

支持的受众

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

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

导出类型和频率

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

连接到目标

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

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

向目标进行身份验证

要验证目标，请选择 连接到目标.

填写下面的必填字段。 请参阅 收集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将显示 已连接 带有绿色复选标记的状态。 然后，您可以继续执行下一步。

填写目标详细信息

要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。

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

启用警报

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

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

将受众激活到此目标

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

映射注意事项和示例

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

1. 在 映射 步骤，选择 添加新映射. 您将在屏幕上看到一个新映射行。
   

2. 在 选择源字段 窗口中，选择 选择身份命名空间 类别并选择 contactId.
   

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

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

     

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

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

     

     重要

     如果您有一个日期或时间戳源字段被映射到 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|Email|

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

     

计划受众导出和示例

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

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

下面显示了一个示例：

验证数据导出

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

1. 选择 目标 > 浏览 导航到目标列表。
   

2. 选择目标并验证状态为 已启用.
   

3. 切换到 Activation data 选项卡，然后选择受众名称。
   

4. 监控受众摘要，并确保用户档案计数对应于在受众中创建的计数。
   

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

数据使用和治理

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

错误和故障排除

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

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

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

其他资源

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

• IOrorganizationService.Update(Entity)方法
• 使用Web API更新和删除表行

Changelog

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

Business.Adobe.com 资源