> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Catalog 개요
> Game Manager에서 PlayFab Economy v2 Catalog의 개요로, 카탈로그 아이템, 가격, 권한 및 게임 콘텐츠를 게시하는 방법을 다룹니다.
Economy v1 API는 유지 관리 모드이며 새 기능은 추가되지 않고 버그 수정만 이루어집니다. **v1 API는 앞으로도 유지 관리됩니다.** PlayFab Economy의 다음 버전에 대해 자세히 알아보려면 [Economy v2 Overview](/services/playfab/economy-monetization/economy-v2/overview)를 참조하세요!
이 개요에서는 **Game Manager**의 **Economy** 섹션에 있는 **Catalog V2** 탭을 설명합니다. PlayFab Economy V2의 Catalog 기능을 설명하고 다양한 Item Types의 모든 필드 속성을 살펴봅니다.
## 카탈로그란?
Catalog는 플레이어가 구매하거나 플레이어에게 부여할 수 있는 아이템을 정의하는 데 사용됩니다. 많은 게임에서는 방패, 레벨 잠금 해제 또는 파워업과 같이 플레이어가 구매할 수 있는 아이템을 제공합니다. 이러한 아이템은 카탈로그에 지정되며 종종 가상 화폐나 실물 화폐로 판매됩니다. PlayFab의 Catalog는 게임의 가상 아이템을 관리할 수 있는 쉬운 방법을 제공하며 게임에서 사용할 수 있는 모든 아이템을 보관할 수 있습니다.
## 아이템 필드 참조
이 섹션에서는 **Game Manager**의 **Economy** 영역에 있는 **Catalog V2** 섹션의 각 필드를 설명합니다.
타이틀을 처음 만들면 카탈로그가 비어 있습니다. 아이템을 만들기 전에는 **Catalog** 섹션에 아이템이 표시되지 않습니다.
**Catalog v2** 섹션에는 다음 탭이 있습니다.
| 탭 | 설명 | 참조 |
| ----------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Items** | 구매하거나 부여받을 수 있는 가상 화폐 또는 실물 화폐 가치가 있는 것. | [PlayFab Economy V2 Items](/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview) |
| **Currency** | 가상 화폐는 다른 카탈로그 아이템을 구매하는 데 사용할 수 있습니다. | [PlayFab Economy V2 Currencies](/services/playfab/economy-monetization/economy-v2/tutorials/currencies) |
| **UGC** | 사용자가 만든 아이템. | [PlayFab Economy V2 UGC](/services/playfab/economy-monetization/economy-v2/ugc) |
| **Bundles** | 부여될 때 플레이어의 인벤토리로 언패킹되는 아이템 및 가상 화폐의 모음. 번들은 Marketplace Mapping 필드를 사용하여 실제 세계 구매에 연결할 수 있습니다. | [PlayFab Economy V2 Bundles](/services/playfab/economy-monetization/economy-v2/catalog/bundles) |
| **Stores** | 스토어를 사용하면 아이템의 기본 카탈로그 가격을 재정의할 수 있습니다. | [PlayFab Economy V2 Stores](/services/playfab/economy-monetization/economy-v2/catalog/stores) |
| **Subscriptions** | 가상 구독을 사용하면 지속형 상품에 대한 시간 기반 액세스를 부여할 수 있습니다. | [PlayFab Economy V2 Subscriptions](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions). |
이러한 각각은 Catalog 내에서 사용할 수 있는 Item Type입니다.
### Catalog V2 아이템 필드
**Catalog V2**의 **Items** 탭에서 **NEW ITEM**을 선택하면 다음 페이지가 표시됩니다.
**New Item** 페이지에는 다음 필드가 포함되어 있습니다. **명시되지** 않은 경우 이러한 필드는 선택 사항입니다.
* **PROPERTIES**
* **Creator Entity Type**:
엔터티 생성자의 유형을 알려주는 **시스템 생성** 필드입니다.
* **Creator Entity ID**:
엔터티 생성자의 고유 ID. Game Manager에서 이 ID는 타이틀 값으로 설정됩니다.
* **Friendly ID**:
코드에서 더 쉬운 참조에 사용할 수 있는 필드입니다. Friendly ID는 모든 아이템에 대해 선택 사항이며 카탈로그 내에서 고유해야 합니다.
* **Title**:
일반적으로 플레이어에게 표시되는 아이템의 일반 이름을 위한 **필수** 필드입니다. **Title**의 간단한 지역화는 locale 키를 사용하여 지원됩니다. 자세한 내용은 [Economy V2 Localization](/services/playfab/economy-monetization/economy-v2/catalog/localization)을 참조하세요.
* **Default Stack ID**:
아이템은 각각의 양을 가진 스택으로 인벤토리에 저장될 수 있으며 StackId로 구분됩니다. 정의되지 않은 경우 인벤토리 작업은 StackId로 *default* 를 사용합니다. 자세한 내용은 [Economy Stacks](/services/playfab/economy-monetization/economy-v2/inventory/stacks)를 참조하세요.
* **Keywords**:
Keywords는 기본 검색 필터링에 사용할 수 있습니다. JSON 형식의 지역화된 키워드 사전입니다. 예제는 [Economy V2 Localization](/services/playfab/economy-monetization/economy-v2/catalog/localization)을 참조하세요.
* **Description**:
JSON 형식의 지역화된 아이템 설명 사전입니다.
* **Content Type**:
이 드롭다운을 사용하여 아이템 Content Type을 선택할 수 있습니다. Content Types는 Catalog Settings(Title Settings > Economy)에 정의되어 있습니다.
* **Display Properties**:
사용자 지정 아이템 속성에 사용할 수 있는 JSON blob입니다.
* **Display Version**:
Display Properties의 버전 관리에 사용할 수 있는 필드입니다.
* **Tags**:
이 필드에는 검색을 위해 카탈로그 아이템을 정리하는 데 사용할 수 있는 태그가 포함됩니다. 태그는 쉼표로 구분된 텍스트 문자열로 입력할 수 있습니다. 이러한 문자열은 Catalog Settings(Title Settings > Economy)에서 미리 정의되어 있습니다.
* **Available Tags**
Catalog Config에 이미 정의된 아이템 태그를 선택하기 위한 편리한 드롭다운입니다.
* **OPTIONS**
* **Hidden**:
현재 이 섹션에 나열된 아이템에 대해 사용 가능한 옵션은 하나입니다. 이 옵션인 **Hidden** 은 아이템이 검색에 노출되지 않도록 합니다.
* **Start Date**:
검색에서 아이템이 사용 가능해져야 하는 시점에 대한 **필수** 날짜 필드입니다.
* **End Date**:
검색에서 아이템을 사용할 수 없게 만드는 시점을 지정하는 날짜 필드입니다.
* **PRICES**
* **Add New Price**:
이 섹션을 사용하여 아이템에 대한 하나 이상의 구매 가격을 지정할 수 있습니다.
* **FILES**
* **Upload**:
여기서 이 아이템과 연결될 수 있는 공용 카탈로그에 저장할 콘텐츠를 업로드할 수 있습니다.
* **IMAGES**
* **Upload**:
여기서 게임 내 카탈로그의 아이템 표시를 위한 썸네일 및 스크린샷을 포함한 다양한 이미지를 업로드할 수 있습니다.
* **PLATFORMS**
* **Manage**:
이 아이템이 대상으로 하는 플랫폼을 지정할 수 있습니다. 플랫폼 목록은 Catalog Settings(Title Settings > Economy)에 정의되어 있습니다.
### 아이템을 Draft 또는 Publish 상태로 저장
Economy V2 카탈로그는 **Draft** 아이템 상태를 지원합니다. *Save as Draft* 하면 아이템 메타데이터는 직접 호출을 통해 사용할 수 있지만 공용 검색에는 노출되지 않습니다. 아이템을 공개할 준비가 되면 **Published** 상태로 설정합니다. 자세한 내용은 [Item Status](/services/playfab/economy-monetization/economy-v2/catalog/item-status) 페이지에서 확인할 수 있습니다.
## 아이템 생성 예제
**Item**을 만들려면:
1. **Game Manager**를 열고 왼쪽 사이드 바에서 **Economy**를 선택합니다.
2. **Catalogs V2** 탭을 선택합니다.
3. **NEW ITEM** 버튼을 선택합니다.
1. 필수 아이템 필드를 채웁니다.
* **Title** (JSON 예: \{"NEUTRAL":"My New Amazing Item"}).
* **Start Date** (오늘 날짜 선택).
4. **SAVE AND PUBLISH** 버튼을 선택하면 Items 페이지로 돌아갑니다.
5. 더 많은 아이템을 추가하려면 **NEW ITEM**을 선택하고 3-5단계를 반복합니다.
### Catalog V2 통화 필드
**Catalog V2**를 선택하고 **Currency** 탭을 연 다음 **NEW CURRENCY**를 선택하면 **New Currency** 페이지가 열립니다.
통화(Currency)에는 [Catalog V2 Item Fields](#catalog-v2-item-fields)와 동일한 모든 필드가 포함됩니다.
### Catalog V2 UGC 필드
**Catalog V2**를 선택하고 **UGC** 탭을 연 다음 **NEW ITEM**을 선택하면 **New User Generated Content** 페이지가 열립니다.
User Generated Content에는 [Catalog V2 Item Fields](#catalog-v2-item-fields)와 동일한 모든 필드 *및* 다음 필드가 포함됩니다.
* **MODERATION STATE**
* **Moderation State**:
아이템을 Approved, Awaiting Moderation 또는 Rejected로 표시하는 쉬운 방법입니다. Moderation State는 게시된 아이템에서만 수정할 수 있습니다.
### Catalog V2 번들 필드
**Catalog V2**를 선택하고 **Bundles** 탭을 연 다음 **NEW BUNDLE**을 선택하면 **New Bundle** 페이지가 열립니다.
이 페이지에는 [Catalog V2 Item Fields](#catalog-v2-item-fields)의 모든 필드 *및* 다음 필드가 포함됩니다.
* **ITEMS**
* **Add**:
번들을 사용하면 여러 아이템을 단일 아이템으로 함께 그룹화할 수 있습니다. 자주 함께 구매되는 아이템이나 한정 시간에만 사용할 수 있는 아이템 번들을 만들 수 있습니다. 자세한 내용은 [Economy V2 Bundles](/services/playfab/economy-monetization/economy-v2/catalog/bundles) 문서를 참조하세요.
* **MARKETPLACE MAPPING**
* **Marketplace**, **Marketplace ID**:
게임 내 아이템을 하나 이상의 마켓플레이스 아이템에 연결하여 리뎀션 시나리오를 지원할 수 있습니다. 자세한 내용은 [Economy V2 In-App Purchases](/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android) 문서를 참조하세요.
### Catalog V2 스토어 필드
**Catalog V2**를 선택하고 **Stores** 탭을 연 다음 **NEW STORE**를 선택하면 **New Store** 페이지가 열립니다.
Stores에는 [Catalog V2 Item Fields](#catalog-v2-item-fields)의 동일한 모든 필드 *및* 다음 필드가 포함됩니다.
* **ITEMS**
* **Add**:
스토어는 카탈로그의 다른 모든 아이템 유형을 포함할 수 있습니다. 모든 카탈로그 콘텐츠는 기본 가격을 유지하거나 여기 나열된 가격으로 이 스토어에서 구매할 수 있습니다. 자세한 내용은 [Economy V2 Stores](/services/playfab/economy-monetization/economy-v2/catalog/stores) 문서를 참조하세요.
새 Catalog가 플레이어에게 몰입감 있고 보람 있는 경험을 만들기 위한 강력하고 유연한 도구가 되기를 바랍니다. 자세히 알아보려면 [Economy V2 Quickstart](/services/playfab/economy-monetization/economy-v2/quickstart)를 자세히 살펴보세요.
### 참고 항목
* [PlayFab Economy V2 Items](/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview)
* [PlayFab Economy V2 Currencies](/services/playfab/economy-monetization/economy-v2/tutorials/currencies)
* [PlayFab Economy V2 UGC](/services/playfab/economy-monetization/economy-v2/ugc)
* [PlayFab Economy V2 Bundles](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [PlayFab Economy V2 Stores](/services/playfab/economy-monetization/economy-v2/catalog/stores)
* [PlayFab Economy V2 Subscriptions](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions)
## Related topics
- [아이템 및 인벤토리 개요](/ko/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Services C API 개요 - PFCatalog.h](/ko/services/playfab/api-references/c/pfcatalog/pfcatalog_members.md)
- [Services C API 개요 - PFCatalogTypes.h](/ko/services/playfab/api-references/c/pfcatalogtypes/pfcatalogtypes_members.md)
- [XBOX 인증 개요](/ko/publishing/certification/overview.md)
- [개요](/ko/build/console-features/audio/overviews/index.md)