AI 검색 바

개요

AI 검색 바는 웹사이트용 독립형 검색 위젯입니다. 방문자가 자신의 말로 입력하면 입력을 멈추는 순간 바 아래에 일치하는 결과가 나타납니다: 실시간 데이터 피드의 제품은 이미지와 가격이 있는 카드로, 지식 베이스의 페이지는 제목, 짧은 미리보기, 링크와 함께 표시됩니다. 정확한 키워드뿐 아니라 의미로 검색하기 때문에 설명을 입력한 방문자도 원하는 항목을 찾을 수 있습니다.

챗봇과 같은 지식 베이스를 사용하므로 추가로 색인하거나 관리할 것이 없습니다. 두 위젯은 독립적입니다: 검색 바만, 채팅 위젯만, 또는 같은 페이지에서 둘을 함께 사용할 수 있습니다.

웹사이트에 추가하기

AI 검색창은 Standard 이상 요금제가 필요합니다. 하위 요금제에서는 검색창이 사이트에 보이기는 하지만 결과를 전혀 반환하지 않으니, 아무 일도 일어나지 않으면 먼저 요금제를 확인하세요.

위젯 ID는 대시보드의 AI 검색창 페이지에 표시됩니다.

가장 쉬운 방법: 기존 검색창을 대체하기

사이트에 이미 검색이 있다면 - Shopify 테마 검색, WordPress 검색 폼, 또는 직접 만든 것 - 아무것도 배치하거나 테마를 수정할 필요가 없습니다. script 태그에 data-replace를 추가하면 위젯이 기존 검색 폼을 찾아 숨기고 정확히 그 자리에 나타납니다:

이 스크립트는 페이지 어디에 두어도 됩니다. 헤더나 푸터에 코드를 넣어 주는 플러그인이면 무엇이든 괜찮습니다. 결과를 고르지 않고 Enter를 누르면 기존 검색 결과 페이지가 그대로 열리므로 방문자에게 익숙한 동작은 사라지지 않습니다. 특이한 테마에서 자동 감지가 엉뚱한 요소를 고르면 auto 대신 CSS 선택자를 지정하세요. 예: data-replace=".header-search". 일치하는 것이 없으면 위젯은 페이지를 그대로 둡니다.

직접 배치하기

아직 검색창이 없거나 특정 위치에 두고 싶다면, 검색창이 나타날 자리에 두 줄을 모두 붙여 넣으세요. 예를 들어 헤더의 로고 옆입니다. 검색창은 넣은 요소의 너비를 채우므로 보통 테마 템플릿을 수정해야 합니다.

잘 되지 않을 때

• 검색창이 전혀 보이지 않습니다. 스크립트의 위젯 ID가 대시보드 AI 검색창 페이지의 것과 일치하는지, 그리고 코드가 초안이나 미리보기가 아니라 실제 공개된 페이지에 있는지 확인하세요.
• 검색창은 보이는데 결과가 전혀 없습니다. 대부분 요금제 문제입니다. 검색은 Standard 이상에서 작동합니다. 월 AI 응답 한도를 모두 쓴 경우에도 같은 상태가 됩니다.
• 페이지는 나오는데 제품이 없습니다. 제품은 Real-Time Data Feed에서 옵니다. AI 검색창 페이지에서 피드를 연결하고, 해당 페이지의 피드 소스 체크박스가 켜져 있는지 확인하세요.
• 어떤 검색을 해도 아무것도 나오지 않습니다. 지식 베이스가 아직 비어 있을 수 있습니다. 먼저 웹사이트를 크롤링하거나 대시보드에서 콘텐츠를 추가한 뒤 다시 시도하세요.
• data-replace가 검색창을 찾지 못했습니다. 일부 테마는 검색을 버튼이나 팝업 뒤에 숨깁니다. auto 대신 원하는 요소의 CSS 선택자를 지정하고, 테마 편집기가 아니라 일반 브라우저 창에서 페이지를 확인하세요.

