Zendesk连接

Zendesk是客户服务解决方案和销售工具。

此Adobe Experience Platform 目标利用Zendesk 联系人API在受众中作为​ 中的联系人 ​创建和更新身份Zendesk。

Zendesk使用持有者令牌作为身份验证机制与Zendesk联系人API进行通信。 下面的Zendesk向目标身份验证部分中进一步提供了向您的实例进行身份验证的说明。

用例 use-cases

多渠道B2C平台的客户服务部希望为其客户提供无缝的个性化体验。 该部门可根据受众自己的离线数据构建受众,以创建新用户配置文件或更新来自不同交互(例如购买、退货等)的现有配置文件信息,并将这些受众从Adobe Experience Platform发送到Zendesk。 在Zendesk中拥有更新的信息可确保客户服务代理立即获得客户的最新信息,从而加快响应和解决速度。

先决条件 prerequisites

Experience Platform先决条件 prerequisites-in-experience-platform

在将数据激活到Zendesk目标之前,您必须在中创建一个架构数据集区段Experience Platform。

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

Zendesk先决条件 prerequisites-destination

要将数据从Experience Platform导出到您的Zendesk帐户,您需要拥有Zendesk帐户。

收集Zendesk凭据 gather-credentials

在对Zendesk目标进行身份验证之前,请记下以下项目:

凭据
描述
示例
Bearer token
您在Zendesk帐户中生成的访问令牌。
按照文档生成 Zendesk 访问令牌(如果没有)。
a0b1c2d3e4...v20w21x22y23z

护栏 guardrails

定价和速率限制页面详细介绍了与您的帐户关联的Zendesk API限制。 您需要确保数据和有效负载均在这些限制之内。

支持的身份 supported-identities

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

目标身份
示例
描述
必需
email
test@test.com
联系人的电子邮件地址。

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

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

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

连接到目标 connect

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

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

在​Destinations > Catalog​内,搜索Zendesk。 或者,您可以在​ CRM ​类别下找到它。

验证目标 authenticate

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

  • Bearer Token:您在Zendesk帐户中生成的访问令牌。

要验证目标,请选择​Connect to destination
Experience Platform UI屏幕截图显示如何进行身份验证。

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

填写目标详细信息 destination-details

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

  • Name:将来用于识别此目标的名称。
  • Description:可帮助您将来识别此目标的描述。

启用警报 enable-alerts

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

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

激活此目标的受众 activate

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

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

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

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

在​ Target field ​中指定的属性应该完全按照属性映射表中的说明进行命名,因为这些属性将构成请求正文。

在​ Source field ​中指定的属性不遵循任何此类限制。 您可以根据需要进行映射,但是,如果推送到Zendesk时数据格式不正确,则会导致错误。

要将XDM字段正确映射到Zendesk目标字段,请执行以下步骤:

  1. 在​ Mapping ​步骤中,选择​Add new mapping。 您将在屏幕上看到一个新映射行。

  2. 在​ Select source field ​窗口中,选择​ Select attributes ​类别并选择XDM属性或选择​ Select identity namespace ​并选择身份。

  3. 在​ Select target field ​窗口中,选择​ Select identity namespace ​类别并选择目标标识,或选择​ Select attributes ​类别并选择支持的架构属性之一。

    • 重复这些步骤以添加以下强制映射,您还可以添加任何其他要在XDM配置文件架构和Zendesk实例之间更新的属性:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      源字段 目标字段 必需
      xdm: person.name.lastName xdm: last_name
      IdentityMap: Email Identity: email
      xdm: person.name.firstName xdm: first_name
    • 下面显示了使用这些映射的示例:
      具有属性映射的Experience Platform UI屏幕快照示例。

IMPORTANT
Attribute: last_nameIdentity: email目标映射对于此目标是必需的。 如果缺少这些映射,则会忽略任何其他映射,并且不会将其发送到Zendesk。

完成提供目标连接的映射后,请选择​Next

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

在激活工作流的Schedule audience export步骤中,必须手动将Experience Platform受众映射到Zendesk中的自定义字段属性。

为此,请选择每个区段,然后在Zendesk字段中输入来自​ Mapping ID ​的相应自定义字段属性。

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

验证数据导出 exported-data

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

  1. 选择​Destinations > Browse​并导航到目标列表。

  2. 接下来,选择目标并切换到​ Activation data ​选项卡,然后选择受众名称。
    显示目标激活数据的Experience Platform UI屏幕截图示例。

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

  4. 登录到Zendesk网站,然后导航到​ Contacts ​页面以检查受众中的配置文件是否已添加。 此列表可以配置为显示使用受众​ Mapping ID ​和受众状态创建的其他字段的列。
    Zendesk UI屏幕截图显示“联系人”页面,其中包含使用受众名称创建的其他字段。

  5. 或者,您可以向下钻取到单个​ Person ​页面,并检查显示受众名称和受众状态的​ Additional fields ​部分。
    显示“人员”页面的Zendesk UI屏幕截图,“其他字段”部分显示受众名称和受众状态。

数据使用和治理 data-usage-governance

在处理您的数据时,所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息,请参阅数据治理概述

其他资源 additional-resources

Zendesk文档中的其他有用信息如下:

Changelog

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

查看更改日志
table 0-row-3 1-row-3 2-row-3 layout-auto
发行月份 更新类型 描述
2023 年 4 月 文档更新
  • 我们更新了用例部分,更清楚地说明了客户何时将从使用此目标中受益。
  • 我们更新了映射部分以反映正确的必需映射。 Attribute: last_nameIdentity: email目标映射对于此目标是必需的。 如果缺少这些映射,则会忽略任何其他映射,并且不会将其发送到Zendesk。
  • 我们更新了映射部分,提供了强制映射和可选映射的明确示例。
2023 年 3 月 初始版本 初始目标版本和文档发布。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6