기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

In-App Purchasing

IAP 클라이언트 API

IAP SDK API

웹숍 관리자 API

웹숍 클라이언트 API

In-App Purchasing

LiveOps
​
​
시작하기
  • 개요
  • IAP 소개
  • IAP v5의 새로운 사항
  • IAP v4에서 v5로 업그레이드
소비자 (D2C)에 대한 직접 결제
  • 소비자 (D2C) 결제 제공업체에게 직접 제공
웹숍
  • 개요
  • 시작하기
  • 빌드 및 퍼블리시
  • 구성
  • 게임에 연결
  • 관리자
  • 웹숍 문제 해결
플랫폼 네이티브 스토어
  • 플랫폼 네이티브 스토어에 대한 IAP 설정
  • 코드리스 IAP
카탈로그 및 스토어 관리
  • 제품 카탈로그 생성
    • 카탈로그 및 카탈로그 리스트
    • 카탈로그 스키마
    • 에디터에서 카탈로그 생성
    • IAP 카탈로그 창 참조
    • 프로그래밍 방식으로 카탈로그 만들기
    • 원격 카탈로그 생성
    • 대시보드에서 카탈로그 관리
    • 코드리스 IAP
    • 스토어
    • Purchases
    • 영수증 확인
    • 구매 복원
  • 지원되는 스토어
  • 레퍼런스
Purchases
  • 구매 관리 및 이행
IAP 성능 모니터링
  • 개요
  • IAP 수익 성과
  • D2C 성능
개인정보
  • 개인정보 보호 및 동의
  1. Unity 인앱 구매

카탈로그 스키마

현지화된 콘텐츠, 가격, 웹숍 디스플레이 메타데이터 등 카탈로그의 리스트를 정의하는 데 사용할 수 있는 필드를 찾습니다.
읽는 시간 2분
최근 업데이트: 한 달 전
카탈로그 스키마는 IAP 카탈로그의 카탈로그 나열 구조를 정의합니다. 각 리스트에는 핵심 ID, 현지화된 디스플레이 콘텐츠, 가격, 선택적인 스토어 메타데이터가 나와 있습니다.
모든 필드가 리스트에 적용되는 것은 아닙니다. 웹숍을 통해 판매하는 경우 추가 표시 옵션으로 리스트를 확장할 수 있습니다. 웹숍 확장자 필드를 참조하십시오.

나열 스키마

카탈로그 리스트를 생성할 때 사용할 수 있는 다음 필드를 참고하십시오.

catalogListingId

string
필수
이 목록의 고유 식별자로, 
uSKU
와는 다릅니다. 동일한 게임 내 아이템에 대한 고유 리스트를 허용합니다.

uSKU

string
필수
제품의 고유 식별자(SKU)입니다. 1~141자, 문자, 숫자, 
.
, 
_
, 
-
문자로 제한됩니다.

type

string
필수
제품 유형입니다. 
Consumable
, 
NonConsumable
, 또는 
Subscription
중 하나입니다.

imageUrl

string
리스트의 표준 이미지 에셋의 절대 HTTPS URL입니다.

productDetails

object[]
필수
지원 언어당 한 개의 엔트리가 포함된 목록의 현지화된 콘텐츠입니다. 최소 하나의 엔트리를 포함해야 합니다.

language

string
필수
이 항목에 대한 BCP 47 언어 태그(예: 
en-US
, 
es-ES
).

title

string
필수
현지화된 리스트 타이틀. 최대 50자.

subtitle

string
현지화된 리스트 자막. 최대 50자.

description

string
플레이어에게 표시되는 현지 리스트 설명입니다. 최대 250자입니다.

badge

object
리스트에 표시되는 프로모션 배지입니다.

text

string
필수
배지 레이블 텍스트(예: 
+125
, 
25% OFF
)

imageUrl

string
배지 이미지 에셋의 절대 HTTPS URL입니다.

pricing

object[]
필수
지원되는 각 통화의 가격 지정 항목입니다. 최소 하나의 항목을 포함하고, 
USD
항목을 포함해야 합니다.

currencyCode

string
필수
ISO 4217 통화 코드(예: 
USD
, 
EUR
).

amount

integer
필수
제품에 대해 청구되는 금액(마이크로(1,000,000마이크로 = 통화 단위 1)입니다. 예를 들어 
9990000
는 9.99입니다. 0보다 커야 합니다.

webshopPrice

integer
웹숍에 표시되는 가격(마이크로)입니다. 제품에 웹별 가격을 지정하려면 이 옵션을 설정합니다.

storeIdOverrides

object
네이티브 스토어의 
uSKU
를 오버라이드하는 스토어별 제품 ID입니다.

store

string
필수
이 오버라이드가 적용되는 스토어입니다. 
apple
또는 
google
중 하나입니다.

value

string
필수
The store-specific product identifier.

예제 카탈로그

다음 카탈로그 리스트에는 기본 카탈로그 필드와 웹숍 확장 필드가 모두 포함됩니다. 가격은 마이크로 단위로 표시되며, 1,000,000은 통화 단위 1개입니다.
[  {    "catalogListingId": "gems_medium_default",    "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  }]

추가 리소스

  • 카탈로그를 만드는 가장 좋은 방법을 이해하려면 IAP 카탈로그 만들기를 참고하십시오.
  • 대시보드에서 카탈로그를 관리합니다.
Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지

    • 나열 스키마

    • 예제 카탈로그

    • 추가 리소스

이 페이지의 문제 보고