Zendesk 이벤트 API 확장 개요

Zendesk 는 고객 서비스 솔루션 및 영업 툴입니다. 젠데스크 이벤트 전달 확장은 다음을 활용합니다 Zendesk Events API 추가 처리를 위해 Adobe Experience Platform Edge Network에서 Zendesk로 이벤트를 전송하려면 다음을 수행하십시오. 확장을 사용하여 다운스트림 분석 및 작업에서 사용할 고객 프로필 상호 작용을 수집할 수 있습니다.

이 문서에서는 UI에서 확장을 설치하고 구성하는 방법을 설명합니다.

전제 조건

이 확장을 사용하려면 Zendesk 계정이 있어야 합니다. Zendesk 계정에 등록하실 수 있습니다 Zendesk 웹 사이트.

Zendesk 구성에 대한 다음 세부 정보도 수집해야 합니다.

키 유형 설명
하위 도메인 등록 프로세스 중에 고유한 하위 도메인 은 계정별로 만들어집니다. 자세한 내용은 Zendesk 설명서 추가 정보. xxxxx.zendesk.com (다음과 같은 경우) xxxxx 은 계정을 만드는 동안 제공된 값입니다.
API 토큰 Zendesk는 bearer 토큰을 인증 메커니즘으로 사용하여 Zendesk API와 통신합니다. Zendesk 포털에 로그인한 후 API 토큰을 생성합니다. 자세한 내용은 Zendesk 설명서 추가 정보. cwWyOtHAv12w4dhpiulfe9BdZFTz3OKaTSzn2QvV

마지막으로 API 토큰에 대한 이벤트 전달 암호를 만들어야 합니다. 암호 유형을 로 설정합니다. 토큰​및 를 사용하도록 값을 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 이벤트 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에서 이벤트 데이터를 수집하는 방법에 대한 자세한 내용은 공식 설명서를 참조하십시오.

이 페이지에서는