검색 크롤러나 API를 사용하여 헬프 센터의 연계 검색 설정하기

Elizabeth Williams

Zendesk Documentation Team

2025년 3월 06일에 편집됨

사용 중인 플랜

Suite

Enterprise 또는 Enterprise Plus

Support(다음 포함)

Guide Enterprise

검색 크롤러나 연계 검색 API를 사용하여 헬프 센터의 연계 검색을 설정할 수 있습니다.

검색 크롤러로 개발자 리소스 없이 연계 검색을 구현할 수 있습니다. 헬프 센터에서 여러 크롤러를 설정하여 같은 웹사이트나 다른 웹사이트의 서로 다른 콘텐츠를 크롤링하고 인덱싱할 수 있습니다.
개발자 리소스가 있는 경우 연계 검색 API를 사용할 수 있습니다. 이 REST API는 외부 콘텐츠의 레코드를 Zendesk 검색 인덱스로 가져와 헬프 센터에 연계 검색을 구현할 수 있습니다.

연계 검색을 설정한 후에는 헬프 센터 검색 결과에 포함하려는 콘텐츠를 구성해야 합니다(헬프 센터 검색 결과에 외부 콘텐츠 포함하기 참조).

참고: 2019년 9월 25일 이전에 헬프 센터 테마를 만든 경우에는 연계 검색을 사용하도록 테마를 수정해야 할 수도 있습니다.

이 문서는 다음 섹션으로 구성되어 있습니다.

헬프 센터의 연계 검색을 위한 검색 크롤러 설정하기
API를 사용하여 헬프 센터의 연계 검색 구성하기

헬프 센터의 연계 검색을 위한 검색 크롤러 설정하기

검색 크롤러로 개발자 리소스 없이 헬프 센터에서 연계 검색을 구현할 수 있습니다. 헬프 센터에서 여러 크롤러를 설정하여 같은 웹사이트나 다른 웹사이트의 서로 다른 콘텐츠를 크롤링하고 인덱싱할 수 있습니다.

참고: 모든 관련 법규 및 관련 웹사이트의 이용 약관을 준수하여 헬프 센터 검색 크롤러를 사용해야 합니다. 그러한 사이트맵과 연결된 도메인을 소유하는 사이트맵만 추가해야 합니다. 헬프 센터 검색 크롤러를 사용하면 크롤러에 추가된 모든 사이트맵에 대한 도메인을 소유하며 그러한 웹사이트를 크롤링할 수 있는 권한이 있음을 확인하는 것입니다.

연계 검색을 위한 검색 크롤러를 설정하려면 다음과 같이 하세요.

Guide의 사이드바에서 설정 아이콘()을 클릭한 다음 검색 설정을 클릭합니다.
크롤러에서 관리를 클릭합니다.
크롤러 추가를 클릭합니다.
이 크롤러 이름 지정에서 다음을 입력합니다.
- 크롤러에 배정하려는 이름: 크롤러 관리 목록에서 검색 크롤러를 식별하는 내부 이름입니다.
- 크롤러 유지 관리 및 문제 해결을 담당하는 Guide 관리자인 소유자: 기본적으로 크롤러 소유자는 크롤러를 만드는 사용자이지만 이 이름을 Guide 관리자로 변경할 수 있습니다.
  크롤러 소유자는 크롤러가 성공적으로 실행되었을 때와 도메인 확인, 사이트 맵 처리 또는 페이지 크롤링 문제 등 오류 알림이 있는 경우 모두 이메일 알림을 받습니다.
크롤링하려는 웹사이트 추가에서 다음을 구성하여 도메인 소유권을 확인합니다.
- 웹사이트 URL - 크롤링하려는 웹사이트의 URL을 입력합니다.
- 도메인 소유권 확인 - 복사를 클릭하여 HTML 태그를 클립보드에 복사한 다음 사이트의 인증되지 않은 홈 페이지의 HTML 코드에 있는 <head> 섹션에 태그를 붙여 넣습니다. 크롤러 설정을 완료한 후에 이 작업을 할 수 있으며 크롤러 편집 페이지에서 항상 확인 태그를 찾을 수 있습니다. 검색 크롤러 관리하기를 참조하세요.
  참고: 크롤러가 실행될 때마다 도메인 확인을 완료해야 하므로 태그가 배치된 후 제거하지 마세요.
사이트맵 추가에서 사이트맵 URL에 크롤러가 사이트를 크롤링할 때 사용할 사이트맵의 URL을 입력합니다.
사이트맵은 사이트맵 XML 프로토콜을 따라야 하며 크롤링하려는 사이트 내의 모든 페이지 목록을 포함해야 합니다. 사이트맵은 사이트의 모든 페이지를 포함하는 표준 사이트맵이거나 크롤링하려는 페이지를 나열하는 전용 사이트맵일 수 있습니다. 모든 사이트맵은 크롤러가 크롤링하도록 구성되어 있는 도메인에 호스팅되어야 합니다. 검색 크롤러는 사이트맵 색인을 지원하지 않습니다.

검색 크롤러가 크롤링할 페이지를 정의하는 서로 다른 사이트맵을 각각 사용하는 동일한 사이트에 여러 크롤러를 설정할 수 있습니다.
사람들이 이 콘텐츠를 쉽게 찾을 수 있도록 필터를 추가하세요에서 최종 사용자별로 검색 결과를 필터링하는 데 사용되는 소스 및 유형 필터를 구성합니다. 소스는 포럼, 문제 추적, 학습 관리 시스템 등 외부 콘텐츠의 출처를 나타냅니다. 유형은 블로그 게시물, 기술 노트, 버그 리포트 등 콘텐츠의 종류를 나타냅니다.
- 소스 - 화살표를 클릭한 다음 목록에서 소스를 선택하거나 + 새 소스 만들기를 선택하여 이 콘텐츠가 있는 곳을 설명하는 이름을 추가합니다.
- 유형 - 화살표를 클릭한 다음 목록에서 유형을 선택하거나 + 새 유형 만들기를 선택하여 이 콘텐츠의 종류를 설명하는 이름을 추가합니다.
마침을 클릭합니다.
검색 크롤러가 만들어졌고 보류 상태입니다. 24시간 내에 크롤러가 도메인의 소유권을 확인한 다음 지정된 사이트맵을 가져와 구문 분석합니다. 사이트맵 처리가 성공한 후에는 크롤로가 페이지를 크롤링하여 콘텐츠를 인덱싱하기 시작합니다. 크롤러가 도메인 확인 중이나 사이트맵을 처리하는 동안 실패하면 크롤러 소유자가 문제 해결에 도움이 되는 팁이 포함된 이메일 알림을 받습니다. 크롤러가 24시간 후에 다시 시도합니다.
참고: Zendesk/External-Content는 검색 크롤러의 사용자 에이전트입니다. 크롤러가 방화벽 차단 요청으로 인해 실패하는 것을 방지하려면 Zendesk/External-Content를 허용 목록에 추가하세요.