젠데스크 는 고객 서비스 솔루션 및 판매 도구입니다. 더 젠데스크 이벤트 전달 확장은 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 토큰에 대한 이벤트 전달 암호를 만들어야 합니다. 암호 유형을 다음으로 설정 토큰을 클릭하고 값을 Zendesk 구성에서 수집한 API 토큰으로 설정합니다. 의 설명서를 참조하십시오. 이벤트 전달 비밀 암호 구성에 대한 자세한 내용은 을 참조하십시오.
UI에서 Zendesk 확장을 설치하려면 이벤트 전달 확장을 추가할 속성을 선택하거나 새 속성을 대신 만듭니다.
원하는 속성을 선택하거나 만들었으면 다음 위치로 이동합니다. 확장 > 카탈로그. 검색 대상Zendesk", 다음을 선택합니다. Install Zendesk Extension에서
구현 요구 사항에 따라 확장을 구성하기 전에 스키마, 데이터 요소 및 데이터 세트를 만들어야 할 수 있습니다. 사용 사례에 대해 설정해야 하는 엔터티를 결정하려면 시작하기 전에 모든 구성 단계를 검토하십시오.
선택 확장 왼쪽 탐색. 아래 설치됨, 선택 구성 Zendesk 확장.
아래 Zendesk 도메인를 클릭하고 Zendesk 하위 도메인 값을 입력합니다. 아래 Zendesk 토큰를 클릭하고 API 토큰이 포함된 이전에 만든 암호를 선택합니다.
새 이벤트 전달 규칙 만들기 시작 규칙 원하는 대로 조건을 구성합니다. 규칙에 대한 작업을 선택할 때 젠데스크 확장을 선택한 다음 이벤트 만들기 작업 유형.
작업 구성을 설정할 때 Zendesk로 보낼 다양한 속성에 데이터 요소를 할당하라는 메시지가 표시됩니다.
이러한 데이터 요소는 아래에서 참조되는 대로 매핑해야 합니다.
event
키event
는 사용자에 의해 트리거된 이벤트를 나타내는 JSON 개체입니다. 의 Zendesk 문서를 참조하십시오. 사건 해부학 에서 캡처한 속성에 대한 자세한 내용은 event
개체.
내에서 다음 키를 참조할 수 있습니다. event
데이터 요소에 매핑할 때의 개체:
event key |
유형 | 플랫폼 경로 | 설명 | 필수입니다 | 제한 |
---|---|---|---|---|---|
source |
문자열 | arc.event.xdm._extconndev.event_source |
이벤트를 전송한 애플리케이션. | 예 | 사용하지 않음 Zendesk as a value는 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 설명서 프로필 속성에 대한 자세한 내용을 참조하십시오. |
이벤트 컬렉션 및 Adobe Experience Platform 통합이 성공적으로 수행된 경우 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에서 이벤트 데이터를 수집하는 방법에 대한 자세한 내용은 공식 설명서를 참조하십시오.