Zendesk 연결

Zendesk 는 고객 서비스 솔루션 및 판매 도구입니다.

이 Adobe Experience Platform 대상 을 활용합니다. Zendesk 연락처 API, 대상 id 만들기 및 업데이트 대상자 내에서 연락처로 사용 Zendesk.

Zendesk 전달자 토큰을 인증 메커니즘으로 사용하여 Zendesk 연락처 API. 에 대한 인증 지침 Zendesk 인스턴스는 다음보다 아래에 있습니다. 대상에 인증 섹션.

사용 사례 use-cases

멀티채널 B2C 플랫폼의 고객 서비스 부서는 고객을 위해 매끄러운 개인화된 경험을 보장하기를 원합니다. 부서는 자체 오프라인 데이터로 대상자를 만들어 새 사용자 프로필을 만들거나 다른 상호 작용(예: 구매, 반품 등)에서 기존 프로필 정보를 업데이트할 수 있습니다 Adobe Experience Platform에서 (으)로 이러한 대상자를 보냅니다. Zendesk. 업데이트된 정보 위치 Zendesk 은(는) 고객 서비스 에이전트가 고객의 최신 정보를 즉시 사용할 수 있도록 하여 더 빠른 응답과 해결을 가능하게 합니다.

전제 조건 prerequisites

Experience Platform 사전 요구 사항 prerequisites-in-experience-platform

에 대한 데이터를 활성화하기 전에 Zendesk 대상, 다음 항목이 있어야 합니다. 스키마, a 데이터 세트, 및 세그먼트 생성 위치 Experience Platform.

다음에 대한 Experience Platform 설명서 참조: 대상자 멤버십 세부 정보 스키마 필드 그룹 대상 상태에 대한 지침이 필요한 경우.

Zendesk 전제 조건 prerequisites-destination

Platform에서 로 데이터를 내보내려면 Zendesk 계정 보유가 필요합니다. Zendesk 계정입니다.

수집 Zendesk 자격 증명 gather-credentials

에 인증하기 전에 아래 항목을 적어 두십시오. Zendesk 대상:

자격 증명
설명
Bearer token
에서 생성한 액세스 토큰 Zendesk 계정입니다.
다음 문서를 따르십시오. 생성 Zendesk 액세스 토큰 없는 경우.
a0b1c2d3e4...v20w21x22y23z

가드레일 guardrails

다음 가격 및 요금 제한 페이지 세부 정보 Zendesk 계정과 연결된 API 제한. 데이터와 페이로드가 이러한 제한 내에 있는지 확인해야 합니다.

지원되는 ID supported-identities

Zendesk 는 아래 표에 설명된 id 업데이트를 지원합니다. 자세히 알아보기 id.

대상 ID
설명
필수
email
test@test.com
연락처의 이메일 주소입니다.

내보내기 유형 및 빈도 export-type-frequency

대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.

항목
유형
참고
내보내기 유형
프로필 기반
  • 원하는 스키마 필드와 함께 세그먼트의 모든 멤버를 내보냅니다 (예: 이메일 주소, 전화번호, 성) ​를 입력합니다.
  • 의 각 세그먼트 상태 Zendesk 는 을 기반으로 플랫폼에서 해당 대상 상태로 업데이트됩니다. 매핑 ID 다음 기간 동안 제공된 값: 대상자 예약 단계.
내보내기 빈도
스트리밍
  • 스트리밍 대상은 "항상" API 기반 연결입니다. 대상자 평가를 기반으로 Experience Platform에서 프로필이 업데이트되는 즉시 커넥터가 업데이트 다운스트림을 대상 플랫폼으로 전송합니다. 자세한 내용 스트리밍 대상.

대상에 연결 connect

IMPORTANT
대상에 연결하려면 다음이 필요합니다. 대상 보기대상 관리 액세스 제어 권한. 읽기 액세스 제어 개요 필요한 권한을 얻으려면 제품 관리자에게 문의하십시오.

이 대상에 연결하려면 다음과같이 하십시오. 대상 구성 자습서. 대상 구성 워크플로에서 아래 두 섹션에 나열된 필드를 채웁니다.