검색 소스

대시보드의 AI 검색 바 페이지에 있는 두 개의 체크박스로 검색이 사용할 수 있는 항목을 제어합니다: 웹사이트 페이지(크롤링된 페이지와 추가한 URL)와 실시간 데이터 피드입니다. 둘 다 기본적으로 켜져 있습니다. 피드는 제품에 한정되지 않습니다 - 글이나 매물 등 그곳에 색인한 모든 것이 결과로 나타날 수 있습니다. 변경 사항은 사이트에 즉시 적용됩니다.

제품 결과를 표시하려면 데이터 피드가 연결되어 있어야 합니다. 두 종류 모두 사용할 수 있습니다. Standard 플랜 이상의 실시간 데이터 피드와 Pro의 실시간 데이터 피드 Max입니다. 피드가 없어도 검색은 그대로 작동하며, 다만 웹사이트 페이지만 반환됩니다. 대시보드 페이지에서는 피드가 연결 안 됨으로 표시되므로 제품이 나오지 않는 이유를 알 수 있습니다.

검색 분석

대시보드의 AI 검색 바 페이지는 최근 30일간의 검색을 보여줍니다. 검색이 몇 번 실행되었는지, 그중 몇 번이 결과가 없었는지, 방문자가 결과를 얼마나 자주 열었는지 확인할 수 있습니다. 두 개의 표에 가장 많이 쓰인 검색어와 결과가 없던 검색어가 나옵니다. 두 번째 표가 더 유용합니다. 방문자가 무엇을 기대했고 무엇을 찾지 못했는지 그대로 알려주기 때문입니다.

기록은 기본으로 켜져 있으며 같은 페이지의 체크박스 하나로 끌 수 있습니다. 끄면 검색어가 전혀 저장되지 않고 표도 더 이상 갱신되지 않지만, 검색 자체는 이전과 똑같이 계속 작동합니다.

대시보드 페이지에서 직접 실행한 검색은 절대 집계되지 않습니다. 제로 보관 모드를 사용하는 웹사이트는 검색 문구를 전혀 기록하지 않으며, 보관 정책을 설정하면 검색 기록은 대화와 같은 일정에 따라 삭제됩니다.

결과가 보이는 방식

대시보드의 AI Search Bar 페이지에 있는 두 가지 설정으로 검색창과 결과의 모습을 바꿀 수 있습니다. 둘 다 선택하는 즉시 저장되며 코드 수정이 필요 없습니다.

제품 결과 상세도

각 제품 이름 아래에 데이터 피드의 설명 한 줄을 표시할 수 있습니다. 도움이 될지는 전적으로 피드의 내용에 달려 있습니다. 여행 기간과 남은 자리를 알려주는 여행 피드라면 보여줄 가치가 있습니다. 반면 속성 목록만 들어 있는 피드는 데이터베이스 출력처럼 보입니다.

그래서 선택은 여러분의 몫입니다. 이름만, 한 줄, 또는 두 줄. 기본값은 한 줄이며 대부분의 피드에 적합합니다. 목록을 빽빽하게 만들지 않으면서도 비슷한 두 제품을 구분하기에 충분하기 때문입니다. 이는 제품 결과에만 적용되며, 페이지 결과는 언제나 방문자의 검색에 일치한 텍스트를 보여줍니다.

검색창 크기

검색창 높이는 세 가지입니다. 좁은 헤더용 38픽셀, 기본 44픽셀, 검색 중심 페이지용 52픽셀. 글자 크기도 함께 바뀝니다.

너비는 저희가 정하지 않습니다. 검색창은 항상 배치한 요소를 가득 채우므로 너비는 여러분의 레이아웃이 결정합니다. 결과 패널은 자동으로 검색창에 맞춰집니다.

크기를 바꾼 뒤에는 임베드 코드를 다시 복사하세요. 새 코드에 크기가 담겨 있어 페이지가 열리는 순간부터 알맞게 보입니다. 다시 복사하지 않아도 검색창은 스스로 크기를 조정하지만, 첫 검색이 실행된 뒤에야 적용됩니다.

