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 如下所示:
在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
ababbaba-abab-baba-acac-acacacacacac
Client Secret
abcde~abcdefghijklmnopqrstuvwxyz12345678
作为指导。Tenant ID
1234567-aaaa-12ab-ba21-1234567890
Region
请参阅 Dynamics 365 文档 作为指导。
org57771b33。
crm
.dynamics.com例如:如果您的公司是在北美(NAM)地区配置的,则您的URL将是
crm.dynamics.com
您需要选择 crm
. 如果您的公司位于加拿大(CAN)地区,则您的URL应为 crm3.dynamics.com
您需要选择 crm3
.Environment URL
org57771b33
.crm.dynamics.com护栏 guardrails
此 请求限制和分配 页面详细信息 Dynamics 365 与您的 Dynamics 365 许可证。 您需要确保数据和有效负载均在这些限制之内。
支持的身份 supported-identities
Dynamics 365 支持更新下表中描述的标识。 了解有关 身份.
支持的受众 supported-audiences
此部分介绍可导出到此目标的所有受众。
此目标支持激活通过Experience Platform生成的所有受众 分段服务.
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息,请参阅下表。
- 您正在导出受众的所有成员以及所需的架构字段 (例如:电子邮件地址、电话号码、姓氏),根据您的字段映射。
- 中的每个受众状态 Dynamics 365 将根据 映射Id 值在 受众调度 步骤。
连接到目标 connect
要连接到此目标,请按照 目标配置教程. 在配置目标工作流中,填写下面两个部分中列出的字段。
范围 目标 > 目录 搜索 Dynamics 365. 或者,您可以将其定位到 CRM 类别。
验证目标 authenticate
要验证目标,请选择 连接到目标.
填写下面的必填字段。 请参阅 收集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中字段旁边的星号表示该字段为必填字段。
- 名称:将来用于识别此目标的名称。
- 描述:可帮助您将来识别此目标的描述。
- 自定义前缀:和
Customization prefix
您在中创建的自定义字段的 Dynamics 365. 请参阅 创建和编辑字段 的部分 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.
为此,请选择每个受众,然后从中输入相应的自定义字段属性 Dynamics 365 在 映射Id 字段。
下面显示了一个示例:
验证数据导出 exported-data
要验证您是否正确设置了目标,请执行以下步骤:
-
选择 目标 > 浏览 导航到目标列表。
-
选择目标并验证状态为 已启用.
-
切换到 Activation data 选项卡,然后选择受众名称。
-
监控受众摘要,并确保用户档案计数对应于在受众中创建的计数。
-
登录到 Dynamics 365 网站,然后导航到 Customers > Contacts 页面,并检查是否已添加受众中的配置文件。 您可以在中看到每个受众状态 Dynamics 365 已根据,从Platform更新了相应的受众状态 映射Id 值在 受众调度 步骤。
数据使用和治理 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.
要修复此错误,请验证 映射Id 您提供于 Dynamics 365 的有效受众,并且存在于中 Dynamics 365.
其他资源 additional-resources
其他有用信息来自 Dynamics 365 文档 如下所示:
Changelog
此部分捕获此目标连接器的功能和重要文档更新。