Zendesk Events API擴充功能概觀

Zendesk 是客戶服務解決方案和銷售工具。 Zendesk 事件轉送 擴充功能可運用 Zendesk Events API 將事件從Adobe Experience Platform Edge Network傳送到Zendesk以供進一步處理。 您可以使用擴充功能來收集客戶設定檔互動，以用於下游分析和動作。

本文介紹如何在UI中安裝和設定擴充功能。

先決條件

您必須擁有Zendesk帳戶才能使用此擴充功能。 您可以在以下網址註冊Zendesk帳戶： Zendesk網站.

您也必須為您的Zendesk設定收集以下詳細資訊：

金鑰型別 說明 範例
子網域 在註冊過程中，不重複 子網域 是專用於帳戶的。 請參閱 Zendesk檔案 以取得詳細資訊。 xxxxx.zendesk.com (其中 xxxxx 是在帳戶建立期間提供的值)
API權杖 Zendesk使用持有人權杖作為驗證機制，與Zendesk API通訊。 登入Zendesk入口網站後，產生API權杖。 請參閱 Zendesk檔案 以取得詳細資訊。 cwWyOtHAv12w4dhpiulfe9BdZFTz3OKaTSzn2QvV

最後，您必須為API權杖建立事件轉送密碼。 將密碼型別設定為 Token，並將值設定為您從Zendesk設定收集的API權杖。 請參閱以下檔案： 事件轉送中的秘密 以取得設定密碼的詳細資訊。

安裝擴充功能

若要在UI中安裝Zendesk擴充功能，請導覽至 事件轉送 並選取要新增擴充功能的屬性，或改為建立新屬性。

選取或建立所需的屬性後，請導覽至 擴充功能 > 目錄. 搜尋"Zendesk"，然後選取 Install 在Zendesk Extension上。

在UI中選取之Zendesk擴充功能的安裝按鈕

設定擴充功能

重要

根據您的實作需求，您可能需要在設定擴充功能前建立結構、資料元素和資料集。 開始之前，請先檢閱所有設定步驟，以決定您需要為使用案例設定的實體。

選取 擴充功能 左側導覽列中。 下 已安裝，選取 設定 在Zendesk擴充功能上。

在UI中選取之Zendesk擴充功能的設定按鈕

下 Zendesk網域，請輸入您Zendesk子網域的值。 下 Zendesk權杖，選取您先前建立且包含API權杖的密碼。

設定選項已在UI中填寫

設定事件轉送規則

開始建立新的事件轉送規則 規則 並視需要設定其條件。 選取規則的動作時，選取 Zendesk 擴充功能，然後選取 建立事件 動作型別。

定義規則

設定動作設定時，系統會提示您指派資料元素給將傳送至Zendesk的各種屬性。

定義動作設定

這些資料元素應對應，如下所述。

event 金鑰

event 是JSON物件，代表使用者觸發的事件。 請參閱Zendesk檔案，位於 事件剖析 以取得屬性擷取的詳細資訊 event 物件。

下列索引鍵可在 event 物件對應至資料元素時：

event key 類型 平台路徑 說明 必要 限制
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物件。 是 (不適用)
注意

請參閱 Zendesk Events API 檔案 以取得事件屬性的其他指引。

profile 金鑰

profile 是JSON物件，代表觸發事件的使用者。 請參閱Zendesk檔案，位於 個人資料剖析 以取得屬性擷取的詳細資訊 profile 物件。

下列索引鍵可在 profile 物件對應至資料元素時：

profile key 類型 平台路徑 說明 必要 限制
source 字串 arc.event.xdm._extconndev.profile_source 與設定檔相關聯的產品或服務，例如 Support， CompanyName，或 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中的資料

如果事件收集和Adobe Experience Platform整合成功，則Zendesk主控台中的事件應會顯示如下。 這表示整合成功。

設定檔:

Zendesk設定檔頁面

事件：

Zendesk事件頁面

要求限制

根據帳戶型別，Zendesk Events API 可處理下列每分鐘要求數：

Account Type 每分鐘要求數
Team 250
Growth 250
Professional 500
Enterprise 750
Enterprise Plus 1000

請參閱 Zendesk檔案 以取得這些限制的詳細資訊。

錯誤與疑難排解

使用或設定擴充功能時，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中收集事件資料的詳細資訊，請參閱官方檔案：

本頁內容