Zendesk事件API擴充功能概觀
Zendesk是客戶服務解決方案和銷售工具。 Zendesk 事件轉送擴充功能會利用Zendesk Events API將事件從Adobe Experience PlatformEdge Network傳送至Zendesk以進行進一步處理。 您可以使用擴充功能來收集客戶設定檔互動,以用於下游分析和動作。
本文介紹如何在UI中安裝和設定擴充功能。
先決條件
您必須擁有Zendesk帳戶才能使用此擴充功能。 您可以在Zendesk網站上註冊Zendesk帳戶。
您也必須為您的Zendesk設定收集以下詳細資訊:
cwWyOtHAv12w4dhpiulfe9BdZFTz3OKaTSzn2QvV
最後,您必須為API權杖建立事件轉送密碼。 將密碼型別設定為 Token,並將值設定為您從Zendesk設定收集的API Token。 如需設定密碼的詳細資訊,請參閱事件轉送🔗中密碼的檔案。
安裝擴充功能 install
若要在UI中安裝Zendesk擴充功能,請導覽至 事件轉送 並選取要新增擴充功能的屬性,或改為建立新屬性。
選取或建立所需的屬性後,請瀏覽至 擴充功能 > 目錄。 搜尋「Zendesk」,然後在Zendesk擴充功能上選取 Install。
在UI中選取之Zendesk擴充功能的
設定擴充功能 configure
在左側導覽中選取 擴充功能。 在 已安裝 下,選取Zendesk延伸上的 設定。
在UI中選取之Zendesk擴充功能的
在 Zendesk網域 底下,輸入您的Zendesk子網域值。 在 Zendesk Token 下,選取您先前建立的包含API Token的密碼。
設定事件轉送規則
開始建立新的事件轉送規則規則,並視需要設定其條件。 選取規則的動作時,請選取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
description
arc.event.xdm._extconndev.description
created_at
arc.event.xdm.timestamp
properties
arc.event.xdm._extconndev.EventProperties
profile
個金鑰
profile
是JSON物件,代表觸發事件的使用者。 如需有關profile
物件所擷取屬性的詳細資訊,請參閱個人資料🔗的解剖結構上的Zendesk檔案。
當對應至資料元素時,可在profile
物件中參考下列索引鍵:
profile
金鑰source
arc.event.xdm._extconndev.profile_source
Support
、CompanyName
或Chat
。type
arc.event.xdm._extconndev.profile_type
name
arc.event.xdm._extconndev.name
user_id
arc.event.xdm._extconndev.user_id
identifiers
arc.event.xdm._extconndev.identifiers
identifiers
陣列的詳細資訊。 所有欄位和值都必須是唯一的。驗證Zendesk中的資料 validate
如果事件收集和Adobe Experience Platform整合成功,則Zendesk主控台中的事件應會顯示如下。 這表示整合成功。
設定檔:
事件:
請求限制 limits
根據帳戶型別,Zendesk Events API每分鐘可以處理下列數目的要求:
如需這些限制的詳細資訊,請參閱Zendesk檔案。
錯誤與疑難排解 errors-and-troubleshooting
使用或設定擴充功能時,Zendesk Events API可能會傳回下列錯誤:
{"error": [{"code":"InvalidProfileTypeLength","title": "Profile type length > 40 chars"}]}
{subdomain}.zendesk.com
{"error": [{"description": "No route found for host {subdomain}.zendesk.com","title": "RouteNotFound"}]}
{"error": [{"code":"MissingOrInvalidAuthentication","title": "Invalid or Missing Authentication"}]}
{"error": [{"code":"PermissionDenied","title": "Insufficient permisssions to perform operation"}]}
{"error": [{"code":"TooManyRequests","title": "Too Many Requests"}]}
後續步驟
本檔案說明如何在UI中安裝和設定Zendesk事件轉送擴充功能。 如需在Zendesk中收集事件資料的詳細資訊,請參閱官方檔案: