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