다음 범위 내 대상 > 카탈로그 검색 대상 Zendesk. 또는 아래에서 찾을 수 있습니다 CRM 범주.

대상으로 인증 authenticate

아래의 필수 필드를 입력하십시오. 다음을 참조하십시오. 수집 Zendesk 자격 증명 섹션에 자세히 설명되어 있습니다.

  • 전달자 토큰: 에서 생성한 액세스 토큰 Zendesk 계정입니다.

대상에 인증하려면 다음을 선택합니다. 대상에 연결.
인증 방법을 보여 주는 플랫폼 UI 스크린샷입니다.

제공된 세부 정보가 유효한 경우 UI에 연결됨 녹색 확인 표시가 있는 상태. 그런 다음 다음 다음 단계로 진행할 수 있습니다.

대상 세부 정보 입력 destination-details

대상에 대한 세부 정보를 구성하려면 아래의 필수 및 선택 필드를 채우십시오. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.
대상 세부 사항을 보여주는 플랫폼 UI 스크린샷입니다.

  • 이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
  • 설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.

경고 활성화 enable-alerts

경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 다음 안내서를 참조하십시오. UI를 사용하여 대상 경고 구독.

대상 연결에 대한 세부 정보를 제공했으면 을 선택합니다. 다음.

이 대상으로 대상자 활성화 activate

IMPORTANT
  • 데이터를 활성화하려면 대상 보기, 대상 활성화, 프로필 보기, 및 세그먼트 보기 액세스 제어 권한. 읽기 액세스 제어 개요 필요한 권한을 얻으려면 제품 관리자에게 문의하십시오.
  • 내보내려면 id, 다음이 필요합니다. ID 그래프 보기 액세스 제어 권한.
    워크플로우에서 강조 표시된 ID 네임스페이스를 선택하여 대상에 대한 대상자를 활성화합니다. {width="100" modal="regular"}

읽기 스트리밍 대상자 내보내기 대상으로 프로필 및 대상자 활성화 이 대상에 대한 대상자 활성화에 대한 지침을 참조하십시오.

매핑 고려 사항 및 예제 mapping-considerations-example

대상 데이터를 Adobe Experience Platform에서 로 올바르게 보내려면 Zendesk 대상, 필드 매핑 단계를 거쳐야 합니다. 매핑은 Platform 계정의 XDM(Experience Data Model) 스키마 필드와 대상 대상의 해당 필드 간에 링크를 만드는 것으로 구성됩니다.

에 지정된 속성 대상 필드 이 속성은 요청 본문을 형성하므로 속성 매핑 표에 설명된 것과 정확히 동일하게 이름이 지정되어야 합니다.

에 지정된 속성 소스 필드 이러한 제한 사항을 따르지 마십시오. 필요에 따라 매핑할 수 있지만 로 푸시할 때 데이터 형식이 올바르지 않은 경우 Zendesk 그러면 오류가 발생합니다.

XDM 필드를 Zendesk 대상 필드에서 다음 단계를 수행합니다.

  1. 다음에서 매핑 단계, 선택 새 매핑 추가. 화면에 새 매핑 행이 표시됩니다.

  2. 다음에서 소스 필드 선택 창에서 다음을 선택합니다. 속성 선택 범주를 선택한 다음 XDM 속성을 선택하거나 ID 네임스페이스 선택 id를 선택합니다.

  3. 다음에서 대상 필드 선택 창에서 다음을 선택합니다. ID 네임스페이스 선택 범주를 만들고 대상 id를 선택하거나 속성 선택 카테고리에 추가하고 지원되는 스키마 속성 중 하나를 선택합니다.

    • 다음 필수 매핑을 추가하려면 이 단계를 반복하십시오. XDM 프로필 스키마와 Zendesk 인스턴스: |소스 필드|대상 필드| 필수| |—|—| |xdm: person.name.lastName|xdm: last_name| 예 | |IdentityMap: Email|Identity: email| 예 | |xdm: person.name.firstName|xdm: first_name| |

    • 이러한 매핑을 사용하는 예는 다음과 같습니다.

      속성 매핑이 포함된 Platform UI 스크린샷 예입니다.

