> 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://tech.x2bee.com/api-guide/back-office/goods-bo/undefined-8/undefined-2.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.