# 그루비 서치 추천 테스트 및 적용 방법
## 그루비 서치 추천 테스트 및 적용 방법
**개요**
***
스크립트 설치가 정상적으로 완료된 후 데이터 수집을 위한 기간이 지나면 그루비 서치 알고리즘을 적용하여 추천을 생성할 수 있습니다.
쇼핑몰에서 고객들에게 상품 추천을 노출하기 전에 테스트용 추천을 만들어 확인해 보는 것을 권장합니다.
아래 내용을 참고하시어 상품 추천을 테스트 하신 후 실제 고객들에게 노출할 추천을 만들어 보세요 !
\
**1. 쇼핑몰 URL 패턴 등록**
***
그루비 서치 서비스를 이용하기 위해선 사용하시는 쇼핑몰의 URL 패턴 입력이 필요합니다. 아래 내용을 참고하여 상품 상세 페이지와 검색 결과 페이지 URL 패턴을 입력하세요.
**1-1 상품 상세 페이지**
1\) 사용하시는 쇼핑몰의 상품 상세 페이지로 이동한 후 'http\://'를 제외한 URL 주소 중 공통된 패턴 (예시 쇼핑몰의 경우 '?product\_no=' 까지)을 복사합니다.
그루비가 상품 상세 페이지를 식별할 수 있도록 공통된 URL 패턴을 찾으면 됩니다.\
\
예시1)\
[www.쇼핑몰이름.com/vp/products?itemId=\\](http://www.쇼핑몰이름.com/vp/products?itemId=\\)
\
예시2)\
shopping.쇼핑몰이름.com/p/index.nhn?id=
2\) 그루비 어드민 > 설정 > URL 등록 화면으로 이동하여 복사한 URL 값을 상품 상세 페이지에 입력한 후 '저장' 버튼을 클릭합니다. (모바일도 동일한 방법으로 패턴을 찾아 입력합니다)
\
**1-2 검색 결과 페이지**
1\) 사용하시는 쇼핑몰의 검색 결과 페이지로 이동한 후 'http\://'를 제외한 URL 주소 중 파라미터(?뒤에 나오는 URL주소) 값을 제외한 값을 복사합니다.
2\) 그루비 어드민 > 설정 > URL 등록 화면으로 이동하여 복사한 URL 값을 검색 결과 페이지에 입력한 후 '저장' 버튼을 클릭합니다. (모바일도 동일한 방법으로 패턴을 찾아 입력합니다)
\
**2. 새로운 추천 만들기**
***
개인화 상품 추천 화면에서 '새로운 추천 만들기'를 클릭합니다.
\
**2-1. 기본 설정**
***
1\) 추천명과 접속유형을 입력한 후 '알고리즘 선택하기'를 클릭합니다.
2\) 알고리즘 선택 화면에서 '검색어 추천'을 선택한 뒤 '알고리즘 선택'을 클릭합니다.
3\) '세그먼트 불러오기'를 클릭합니다.
4\) 세그먼트 불러오기 화면에서 '그루비 서치 테스트'를 선택한 후 다음 단계로 이동합니다.
세그먼트 '그루비 서치 테스트'는 테스트용으로 제공되는 세그먼트입니다. 테스트용 세그먼트를 설정한 추천은 '그루비 서치 테스트'라는 키워드를 검색한 사람에게만 노출됩니다.\
\
테스트가 끝난 후 고객들에게 실제로 노출할 추천을 만드실 때는 반드시 추천을 수정하여 세그먼트를 초기화하셔야 추천 상품이 검색 결과 페이지에 방문하는 모든 고객들에게 노출됩니다.
\
**2.2 메시지 설정**
***
1\) 레이아웃 유형 4가지 중 하나를 선택한 후 다음 단계로 이동합니다.
2\) 에디터에서 레이아웃 디자인을 확인한 후 '적용'을 클릭합니다.
추천 에디터에서 상품 추천 레이아웃을 디자인 할 수 있습니다. 추천 에디터에 대한 자세한 설명은 [여기](http://doc.groobee.io/article/26kxlcgy9g-2)을 참고하세요.\
**2-3.옵션 설정**
***
옵션을 확인한 후 '저장'을 클릭합니다.
\
**3. 추천 코드 삽입**
***
1\) 추천 관리 화면에서 HTML 코드를 복사 합니다.
2\) 쇼핑몰 관리자 페이지에서 로그인한 후 검색 결과 페이지를 열어 원하는 위치에 복사한 코드를 삽입합니다. (모바일에도 동일하게 삽입합니다.)
예시 이미지 - 카페 24관리자 화면
\
**4. 상품 노출 확인**
***
1\) 추천 관리 화면에서 추천을 실행합니다.
2\) 쇼핑몰에서 검색 키워드를 입력하여 추천 상품이 정상적으로 노출되는지 확인합니다.
\- 테스트 세그먼트 설정 상태 : "그루비 서치 테스트" 입력 후 노출되는지 확인
\- 세그먼트 초기화 상태 : 모든 검색 결과 화면에서 노출되는지 확인
\
**5. 테스트 종료**
***
추천 상품이 정상적으로 노출되었다면 테스트용 세그먼트가 설정된 추천을 수정하여 세그먼트를 초기화합니다.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.groobee.ai/old-admin/notes/groobee-search/script/apply.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
