웹 스토어 카탈로그 스키마 레퍼런스
상품이 웹숍에 표시되는 방식을 제어하는 데 사용할 수 있는 카탈로그 필드를 찾습니다.
읽는 시간 3분최근 업데이트: 한 달 전
웹숍은 프로젝트의 인앱 구매(IAP) 카탈로그에서 제품을 렌더링합니다. 각 제품은 스탠다드 IAP 카탈로그 아이템으로, 카테고리, 고해상도 이미지, 프로모션 처리, 표시 순서, 제품별 배지 등 상점별 필드를 통해 확장할 수 있습니다. 이 필드는 제품이 상점에 표시되는 방식을 제어합니다.
이 레퍼런스는 각 제품에 대해 웹숍이 읽는 필드, 즉 모든 IAP 상품에 있는 기본 카탈로그 필드와 웹숍 확장자 필드를 나열합니다. webshop 확장자 필드는 webshop 카탈로그에 포함된 제품에만 적용됩니다. 카탈로그의 출처와 제품 표시의 작동 방식에 대한 자세한 내용은 카탈로그 및 웹 상점 결제를 참조하십시오. 제품을 작성하려면 에디터에서 카탈로그 만들기를 참조하십시오.
제품 필드
이는 모든 카탈로그 제품의 기본 필드입니다.
Field | Type | 필수 여부 | 설명 |
|---|---|---|---|
| 문자열 | 예 | 제품의 고유 식별자(SKU)입니다. |
| 문자열 | 예 | 제품 유형: |
| 문자열 | 지원 안 함 | 제품 카드에 표시되는 제품 이미지의 URL입니다. |
| 배열 | 예 | 현지화된 디스플레이 세부 정보, 언어당 하나의 엔트리입니다. 현지화된 제품 세부 정보를 참조하십시오. |
| 배열 | 예 | 재화별 가격입니다. 가격 책정을 참조하십시오. |
| 배열 | 지원 안 함 | 다른 스토어별 제품 ID 각 항목에는 |
현지화된 제품 세부 정보
productDetailsField | Type | 필수 여부 | 설명 |
|---|---|---|---|
| 문자열 | 예 | 이 엔트리가 적용되는 언어입니다. |
| 문자열 | 예 | 제품의 표시 이름입니다. |
| 문자열 | 예 | 플레이어에게 제공되는 제품 설명입니다. |
| 문자열 | 지원 안 함 | 제목과 함께 표시되는 선택적인 보조 라인입니다. |
| object | 지원 안 함 | 제품 카드에 표시되는 칩입니다. |
가격 책정
각 항목은 하나의 통화로 가격을 설정합니다. 배열은 최소 하나의 항목을 포함해야 합니다.
pricingUSDField | Type | 필수 여부 | 설명 |
|---|---|---|---|
| 문자열 | 예 | ISO 4217 통화 코드(예: |
| integer | 예 | 제품에 대해 청구된 금액입니다. |
| integer | 지원 안 함 | 웹숍에 표시되는 가격입니다. 제품에 웹별 가격을 지정하려면 이 옵션을 설정합니다. |
금액은 미크로 단위의 정수이며, 1,000,000은 통화 단위입니다. 예를 들어 는 9.99입니다. 수동이 아닌 카탈로그 툴을 통해 가격을 설정합니다. 에디터에서 카탈로그 만들기를 참조하십시오.
9990000웹숍 확장자 필드
이 필드는 기본 카탈로그 제품을 상점별 디스플레이 옵션으로 확장합니다. 이는 웹숍 카탈로그에 있는 제품에만 적용됩니다.
Field | Type | 필수 여부 | 설명 |
|---|---|---|---|
| 문자열 배열 | 지원 안 함 | 제품이 속한 카테고리 ID입니다(최대 16개, 고유). 각 카테고리는 상점에 대해 정의한 카테고리와 일치해야 합니다. |
| 배열 | 지원 안 함 | 제품 세부 정보 다이얼로그를 위한 고해상도 이미지(최대 8). 각 항목에는 |
| object | 지원 안 함 | 카드에 대한 프로모션 처리. |
| integer | 지원 안 함 | 전체 스토어에서 상품의 표시 순서입니다. 낮은 값이 먼저 나타납니다. |
예제
다음 제품은 기본 카탈로그 필드와 웹숍 확장 필드를 모두 포함합니다.
{ "uSKU": "com.example.gems.medium", "type": "소모품", "imageUrl": "https://cdn.example.com/gems-medium.png", "productDetails": [ { "language": "en", "title": "Medium Gem Pack", "description": "게임에서 소모할 수 있는 유용한 보석" "subtitle": "500 gems", "badge": { "text": "최고의 가치", "imageUrl": "https://cdn.example.com/gem-icon.png" } } ], "pricing": [ { "currencyCode": "USD", "amount": 9990000, "webshopPrice": 7990000 } ], "categories": ["gems"], "hdImages": [ { "url": "https://cdn.example.com/gems-medium-hd.png", "altText": "보석 쌓기" } ], "promotion": { "type": "Sale", "endsAt": "2026-07-01T00:00:00Z" }, "sortIndex": 10}