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中的示例设置如下所示：
在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 IDababbaba-abab-baba-acac-acacacacacacClient Secretabcde~abcdefghijklmnopqrstuvwxyz12345678作为指导。Tenant ID1234567-aaaa-12ab-ba21-1234567890Region请参阅Dynamics 365 文档以获取指导。
进行身份验证时，需要在下拉选择器中为CRM字段提供高亮显示的值 组织57771b33。
crm.dynamics.com例如：如果您的公司是在北美(NAM)地区配置的，则您的URL将是
crm.dynamics.com，您需要选择crm。 如果您的公司是在加拿大(CAN)地区配置的，则您的URL将为crm3.dynamics.com，您需要选择crm3。Environment URLorg57771b33.crm.dynamics.com护栏 guardrails
请求限制和分配页面详细介绍了与您的Dynamics 365许可证关联的Dynamics 365 API限制。 您需要确保数据和有效负载均在这些限制之内。
支持的身份 supported-identities
Dynamics 365支持更新下表中描述的标识。 了解有关标识的更多信息。
支持的受众 supported-audiences
此部分介绍可导出到此目标的所有受众。
此目标支持激活通过Experience Platform分段服务生成的所有受众。
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息，请参阅下表。
- 您正在导出受众的所有成员，以及所需的架构字段 （例如：电子邮件地址、电话号码、姓氏）（根据字段映射）。
- 根据受众计划步骤期间提供的 映射ID 值，Dynamics 365中的每个受众状态都将通过平台中的相应受众状态进行更新。
- 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案，连接器就会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。
连接到目标 connect
要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。
在 目标 > 目录 中，搜索Dynamics 365。 或者，您可以在 CRM 类别下找到它。
验证目标 authenticate
要验证到目标，请选择 连接到目标。
填写下面的必填字段。 有关任何指导，请参阅收集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中字段旁边的星号表示该字段为必填字段。
- 名称：将来用于识别此目标的名称。
- 描述：可帮助您将来识别此目标的描述。
- 自定义前缀：您在Dynamics 365中创建的自定义字段的
Customization prefix。 有关更多详细信息，请参阅Dynamics 365文档的创建和编辑字段部分。
启用警报 enable-alerts
您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。
完成提供目标连接的详细信息后，选择 下一步。
激活此目标的受众 activate
有关将受众激活到此目标的说明，请阅读将配置文件和受众激活到流式受众导出目标。
映射注意事项和示例 mapping-considerations-example
要将受众数据从Adobe Experience Platform正确发送到Dynamics 365目标，您需要完成字段映射步骤。 映射包括在您的Platform帐户中的Experience Data Model (XDM)架构字段与其在目标目标中的相应等效字段之间创建链接。 要将XDM字段正确映射到Dynamics 365目标字段，请执行以下步骤：
-
在 映射 步骤中，选择 添加新映射。 您将在屏幕上看到一个新映射行。
-
在 选择源字段 窗口中，选择 选择身份命名空间 类别并选择
contactid。
-
在 选择目标字段 窗口中，选择要将源字段映射到的目标字段类型。
-
选择身份命名空间：选择此选项可将源字段映射到列表中的身份命名空间。
-
在XDM配置文件架构和Dynamics 365实例之间添加以下映射：
|XDM配置文件架构|Dynamics 365实例| 必填|
|—|—|—|
|contactid|contactid| 是 | -
选择自定义属性：选择此选项可将源字段映射到您在 属性名称 字段中定义的自定义属性。 请参阅Dynamics 365 文档，获取受支持属性的完整列表。
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| -
下面显示了使用这些映射的示例：
-
计划受众导出和示例 schedule-audience-export-example
在激活工作流的计划受众导出步骤中，必须手动将Platform受众映射到Dynamics 365中的自定义字段属性。
为此，请选择每个受众，然后在 映射ID 字段中输入来自Dynamics 365的相应自定义字段属性。
下面显示了一个示例：
验证数据导出 exported-data
要验证您是否正确设置了目标，请执行以下步骤：
-
选择 目标 > 浏览 以导航到目标列表。
-
选择目标并验证状态为 已启用。
-
切换到 Activation data 选项卡，然后选择受众名称。
-
监控受众摘要，并确保用户档案计数对应于在受众中创建的计数。
-
登录到Dynamics 365网站，然后导航到Customers > Contacts页面，并检查是否已添加受众中的配置文件。 您可以看到，根据受众计划步骤中提供的 映射ID 值，Dynamics 365中的每个受众状态都更新为来自Platform的相应受众状态。
数据使用和治理 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.
要修复此错误，请验证您在Dynamics 365中为Platform受众提供的 映射ID 是否有效并且存在于Dynamics 365中。
其他资源 additional-resources
Dynamics 365 文档中的其他有用信息如下：
Changelog
此部分捕获此目标连接器的功能和重要文档更新。