헬프 센터 문서에서 레이블 사용하기

사용 중인 플랜

레이블이란 헬프 센터에 있는 특정 문서에 추가할 수 있는 하나의 단어 또는 여러 단어로 된 문구입니다. 레이블을 사용하여 문서 검색 관련성에 영향을 주거나, 봇 문서 추천을 제어하거나, 레이블을 바탕으로 관련 문서 목록을 만들 수 있습니다.

개별 문서에 레이블을 추가하고 제거할수 있으며, 한 번에 여러 문서의 레이블을 변경할 수 있습니다.

이 문서에서 다루는 주제는 다음과 같습니다.

• 개별 문서에 레이블 추가 및 제거하기
• 여러 문서에서 대량으로 문서 레이블 변경하기
• 레이블을 사용하는 이유 이해하기
• 레이블 추가에 대한 성공 사례
• 헬프 센터 API를 사용해서 레이블로 문서를 필터링하기

개별 문서에 레이블 추가 및 제거하기

레이블이란 헬프 센터에 있는 문서에 추가할 수 있는 하나의 단어 또는 여러 단어로 된 문구입니다. 검색 및 봇 결과에 영향을 주거나 문서 목록을 만드는 등 여러가지 목적으로 문서 레이블을 추가할 수 있습니다(레이블을 사용하는 이유 이해하기 참조).

개별 문서에 레이블을 추가하고 제거할수 있으며, 한 번에 여러 문서에서 대량으로 레이블을 변경할 수 있습니다.

문서에 레이블을 추가 또는 제거하려면 다음과 같이 하세요.

1. 헬프 센터 또는 Guide에서 레이블을 변경하려는 문서로 이동한 다음 위쪽 메뉴 모음에서 문서 편집을 클릭합니다.
2. 사이드바에 문서 설정 창이 표시되지 않으면 문서 설정 아이콘()을 클릭하여 창을 확장합니다.

   

3. 배치 카드를 클릭하여 배치 창을 확장한 다음 레이블 섹션으로 스크롤을 내립니다.
4. 레이블 필드에서 추가하려는 레이블을 입력한 다음 새 레이블로 추가를 선택하거나 이미 존재하는 경우에는 일치하는 레이블을 선택합니다.

   문서 레이블은 대소문자를 구분하지 않습니다. 하지만 문서 검색 시 레이블을 필터링하는 경우(예를 들어 문서 관리 보기에서) 필터는 대소문자를 구분합니다. 아래 레이블 추가에 대한 성공 사례를 참조하세요.

   최대 50개의 레이블을 추가할 수 있습니다. 레이블을 보려면 아래로 스크롤해야 할 수도 있습니다. 레이블 추가에 대한 성공 사례를 참조하세요.

   

   레이블은 기본 언어로 된 문서에 존재하며 문서의 번역본에는 존재하지 않습니다. 번역본이 있다면 기본 문서에 여러 언어로 레이블을 추가할 수 있습니다.

5. 필요에 따라 여러 레이블을 추가하세요.
6. 레이블을 제거해야 하는 경우 레이블 이름 옆에 있는 x를 클릭합니다.
7. 저장을 클릭합니다.

개별 문서에서 또는 API를 사용해서 레이블을 관리해야 합니다. 문서 레이블에 대한 전체 관리를 제공하지 않습니다.

여러 문서에서 대량으로 문서 레이블 변경하기

한 번에 여러 문서에 레이블을 추가하거나 제거할 수 있습니다.

1. Guide의 사이드바에서 문서 관리 아이콘()을 클릭합니다.
2. 찾아보기, 검색 또는 새로운 또는 기존 문서 목록을 사용해서 업데이트할 문서를 찾습니다.
3. 레이블을 변경하려는 하나 이상의 문서를 선택합니다.

   한 번에 최대 30개의 문서를 선택할 수 있습니다.

   

