# 카탈로그 및 카탈로그 리스트

> Unity IAP에서 카탈로그와 카탈로그 리스트를 사용하는 방법을 이해하고 리스트를 정의하기 위한 최적의 방법을 선택합니다.

Unity 인앱 구매에서 IAP 카탈로그에는 플레이어가 애플리케이션 내에서 구매할 수 있는 모든 디지털 아이템(예: 가상 화폐, 새로운 게임 레벨, 프리미엄 기능, 구독)이 포함되어 있습니다. 카탈로그의 각각의 항목은 카탈로그 리스트입니다.

다음과 같은 방법으로 카탈로그를 정의할 수 있습니다.

| **메서드**                                                                           | **사용 시**                                                  | **D2C 호환 가능?** |
| --------------------------------------------------------------------------------- | --------------------------------------------------------- | -------------- |
| [카탈로그 목록을 프로그래밍 방식으로 정의](./code-catalog.md)합니다.                                   | 스크립트에서 직접 카탈로그를 정의합니다.                                    | 예              |
| 에디터 또는 API를 통해 원격 카탈로그를 [생성](./payment-providers/configure-remote-catalog.md)합니다. | 다음 방법 중 하나를 사용하여 클라이언트 업데이트 없이 리스트를 배포할 수 있는 카탈로그를 생성합니다. | 예              |
| 에디터에서 [IAP Catalog 창](./create-catalog-in-editor.md)을 사용합니다.                      | 이 메서드는 [코드리스 IAP](./codeless-iap.md)를 사용하려는 경우 필요합니다.     | 지원 안 함         |

사용하는 방법에 관계없이 대시보드에서 기존 카탈로그를 임포트하여 대시보드에서 카탈로그를 [관리, 편집 및 배포할 수 있습니다.](./dashboard-catalog/_index.md)

## 속성 나열##listing-attributes

카탈로그의 동작과 플레이어와 디지털 스토어에서 표시되는 모습을 제어하는 표준 속성 세트로 모든 카탈로그 리스트를 정의합니다. 다음은 리스팅의 동작과 프레젠테이션을 정의하는 몇 가지 주요 속성입니다. 자세한 내용은 [카탈로그 스키마](./catalog-schema.md)를 참조하십시오.

### 카탈로그 나열 ID##catalog-listing-id

카탈로그 나열 ID는 기본 항목의 고유한 크로스 플랫폼 식별자입니다. 앱 스토어와 통신하는 데 사용되며 필요한 경우 스토어별 ID로 오버라이드할 수 있습니다. 카탈로그 나열 ID는 소문자, 숫자, 밑줄, 마침표만 포함해야 합니다.

### 제품 유형##product-types

제품 타입은 아이템을 구매하고 복원할 수 있는지 여부를 정의합니다. 다음 제품 유형을 사용할 수 있습니다.

| Type     | 설명                                                                                                  | 예제                                               | D2C 호환 가능? |
| :------- | :-------------------------------------------------------------------------------------------------- | :----------------------------------------------- | :--------- |
| **소모품**  | 플레이어가 여러 번 구매할 수 있고 사용 시 부족한 아이템입니다. 소모품 아이템은 복원할 수 없습니다. 예: 가상 재화 또는 임시 파워업                        | 가상 재화  - 체력 물약  - 임시 파워업                         | 예          |
| **비소모품** | 플레이어가 한 번만 구매할 수 있는 아이템입니다. 이러한 항목은 영구적으로 소유되며 애플리케이션을 다시 설치한 후 복원할 수 있습니다. 예: 새 캐릭터 잠금 해제 또는 광고 제거 | - 무기 또는 갑옷  - 추가 콘텐츠 액세스  - 광고 없음                | 예          |
| **구독**   | 일정 기간 동안 콘텐츠 또는 기능에 대한 액세스 권한을 부여하는 항목입니다. 예: 월간 VIP 액세스 또는 배틀 패스                                   | - 월간 온라인 게임 액세스  - 일일 보너스를 부여하는 VIP 상태  - 무료 평가판 | 지원 안 함     |

### 지급##payouts

Payout 속성(선택 사항)은 성공적인 구매 후 플레이어가 수신하는 콘텐츠(예: 100 골드 코인)를 지정합니다. 각 거래에 특정 아이템과 수량(예: 100 골드 코인)을 연결할 자동 정산을 지정합니다. Payouts 속성을 사용하면 게임 내 인벤토리 관리를 간소화하고 플레이어가 구매에 대한 올바른 보상이나 아이템을 받을 수 있습니다.

코딩된 IAP를 구현하려면 [`ProductCatalog.LoadDefaultCatalog`](https://docs.unity3d.com/Packages/com.unity.purchasing@latest?subfolder=/api/UnityEngine.Purchasing.ProductCatalog.html#UnityEngine_Purchasing_ProductCatalog_LoadDefaultCatalog)를 호출하여 스크립트의 카탈로그에 액세스합니다. 코드리스 IAP의 경우 카탈로그가 자동으로 통합되므로 추가 조치가 필요하지 않습니다. 코드로 자체 카탈로그를 정의하는 것을 선호하는 경우 Unity는 사용자 지정 카탈로그를 생성하는 과정을 간소화하는 선택적 [`CatalogProvider`](https://docs.unity3d.com/Packages/com.unity.purchasing@latest?subfolder=/api/UnityEngine.Purchasing.CatalogProvider.html) 클래스를 제공합니다.