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目标之前,您必须在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

创建字段数据类型为Single Line of Text且类型为Simple的自定义字段,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并创建以下内容:

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

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

收集Dynamics 365凭据 gather-credentials

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

凭据
描述
示例
Client ID
Azure Active Directory应用程序的Dynamics 365客户端ID。 有关指导,请参阅Dynamics 365 文档
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Azure Active Directory应用程序的Dynamics 365客户端密钥。 您将在Dynamics 365 文档中使用选项#2。
abcde~abcdefghijklmnopqrstuvwxyz12345678作为指导。
Tenant ID
Azure Active Directory应用程序的Dynamics 365租户ID。 有关指导,请参阅Dynamics 365 文档
1234567-aaaa-12ab-ba21-1234567890
Region
与环境URL关联的Microsoft区域。
请参阅Dynamics 365 文档以获取指导。
如果您的域如下所示,则在对目标.
进行身份验证时,需要在下拉选择器中为CRM字段提供高亮显示的值 组织57771b33。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 API限制。 您需要确保数据和有效负载均在这些限制之内。

支持的身份 supported-identities

Dynamics 365支持更新下表中描述的标识。 了解有关标识的更多信息。

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

支持的受众 supported-audiences

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

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

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

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

项目
类型
注释
导出类型
基于配置文件
  • 您正在导出受众的所有成员,以及所需的架构字段​ (例如:电子邮件地址、电话号码、姓氏)(根据字段映射)。
  • 根据受众计划步骤期间提供的​ 映射ID ​值,Dynamics 365中的每个受众状态都将通过平台中的相应受众状态进行更新。
导出频率
正在流式传输
  • 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案,连接器就会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。

连接到目标 connect

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

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

在​ 目标 > 目录 ​中,搜索Dynamics 365。 或者,您可以在​ CRM ​类别下找到它。

验证目标 authenticate

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

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

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

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

填写目标详细信息 destination-details

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

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

启用警报 enable-alerts

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

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

激活此目标的受众 activate

IMPORTANT
  • 若要激活数据,您需要​ 查看目标激活目标查看配置文件 ​和​ 查看区段 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。
  • 要导出​ 标识,您需要​ 查看标识图形 访问控制权限
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

有关将受众激活到此目标的说明,请阅读将配置文件和受众激活到流式受众导出目标

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

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

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

  2. 在​ 选择源字段 ​窗口中,选择​ 选择身份命名空间 ​类别并选择contactid
    Source映射的Platform UI屏幕快照示例。

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

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

      Platform UI屏幕截图显示联系人的目标映射。

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

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

      显示电子邮件目标映射的Platform 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映射的Platform UI屏幕快照示例。

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

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

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

IMPORTANT
用于​ 映射ID ​的值应与Dynamics 365内创建的自定义字段属性的名称完全匹配。 如果您需要有关查找自定义字段属性的指导,请参阅Dynamics 365 文档

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

验证数据导出 exported-data

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

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

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

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

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

  5. 登录到Dynamics 365网站,然后导航到Customers > Contacts页面,并检查是否已添加受众中的配置文件。 您可以看到,根据受众计划步骤中提供的​ 映射ID ​值,Dynamics 365中的每个受众状态都更新为来自Platform的相应受众状态。
    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屏幕截图显示错误请求错误。

要修复此错误,请验证您在Dynamics 365中为Platform受众提供的​ 映射ID ​是否有效并且存在于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