4. 아래에 있는 문서 설정 메뉴를 클릭한 다음 레이블 변경을 선택합니다.
5. 다음 중 하나를 수행합니다.
   • 새 레이블 추가하기: 레이블을 입력한 다음 새 레이블로 추가를 클릭합니다.

     

   • 기존 레이블 추가하기: 검색 또는 찾아보기를 통해 추가할 레이블을 찾은 다음 비어있는 확인란 또는 빼기 부호가 있는 확인란을 선택합니다.

     빼기 부호()는 선택된 문서 전부가 아닌 일부에서 레이블이 표시된다는 것을 의미합니다. 이를 선택하면 체크 표시()로 변경되어 해당 레이블을 가지고 있지 않은 모든 선택된 문서에 추가된다는 것을 의미합니다.

     선택한 문서에 추가할 여러 개의 레이블을 선택할 수 있습니다.

     

   • 기존 레이블 제거하기: 검색 또는 찾아보기를 통해서 제거할 레이블을 찾은 다음 하나 이상의 레이블을 선택 취소합니다.

     체크 표시()는 선택된 문서 전부에서 레이블이 표시된다는 것을 의미합니다. 빼기 부호()는 선택된 문서 전부가 아닌 일부에서 레이블이 표시된다는 것을 의미합니다. 빼기 부호가 있는 확인란을 선택하면 체크 표시로 변하고, 이를 다시 클릭하면 확인란을 선택 취소할 수 있습니다.

     선택한 문서에 추가할 여러 개의 레이블을 선택할 수 있습니다.

     

6. 변경을 클릭합니다.

   선택한 문서에 변경된 레이블이 적용됩니다.

레이블을 사용하는 이유 이해하기

레이블을 사용하여 다음과 같은 효과를 볼 수 있습니다.

• 문서 검색 관련성에 영향

  레이블을 추가하면 문서를 보다 쉽게 검색할 수 있지만, 순위를 세밀하게 조정하는 데에 활용하도록 설계되어 있지는 않습니다. 예를 들어, 와플 만드는 법에 대한 두 개의 문서 중 하나는 문서 본문에 “온도”라는 단어가 있고 하나는 “온도”라는 레이블이 추가되어 있는 경우, 사용자가 “온도”라는 단어로 검색을 할 때 레이블이 있는 문서가 더 높은 순위를 가집니다.

  레이블은 문서 제목보다 낮은 가중치로 검색을 위해 색인화되지만. 비슷한 단어로 여러 개의 레이블을 사용하면 문서 제목과 본문보다 더 높은 가중치를 가질 수 있습니다. 검색 결과의 관련성과 유용성에 상당한 영향을 주기 때문에 레이블은 조심해서 사용해야 합니다. 검색 관련성에 영향을 주기 위해 레이블 사용을 고려하고 있다면, 오히려 사용자에게 더 낮은 성과 순위를 초래할 수 있다는 점에 주의하세요. 검색에서 문서의 성과를 높이는 가장 좋은 방법은 짧고 충실한 문서를 만들어서 제목과 본문이 일관되고 키워드를 포함하도록 하는 것입니다.

  검색에 대해 자세히 알아보려면 헬프 센터에서 최종 사용자 검색이 작동하는 방법을 참조하세요.

• 봇 결과에 영향

  레이블은 추천 문서의 결과에 영향을 미칠 수 있습니다. 관련 일치 결과를 찾을 때에 사용할 수 있는 문서 허용 목록을 정의할 수 있습니다. OR 필터로 작용할 최대 열 개의 레이블을 추가할 수 있으며, 지정한 모든 레이블 중 어느 하나를 포함하고 있는 모든 문서로 허용 목록을 확장할 수 있습니다.

  자세히 알아보려면 레이블을 사용하여 문서 추천을 최적화하기 위한 성공 사례를 참조하세요.

• 문서 목록 만들기

  문서 목록을 사용하면 게시 및 게시 취소된 모든 지식창고 콘텐츠의 개요를 파악한 다음 검색과 필터 적용을 통해 문서 목록을 작성할 보기의 범위를 좁힐 수 있습니다. 예를 들어, ‘오래됨’ 등과 같은 특정 문서 레이블이 있는 문서를 찾을 수 있습니다.

  문서 목록에 대해 자세히 알아보려면 지식창고 콘텐츠의 다른 보기를 위한 문서 목록 만들기를 참조하세요.

레이블 추가에 대한 성공 사례

레이블은 문서의 검색 관련성을 높이는 데에 도움이 됩니다. 하지만 레이블은 신중하고 조심스럽게 사용해야 합니다. 더 중요한 것은 문서 제목과 본문에 관련 키워드를 포함시키는 것입니다.

