> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/back-office/goods-bo/undefined-8/undefined-2.md).

# 검색 랭킹 관리

특정 검색어 조회 시 검색 결과의 노출 순위를 조정하기 위해, 색인 속성별 랭킹 순위(가중치 등급)를 설정하는 기능을 제공합니다. 상품·기획전·이벤트 색인별로 속성을 선택하고 랭킹 순위를 지정하면, 검색 엔진이 해당 속성에 가중치를 반영하여 노출 순서를 결정합니다.

***

## 주요 기능

* **랭킹 정책 목록 조회**
  * 사이트, 랭킹 기준(색인), 랭킹 순위, 사용여부 조건으로 등록된 랭킹 정책을 조회할 수 있습니다.
* **랭킹 정책 등록/수정/삭제**
  * 목록 그리드에서 직접 행을 추가·수정·삭제하고 저장 버튼으로 일괄 반영합니다. (별도 팝업 없음)
* **랭킹 순위 등급 지정**
  * 속성별 가중치는 숫자 입력이 아닌 랭킹 순위 등급(공통코드 PR073)으로 선택합니다.
* **속성 중복 방지**
  * 동일 사이트에 동일 랭킹 속성은 1건만 등록할 수 있으며, 등록 시 중복 여부를 검증합니다.

## 프로세스 정의

<figure><img src="/files/Ko8DlWr4VxM5T7c0EXqm" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 검색 랭킹 관리

상품 > 검색어 관리 > 검색 랭킹 관리 화면에서 랭킹 정책 목록을 조회한다.
{% endstep %}

{% step %}

### 그리드 행 편집

등록 버튼으로 신규 행을 추가하거나 기존 행의 랭킹 순위·사용여부를 수정한다. 신규 등록 시 동일 사이트 내 속성 중복 여부를 검증한다.
{% endstep %}

{% step %}

### API 서버 호출

저장 버튼 클릭 시 추가/수정/삭제 내역이 일괄 저장된다. (조회: 랭킹 목록 조회 / 저장: 랭킹 정보 등록 및 수정 / 검증: 속성 중복 체크)
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="109.111083984375">API</th><th width="330.111083984375">설명</th><th width="96.8887939453125">Server</th><th width="95.7777099609375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>랭킹 정보 등록 및 <br>수정</td><td>랭킹 정보를 등록 및 수정하는 API 입니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EB%9E%AD%ED%82%B9%20%EA%B4%80%EB%A6%AC&#x26;path=saveRankTypeList">🔗API 확인하기 ></a></td></tr><tr><td>랭킹 목록 조회</td><td>랭킹 정보 목록을 조회하는 API 입니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EB%9E%AD%ED%82%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getRankList">🔗API 확인하기 ></a></td></tr><tr><td>속성 중복 체크</td><td>동일 사이트에 동일 속성이 이미 등록되어 있는지 확인하는 API 입니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EB%9E%AD%ED%82%B9%20%EA%B4%80%EB%A6%AC&#x26;path=checkDuplicatedAttribute">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="129.5555419921875">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>랭킹 기준(색인)</td><td>공통코드 PR044에서 관리 (상품, 기획전, 이벤트)</td><td></td></tr><tr><td>랭킹 속성</td><td>공통코드 PR045에서 관리 — 색인별로 선택 가능한 속성이 다름 (상품명, 위시리스트수, 할인율 …)</td><td></td></tr><tr><td>랭킹 순위</td><td>공통코드 PR073에서 관리 — 가중치 등급 (보통, 매우높음 등). 저장 시 등급별 가중치 값으로 변환되어 적용</td><td></td></tr></tbody></table>

## 사용자 설정 화면

<figure><img src="/files/ZJhvSZBUqNy9Jr0Bf9Hx" alt=""><figcaption></figcaption></figure>