BLOG / productgroup-variant-sku-gtin.mdx
ProductGroup, Variant, SKU, GTIN: 모호하면 중단하는 식별 가이드
상품군, 옵션 조합, 시장·언어 문서, 안정적 URL, SKU, GTIN을 누락된 식별자를 추측하지 않고 모델링합니다.
식별은 상품 선택을 좁혀야지 확실성을 만들어 내면 안 됩니다. v0.10에서는 모든 Variant에 비어 있지 않은 판매자 sku가 필수입니다. 판매자 SKU가 없는 실제 상품은 현재 적합한 Product Document를 만들 수 없습니다. 안정적인 소스 ID는 유용하지만 sku를 대체하지 못합니다. GTIN과 MPN은 생략할 수 있습니다.
SKU.md는 판매자가 직접 호스팅하는 상품 탐색 및 안정적인 상품 지식 계층입니다. Agent가 상품을 찾고, 출처가 있는 사실을 이해하며, 실시간 상거래 정보를 어디에서 다시 확인해야 하는지 알도록 돕습니다. 새로운 Checkout 프로토콜이 아닙니다.
네 식별 개념은 서로 다른 질문에 답합니다
| 개념 | 답하는 질문 | 생략 가능 여부 |
|---|---|---|
| ProductGroup | 관련 상품군은 무엇인가 | 상품군을 모델링하지 않으면 가능 |
| Variant | 구매 가능한 정확한 옵션 조합은 무엇인가 | 선택 가능한 품목이라면 불가 |
| SKU | 판매자가 부여한 재고 참조는 무엇인가 | 불가. v0.10은 모든 Variant에 요구 |
| GTIN | 등록된 국제 거래 품목은 무엇인가 | 가능 |
Schema.org Product는 sku, gtin, isVariantOf 같은 속성을 지원하지만, 어휘가 있다고 판매자가 값을 입력하고 관리한다는 보장은 없습니다. SKU.md는 알려진 식별자를 보존하고 제목이나 URL 조각에서 추론하지 않습니다. 생략 가능한 GTIN·MPN과 달리 판매자 sku는 v0.10 적합성 요구 사항입니다.
옵션 조합이 Variant를 정의합니다
판매자가 S, M, L을 판다면 “파란 재킷”은 모호합니다. Variant는 원본 시스템에서 품목을 구분하는 데 필요한 옵션 선택 전체를 포함해야 합니다. 제목이 같아도 재단, 시장, 묶음 수량, 소재가 다르면 유사도만으로 고르면 안 됩니다.
- 안정적인 출처에서 상품군을 찾습니다.
- 필요한 모든 옵션 이름과 값을 맞춥니다.
- 안정적인 Variant ID와 필수 판매자 SKU를 비교하고 GTIN이 있으면 확인합니다.
- 식별자가 충돌하거나 후보가 여러 개면 중단합니다.
시장, 언어, URL은 차원이지 식별 지름길이 아닙니다
같은 Variant의 현지화 페이지, 시장별 Variant, 문구가 비슷한 별도 상품이 있을 수 있습니다. content_language는 문서 언어를, market은 커머스 맥락을 나타냅니다. 어느 필드도 문서 둘이 같은 Variant를 설명한다고 단독으로 입증하지 않습니다.
표준 URL과 상위 문서 URL은 개정 뒤에도 안정적으로 유지합니다. 단종 상품을 카테고리 페이지로 리디렉션하면 사람에게는 편하지만, 기존 문서의 사실을 새 품목에 조용히 붙여서는 안 됩니다. 지원한다면 대체 상품이나 단종 정보를 명시합니다.
누락되거나 충돌하면 안전하게 중단하기
| 상황 | 안전한 결과 |
|---|---|
| GTIN 누락 | 다른 식별이 정확하면 GTIN 없이 계속 |
| 판매자 SKU 누락 | 만들지 않음. 판매자가 부여·관리할 때까지 적합한 v0.10 Product Document를 만들 수 없음 |
| SKU 일치, Variant ID 충돌 | 중단하고 불일치 보고 |
| 부분 옵션에 두 Variant가 일치 | 빠진 옵션 질문 |
| 시장 페이지가 구매 품목을 변경 | 별도 매핑 판단으로 취급 |
안정적인 소스 ID는 복구와 매칭에 도움을 줘도 sku를 대체하지 못합니다. 모호하면 중단해야 잘 작성된 Fact, Claim, Disclosure가 잘못된 품목에 적용되는 일을 막을 수 있습니다.
더 읽기
정확한 매칭 흐름은 AI 커머스 권한 인계에서, 지식 관리는 상품 지식의 사실·주장·고지·한계에서 확인하세요.