• 여러 단어로 된 문구보다는 하나의 단어로 된 레이블 사용하기

  하나의 단어 또는 여러 단어나 문구로 된 레이블을 추가할 수 있지만 일반적으로 하나의 단어로 된 레이블이 더 효율적입니다. 여러 단어로 된 레이블을 추가하면 검색 엔진은 각각의 개별 단어를 가지고 검색을 수행합니다. 예를 들어, “늦은 배달”이라는 레이블이 있다면 “늦은”과 “배달”이라고 구분하여 검색합니다.

  쿼리에 대한 문서의 순위를 높이려면 너무 긴 문구를 레이블로 사용하는 것을 피하세요. 예를 들어, “온라인에서 주문한 물건을 근처 가게에서 환불할 수 있나요” 대신에, 쿼리와 직접 관련성을 갖도록 문서의 제목 또는 콘텐츠를 수정하세요.

• 시제를 다르게 하거나 복수형을 사용하는 등 동일한 단어의 변형 추가하지 않기

  단어의 변형에 대해 여러 레이블을 추가할 필요가 없습니다. 예를 들어, “환불”과 “환불들”, “업데이트”와 “업데이트 함”에 대한 별도의 레이블은 필요하지 않습니다. 퍼지 검색은 한 단어의 변형에 대해 일치하는 여러 형태를 검색합니다. 특히 단수 및 복수 형태의 단어가 주로 일치됩니다.

• 문서에 너무 많은 레이블을 추가하는 대신 제한된 수의 레이블 사용하기

  레이블을 조심스럽게 사용하세요. 많은 수의 레이블을 추가하면 이러한 레이블과 완벽하게 일치하는 것을 찾기 어려울 수 있습니다. 즉 레이블 수가 적을 수록 관련성이 더 높은 문서를 검색할 수 있다고 추정되기 때문입니다. 또한 너무 많은 레이블은 제목과 본문의 관련성보다 더 높은 가중치를 가질 수 있습니다.

  예를 들어 문서 1에 “car,” “automobile,” “transport” 레이블이 있고 문서 2에는 “car” 레이블만 있으며, 다른 모든 것들은 동일하다면 최종 사용자가 “car”를 검색할 때 “car” 레이블만 있는 문서의 순위가 더 높습니다. 이는 일반적으로 사용자가 특정 항목을 찾을 때 한 가지 특정 항목에 대한 문서가 여러 항목에 대한 문서보다 관련성이 높기 때문입니다.

  높은 순위의 검색 쿼리를 살펴보고 제목 또는 레이블 중 하나(그러나 둘 다는 아님)에 존재하는지 확인하는 것이 최선입니다. 제목, 본문, 레이블 및 댓글에 걸쳐 용어가 일치하더라도 콘텐츠에 추가 도움이 되지는 않습니다.

• 대소문자를 다르게 사용하여 동일한 단어의 변형을 사용하지 않기

  일반적으로 레이블은 대소문자를 구분하지 않습니다. 즉 "automobile"과 "AUTOmobile"이라는 레이블을 만들 수 있으며 두 개의 별도 레이블로 존재하더라도 사용자는 "automobile"에 대해 텍스트 검색을 수행하여 두 레이블 중 하나가 첨부된 문서에 대한 결과를 받을 수 있습니다. 이는 Guide 검색 기능이 결과를 검색하고 제공하기 전에 레이블 대소문자를 정규화하기 때문입니다. 하지만 필터는 정확히 일치해야 하므로 문서 관리 보기에서 레이블 필터를 사용하여 "automobile" 레이블이 있는 문서를 찾으면 "AUTOmobile" 레이블이 있는 문서를 표시하지 않습니다. 따라서 사용자들이 필요한 레이블을 쉽게 찾아 필터링할 수 있도록 레이블의 대소문자를 일관되게 유지하는 것이 좋습니다.

헬프 센터 API를 사용해서 레이블로 문서를 필터링하기

헬프 센터 API를 사용해서 레이블로 문서를 필터링하는 두 가지 방법이 있습니다.

• 문서: /api/v2/help_center/en-us/articles.json?label_names=foo​
• 검색: /api/v2/help_center/en-us/articles/search.json?label_names=foo

이 두 엔드포인트는 다르게 동작하며 다른 문서 결과를 가져옵니다. 각기 다른 프로그램에 따라서 다른 데이터 소스를 쿼리해서 결과를 가져옵니다. 문서 엔드포인트는 헬프 센터 데이터베이스에 쿼리하는 반면, 검색 엔드포인트는 기본 헬프 센터 검색을 사용합니다. 따라서 연관성 매칭이 검색 엔드포인트의 레이블 쿼리에서 어떤 문서를 리턴할지 결정합니다. 기본 헬프 센터 검색 작동 방식에 대한 자세한 내용은 헬프 센터 최종 사용자 검색에 대한 정보를 참조하세요.