Zendesk Events API扩展概述

Zendesk 是一个客户服务解决方案和销售工具。 Zendesk 事件转发 扩展可利用 Zendesk Events API 将事件从Adobe Experience Platform Edge Network发送到Zendesk以进行进一步处理。 您可以使用该扩展收集客户配置文件交互,以用于下游分析和操作。

本文档介绍如何在UI中安装和配置扩展。

先决条件

您必须拥有Zendesk帐户才能使用此扩展。 您可以在以下网址注册Zendesk帐户: Zendesk网站.

您还必须为Zendesk配置收集以下详细信息:

键类型
描述
示例
Subdomain
在注册过程中, 子域 创建时特定于帐户。 请参阅 Zendesk文档 以了解更多信息。
xxxxx.zendesk.com (其中 xxxxx 是在帐户创建期间提供的值)
api令牌
Zendesk使用持有者令牌作为身份验证机制与Zendesk API通信。 登录到Zendesk门户后,生成API令牌。 请参阅 Zendesk文档 以了解更多信息。
cwWyOtHAv12w4dhpiulfe9BdZFTz3OKaTSzn2QvV

最后,必须为API令牌创建事件转发密码。 将密码类型设置为 令牌,并将值设置为您从Zendesk配置收集的API令牌。 请参阅有关以下内容的文档 事件转发中的密钥 有关配置密钥的更多详细信息。

安装扩展 install

要在UI中安装Zendesk扩展,请导航到 事件转发 并选择一个资产以将该扩展添加到,或创建一个新资产。

选择或创建所需的属性后,导航至 扩展 > 目录. 搜索"Zendesk",然后选择 Install 在Zendesk Extension上。

在UI中选择的Zendesk扩展的“安装”按钮

配置扩展 configure

IMPORTANT
根据您的实施需求,您可能需要在配置扩展之前创建架构、数据元素和数据集。 请在开始之前查看所有配置步骤,以确定需要为用例设置哪些实体。

选择 扩展 在左侧导航中。 下 已安装,选择 配置 在Zendesk扩展中。

用于在UI中选择的Zendesk扩展的“配置”按钮

Zendesk域 ​中,输入Zendesk子域的值。 下 Zendesk令牌,选择您之前创建的包含API令牌的密码。

配置选项已在UI中填写

配置事件转发规则

开始创建新的事件转发规则 规则 并根据需要配置其条件。 为规则选择操作时,选择 Zendesk 扩展,然后选择 创建事件 操作类型。

定义规则

设置操作配置时,系统会提示您将数据元素分配给将发送到Zendesk的各种属性。

定义操作配置

这些数据元素应该按照以下方式映射。

event

event 是一个JSON对象,它表示用户触发的事件。 请参阅Zendesk文档中的 事件剖析 以了解由捕获的属性的详细信息, event 对象。

以下键值可在中引用 event 对象映射到数据元素:

event
类型
平台路径
描述
必需
限制
source
字符串
arc.event.xdm._extconndev.event_source
发送事件的应用程序。
不使用 Zendesk 作为值,因为它是Zendesk标准事件的受保护源名称。 尝试使用它会导致错误。
值长度不得超过40个字符。
type
字符串
arc.event.xdm._extconndev.event_type
事件类型的名称。 您可以使用此字段表示给定源的不同类型的事件。 例如,您可以为用户登录创建一组事件,为购物车创建另一组事件。
值长度不得超过40个字符。
description
字符串
arc.event.xdm._extconndev.description
事件的描述。
(不适用)
created_at
字符串
arc.event.xdm.timestamp
反映事件创建时间的ISO-8601时间戳。
(不适用)
properties
对象
arc.event.xdm._extconndev.EventProperties
包含有关事件的详细信息的自定义JSON对象。
(不适用)
NOTE
请参阅 Zendesk Events API 文档 以获取有关事件属性的其他指导。

profile

profile 是一个JSON对象,它表示触发事件的用户。 请参阅Zendesk文档中的 侧写剖析 以了解由捕获的属性的详细信息, profile 对象。

以下键值可在中引用 profile 对象映射到数据元素:

profile
类型
平台路径
描述
必需
限制
source
字符串
arc.event.xdm._extconndev.profile_source
与配置文件关联的产品或服务,例如 SupportCompanyName,或 Chat.
(不适用)
type
字符串
arc.event.xdm._extconndev.profile_type
配置文件类型的名称。 您可以使用此字段为给定源创建不同类型的配置文件。 例如,您可以为客户创建一组公司配置文件,为员工创建另一组公司配置文件。
配置文件类型长度不得超过40个字符。
name
字符串
arc.event.xdm._extconndev.name
个人资料中的人员姓名
(不适用)
user_id
字符串
arc.event.xdm._extconndev.user_id
Zendesk中的人员的用户ID。
(不适用)
identifiers
数组
arc.event.xdm._extconndev.identifiers
至少包含一个标识符的数组。 每个标识符都由类型和值组成。
请参阅 Zendesk文档 欲知关于 identifiers 数组。 所有字段和值都必须是唯一的。
attributes
对象
arc.event.xdm._extconndev.attrbutes
包含有关人员的用户定义的属性的对象。
请参阅 Zendesk文档 以了解有关配置文件属性的更多信息。

验证Zendesk中的数据 validate

如果事件收集和Adobe Experience Platform集成成功,则Zendesk控制台中的事件应如下所示。 这表示集成成功。

配置文件:

Zendesk配置文件页面

事件:

Zendesk事件页面

请求限制 limits

根据帐户类型,Zendesk Events API 可以处理以下每分钟请求数:

Account Type
每分钟请求数
Team
250
Growth
250
Professional
500
Enterprise
750
Enterprise Plus
1000

请参阅 Zendesk文档 以了解有关这些限制的详细信息。

错误和故障排除 errors-and-troubleshooting

使用或配置扩展时,Zendesk Events API可能会返回以下错误:

错误代码
描述
解决方法
示例
400
配置文件长度无效: 当配置文件属性的长度包含超过40个字符时,会发生此错误。
将配置文件属性数据的长度限制为最多40个字符。
{"error": [{"code":"InvalidProfileTypeLength","title": "Profile type length > 40 chars"}]}
401
未找到路由: 当提供了无效的域时,会发生此错误。
验证是否按以下格式提供了有效的域: {subdomain}.zendesk.com
{"error": [{"description": "No route found for host {subdomain}.zendesk.com","title": "RouteNotFound"}]}
401
身份验证无效或缺少身份验证: 当访问令牌无效、缺失或过期时,会发生此错误。
验证访问令牌是否有效且未过期。
{"error": [{"code":"MissingOrInvalidAuthentication","title": "Invalid or Missing Authentication"}]}
403
权限不足: 当未提供足够的权限来访问资源时,会发生此错误。
验证是否已提供所需的权限。
{"error": [{"code":"PermissionDenied","title": "Insufficient permisssions to perform operation"}]}
429
请求过多: 当超过终结点对象记录限制时,会发生此错误。
请参阅上文关于 请求限制 以了解有关每次限制阈值的详细信息。
{"error": [{"code":"TooManyRequests","title": "Too Many Requests"}]}

后续步骤

本文档介绍了如何在UI中安装和配置Zendesk事件转发扩展。 有关在Zendesk中收集事件数据的更多信息,请参阅官方文档:

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743