> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/products/data-quality.md).

# 상품 데이터 품질 평가

연동된 상품 데이터의 품질을 자동으로 점검하고, 보완이 필요한 상품을 확인하는 페이지입니다.

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

{% hint style="info" %}
**\[데이터 평가 기준 시점]**

연동된 상품 데이터를 1시간 주기(매시 정각 기준)로 자동 평가합니다. 기준 시각은 품질 평가 결과 우측 상단에 표시됩니다.
{% endhint %}

***

## **1. 품질 평가 결과**

연동한 상품의 데이터 품질을 요약하여 보여줍니다.

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

### **1-1. 데이터 완성도**

전체 상품 중 4개 평가 항목 모두에서 결함이 없는 상품의 비율입니다. 수치가 높을수록 검색 정확도가 향상되며, 미흡할 경우 검색 노출이 제한되거나 검색 결과 품질이 저하될 수 있습니다.

### **1-2. 기준 충족 상품 수 / 보완 필요 상품 수**

<table><thead><tr><th width="159.92578125">지표</th><th>설명</th></tr></thead><tbody><tr><td><strong>기준 충족 상품 수</strong></td><td>4개 평가 항목(이미지 URL, 상품명, 카테고리, 상세 설명) 모두에서 기준을 충족한 상품 수입니다.</td></tr><tr><td><strong>보완 필요 상품 수</strong></td><td>1개 이상의 항목에서 보완이 필요한 상품 수입니다. 하나의 상품이 여러 항목에 해당할 수 있으며, 중복 없이 집계됩니다.</td></tr></tbody></table>

### **1-3. 평가 항목별 완성도**

각 평가 항목별로 기준을 충족한 상품의 비율을 막대 그래프로 표시합니다. 항목별 상세 기준은 페이지 우측 상단의 **\[평가 항목 안내]** 버튼을 클릭하여 확인할 수 있습니다.

***

## **2. 평가 항목 안내**

4개 평가 항목별 충족 기준은 다음과 같습니다.

<table><thead><tr><th width="160.01171875">평가 항목</th><th>충족 기준</th></tr></thead><tbody><tr><td><strong>이미지 URL</strong></td><td>정상적으로 접근 및 노출이 가능한 URL / 이미지 사이즈 200×200px 이상</td></tr><tr><td><strong>상품명</strong></td><td>텍스트 길이 5자 이상 ~ 200자 이하 / HTML 태그 및 깨진 문자(특수기호 오류 등) 미포함</td></tr><tr><td><strong>카테고리</strong></td><td>대분류 외 세부 카테고리 매핑</td></tr><tr><td><strong>상세 설명</strong></td><td>이미지가 아닌 실제 텍스트 길이 30자 이상</td></tr></tbody></table>

{% hint style="warning" %}
이미지를 불러올 수 없거나 가로와 세로가 모두 10px 미만인 상품은 **검색 결과에서 제외**됩니다. 해당 상품은 검색 결과에 노출되지 않으므로 우선적으로 이미지를 교체해 주세요.
{% endhint %}

***

## **3. 보완 필요 상품**

평가 항목별로 보완이 필요한 상품을 확인하고 다운로드할 수 있습니다.

<figure><img src="/files/6GUOUKsol8zjI7JgFYNu" alt=""><figcaption></figcaption></figure>

### **3-1. 항목별 보완 필요 상품 수**

각 평가 항목에 해당하는 보완 필요 상품 수를 표시합니다. 하나의 상품이 여러 항목에 해당할 수 있습니다.

<table><thead><tr><th width="159.54296875">항목</th><th>보완 필요 기준</th></tr></thead><tbody><tr><td><strong>이미지 URL</strong></td><td>이미지를 불러올 수 없거나 가로 또는 세로가 200px 미만인 상품입니다. 기준에 맞는 이미지로 교체해 주세요.</td></tr><tr><td><strong>상품명</strong></td><td>상품명이 5자 미만 또는 200자 초과이거나, HTML 태그·깨진 문자가 포함된 상품입니다. 상품명을 수정해 주세요.</td></tr><tr><td><strong>카테고리</strong></td><td>대분류까지만 매핑된 상품입니다. 카테고리를 더 세분화해 주세요.</td></tr><tr><td><strong>상세 설명</strong></td><td>텍스트가 30자 미만인 상품입니다. 상세 설명을 보완해 주세요. (이미지 내 텍스트는 인식되지 않음)</td></tr></tbody></table>

### **3-2. 보완 필요 상품 리스트**

항목 탭을 선택하면 해당 항목의 보완 필요 상품 목록을 확인할 수 있습니다.

<table><thead><tr><th width="160.25390625">탭</th><th>표시 컬럼</th></tr></thead><tbody><tr><td><strong>이미지 URL</strong></td><td>SKU, 상품명, 이미지 URL, 이미지 사이즈</td></tr><tr><td><strong>상품명</strong></td><td>SKU, 상품명</td></tr><tr><td><strong>카테고리</strong></td><td>SKU, 상품명, 카테고리 경로</td></tr><tr><td><strong>상세 설명</strong></td><td>SKU, 상품명, 상세 설명</td></tr></tbody></table>

### **3-3. 다운로드**

현재 선택된 탭의 보완 필요 상품 목록을 CSV 파일로 다운로드할 수 있습니다.

***

## **자주 묻는 질문**

<details>

<summary><strong>Q. 데이터 완성도 수치는 어떻게 산출되나요?</strong></summary>

(전체 보유 상품 수 − 보완 필요 상품 수) ÷ 전체 보유 상품 수 × 100으로 산출됩니다. 소수점 첫째 자리까지 표시되며, 둘째 자리 이하는 버림 처리됩니다.

</details>

<details>

<summary><strong>Q. 보완 필요 상품 수와 항목별 상품 수의 합계가 다릅니다.</strong></summary>

보완 필요 상품 수는 1개 이상의 항목에서 결함이 있는 상품을 **중복 없이 집계한 수치**입니다. 반면, 항목별 상품 수는 각 항목에 해당하는 상품을 개별적으로 집계하므로 하나의 상품이 여러 항목에 중복 포함될 수 있습니다.

</details>

<details>

<summary><strong>Q. 평가 결과가 실시간으로 반영되나요?</strong></summary>

평가는 매시 정각에 실행됩니다. 상품 데이터를 수정한 직후에는 반영되지 않으며, 다음 정시 평가 이후 결과가 갱신됩니다.

</details>


---

# 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://help.genser.ai/products/data-quality.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.