검색 결과가 없을 때

같은 페이지에 채팅 위젯이 있으면, 검색 결과가 없을 때마다 검색 바가 그 질문을 어시스턴트에게 넘기도록 제안합니다. 방문자는 질문을 그대로 가지고 채팅으로 이동하며, 질문은 이미 입력되어 있습니다. 막다른 길이 대화로 바뀝니다. 이 옵션은 채팅 위젯이 있을 때만 나타납니다.

옵션

검색 바는 플레이스홀더, 결과 제목, 로딩 텍스트에 방문자의 브라우저 언어를 자동으로 사용합니다. 직접 작성한 문구를 쓰려는 경우에만 이 값을 설정하세요.

두 제목은 대시보드의 AI 검색창 페이지에서도 코드 변경 없이 바꿀 수 있습니다. 데이터 피드에 제품 대신 기사나 매물이 들어 있다면 이쪽이 더 간단합니다. script 태그의 속성은 여전히 대시보드 설정보다 우선합니다.

모든 속성은 선택 사항이며 script 태그에 추가합니다:

• data-placeholder="Search products..." - 비어 있는 검색 바에 표시되는 텍스트
• data-accent="#0a7d4f" - 브랜드에 맞출 수 있는 포커스 및 강조 색상
• data-max-results="8" - 표시할 결과 수, 1에서 20까지
• data-new-tab="true" - 결과를 새 브라우저 탭에서 열기
• data-size="sm" - 검색창 높이: sm, md 또는 lg. 대시보드에서 설정한 크기보다 우선합니다
• data-label-products="Products" - 피드 결과 위의 제목, 원하는 언어로 - 예를 들어 피드에 글이 담겨 있다면 '글'
• data-label-pages="Pages" - 페이지 결과 위의 제목, 원하는 언어로
• data-label-empty="No results found" - 일치하는 항목이 없을 때의 메시지
• data-label-searching="Searching..." - 결과를 불러오는 동안 표시되는 텍스트
• data-label-ask-ai="Ask our assistant" - 결과가 없는 검색을 챗봇에게 넘기는 옵션의 문구
• data-target=".my-container" - 기본 컨테이너 대신 이 요소 안에 바를 렌더링합니다
• data-replace="auto" - 테마에 이미 있는 검색 바를 대체합니다. 위 설명을 참고하세요

사용량 및 요금 청구

방문자가 실행하는 각 검색은 월간 플랜 한도에서 AI 답변 1회를 사용합니다 - 챗봇 답변이 사용하는 것과 같은 한도입니다. 검색은 방문자가 입력을 멈출 때 실행되며 글자마다 실행되지 않습니다. 대시보드의 AI 검색 바 페이지에서 직접 실행하는 검색은 집계되지 않습니다. 월간 한도에 도달하면 한도가 초기화될 때까지 검색 바는 결과를 표시하지 않을 뿐입니다.

알아두면 좋은 점

• 콘텐츠가 다른 언어로 작성되어 있어도 방문자는 어떤 언어로든 검색할 수 있습니다.
• 오타나 입력하다 만 단어로도 원하는 결과를 찾습니다. 예를 들어 ‘자켓’으로 검색해도 재킷을 찾아냅니다.
• 제품 가격은 피드의 통화에서 가져온 통화 기호와 함께 표시됩니다.
• 여러 언어로 된 같은 페이지는 한 번만 표시됩니다 - 검색 언어와 일치하는 버전이 우선합니다.
• 결과는 사이트의 실제 페이지를 열기 때문에 검색 바는 내비게이션 역할도 합니다.
• 위젯은 종속성이 없는 작은 스크립트 하나이며 페이지 속도를 늦추지 않습니다.
• 키보드 조작이 기본으로 작동합니다: 화살표 키로 이동, Enter로 열기, Escape로 닫기.