IMPORTANT
다음 Attribute: last_nameIdentity: email 대상 매핑은 이 대상에 필수입니다. 이러한 매핑이 누락된 경우 다른 매핑은 무시되고 로 전송되지 않습니다. Zendesk.

대상 연결에 대한 매핑 제공을 마치면 을(를) 선택합니다 다음.

대상자 내보내기 예약 및 예제 schedule-segment-export-example

다음에서 대상자 내보내기 예약 활성화 워크플로 단계에서 Platform 대상을 의 사용자 지정 필드 속성에 수동으로 매핑해야 합니다. Zendesk.

이렇게 하려면 각 세그먼트를 선택한 다음, 해당 사용자 정의 필드 속성을 다음에서 입력합니다 Zendesk 다음에서 매핑 ID 필드.

예제는 아래에 나와 있습니다.
대상자 내보내기 예약을 보여 주는 Platform UI 스크린샷 예입니다.

데이터 내보내기 유효성 검사 exported-data

대상을 올바르게 설정했는지 확인하려면 아래 단계를 수행하십시오.

  1. 선택 대상 > 찾아보기 대상 목록으로 이동합니다.

  2. 그런 다음 대상을 선택하고 활성화 데이터 탭을 누른 다음 대상 이름을 선택합니다.
    대상 활성화 데이터를 보여주는 Platform UI 스크린샷 예입니다.

  3. 대상자 요약을 모니터링하고 프로필 수가 세그먼트 내의 수와 일치하는지 확인합니다.
    세그먼트를 보여주는 플랫폼 UI 스크린샷 예입니다.

  4. 에 로그인합니다 Zendesk 웹 사이트를 방문한 다음 연락처 대상자의 프로필이 추가되었는지 확인할 페이지입니다. 대상자로 만든 추가 필드에 대한 열을 표시하도록 이 목록을 구성할 수 있습니다​ 매핑 ID 및 대상자 상태
    대상자 이름으로 만든 추가 필드가 있는 연락처 페이지를 보여 주는 Zendesk UI 스크린샷입니다.

  5. 또는 개인을 드릴다운할 수 있습니다 개인 페이지를 만들고 다음을 확인합니다. 추가 필드 대상 이름 및 대상 상태를 표시하는 섹션입니다.
    대상 이름 및 대상 상태를 표시하는 추가 필드 섹션과 함께 개인 페이지를 보여주는 Zendesk UI 스크린샷입니다.

데이터 사용 및 관리 data-usage-governance

모두 Adobe Experience Platform 대상은 데이터를 처리할 때 데이터 사용 정책을 준수합니다. 방법에 대한 자세한 정보 Adobe Experience Platform 데이터 거버넌스 시행, 다음을 참조하십시오. 데이터 거버넌스 개요.

추가 리소스 additional-resources

에서 제공하는 추가 유용한 정보 Zendesk 설명서는 아래에 있습니다.

변경 로그

이 섹션에서는 이 대상 커넥터에 대한 기능 및 중요 설명서 업데이트를 캡처합니다.

변경 로그 보기
table 0-row-3 1-row-3 2-row-3 layout-auto
릴리스 월 업데이트 유형 설명
2023년 4월 설명서 업데이트
  • 다음을 업데이트했습니다. 사용 사례 고객이 이 대상을 사용하면 언제 이점이 있는지 더 명확하게 설명하는 섹션입니다.
  • 다음을 업데이트했습니다. 매핑 섹션에 올바른 필수 매핑을 반영합니다. 다음 Attribute: last_nameIdentity: email 대상 매핑은 이 대상에 필수입니다. 이러한 매핑이 누락된 경우 다른 매핑은 무시되고 로 전송되지 않습니다. Zendesk.
  • 다음을 업데이트했습니다. 매핑 필수 매핑과 선택적 매핑에 대한 명확한 예가 있는 섹션입니다.
2023년 3월 초기 릴리스 초기 대상 릴리스 및 설명서 게시.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6