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 用于更新 Dynamics 365.
请参阅 Dynamics 365 文档 创建字段(属性) 如果您需要其他指导,请执行以下操作。

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

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

启用 Dynamics 365 要访问您登录时需要的资源,请执行以下操作: Azure Account to Azure Active Directory 并创建以下内容:

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

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

收集 Dynamics 365 凭据

在验证到 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 应用程序。 您将在 Dynamics 365 文档. abcde~abcdefghijklmnopqrstuvwxyz12345678 以获取指导。
Tenant ID 的 Dynamics 365 您的租户ID Azure Active Directory 应用程序。 请参阅 Dynamics 365 文档 以获取指导。 1234567-aaaa-12ab-ba21-1234567890
Environment URL 请参阅 Dynamics 365 文档 以获取指导。 如果 Dynamics 365 域如下所示,您需要突出显示的值。
org57771b33.crm.dynamics.com

护栏

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

支持的身份

Dynamics 365 支持更新下表所述的身份。 详细了解 标识.

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

导出类型和频度

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

项目 类型 注释
导出类型 基于用户档案
  • 您正在导出区段的所有成员,以及所需的架构字段 (例如:电子邮件地址、电话号码、姓氏),则会根据字段映射。
  • 每个区段状态位于 Dynamics 365 会根据 映射ID区段计划 中。
导出频度
  • 流目标“始终运行”基于API的连接。 在基于区段评估的Experience Platform中更新用户档案后,连接器会立即将更新发送到目标平台下游。 有关更多信息 流目标.

连接到目标

重要

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

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

目标 > 目录 搜索 Dynamics 365. 或者,您也可以在 CRM 类别。

对目标进行身份验证

要对目标进行身份验证,请选择 连接到目标.
Platform UI屏幕截图,其中显示了如何进行身份验证。

填写以下必填字段。 请参阅 收集Dynamics 365凭据 部分。

  • 客户端ID:的 Dynamics 365 您的客户端ID Azure Active Directory 应用程序。
  • 租户ID:的 Dynamics 365 您的租户ID Azure Active Directory 应用程序。
  • 客户端密钥:的 Dynamics 365 您的客户端密钥 Azure Active Directory 应用程序。
  • 环境URL:您的 Dynamics 365 环境URL。

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

填写目标详细信息

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

  • 名称:将来用于识别此目标的名称。
  • 描述:此描述将帮助您在将来确定此目标。

启用警报

您可以启用警报以接收有关目标数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的更多信息,请参阅 使用UI订阅目标警报.

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

将区段激活到此目标

重要

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

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

映射注意事项和示例

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

  1. 映射 步骤,选择 添加新映射. 您将在屏幕上看到一个新的映射行。
    Platform UI中“添加新映射”的屏幕截图示例。

  2. 选择源字段 窗口,选择 选择身份命名空间 类别和选择 contactId.
    Platform UI源映射的屏幕截图示例。

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

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

      Platform UI屏幕截图,其中显示了contactId的Target映射。

    • 在XDM配置文件架构和 Dynamics 365 实例: |XDM配置文件架构|Dynamics 365 Instance|必填| |—|—|—| |contactId|contactId|是 |

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

      平台UI屏幕截图,其中显示了LastName的Target映射。

      重要

      如果您的日期或时间戳源字段映射到 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|

    • 使用这些映射的示例如下所示:

      平台UI屏幕截图示例,其中显示了目标映射。

计划区段导出和示例

计划区段导出 在激活工作流的步骤中,您必须手动将Platform区段映射到 Dynamics 365.

为此,请选择每个区段,然后输入 Dynamics 365 在 映射ID 字段。

重要

用于 映射ID 应与 Dynamics 365. 请参阅 Dynamics 365 文档 如果您需要有关查找自定义字段属性的指导。

示例如下所示:
Platform UI屏幕截图示例显示了计划区段导出。

验证数据导出

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

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

  2. 选择目标并验证状态是否为 已启用.
    Platform UI屏幕截图,其中显示了目标数据流运行。

  3. 切换到 Activation data ,然后选择区段名称。
    Platform UI屏幕截图示例,其中显示了目标激活数据。

  4. 监控区段摘要,并确保配置文件计数与区段内创建的计数相对应。
    平台UI屏幕截图示例,其中显示了区段。

  5. 登录到 Dynamics 365 网站,然后导航到 Customers > Contacts 页面,并检查是否已添加区段中的用户档案。 您可以在 Dynamics 365 更新时,会根据 映射ID区段计划 中。
    Dynamics 365 UI屏幕截图显示了区段状态已更新的“联系人”页面。

数据使用和管理

全部 Adobe Experience Platform 目标在处理数据时与数据使用策略相兼容。 有关如何 Adobe Experience Platform 实施数据管理,请查看 数据管理概述.

错误和疑难解答

将事件推送到目标时遇到未知错误

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

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

要修复此错误,请验证 映射ID 您在 Dynamics 365 ,且该区段在 Dynamics 365.

其他资源

来自 Dynamics 365 文档 如下所示:

在此页面上