> ## 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.

# Economy(레거시) 빠른 시작

> 초기 카탈로그 설정, 가상 화폐 구성, 기본 아이템 및 스토어 생성을 다루는 PlayFab 레거시 Economy(v1)용 빠른 시작입니다.

# 빠른 시작(레거시 Economy)

<Info>
  Economy v1 API는 유지 관리 모드에 있으며 새 기능은 제공되지 않고 버그 수정만 이루어집니다. **v1 API는 예측 가능한 미래 동안 유지됩니다.** 다음 버전의 PlayFab Economy에 대해 자세히 알아보려면 [Economy v2 개요](/services/playfab/economy-monetization/economy-v2/overview)를 참조하세요!
</Info>

수익화를 성공적으로 이루는 것은 게임에서 가장 큰 과제 중 하나입니다. PlayFab은 화폐, 아이템, 인벤토리라는 세 가지 기본 조각 위에 구축하여 이 경험을 단순화합니다.

이 빠른 시작에서는 다음을 수행합니다.

1. 가상 화폐를 설정합니다.
2. 아이템을 만듭니다.
3. 플레이어의 인벤토리에 아이템을 추가합니다.
4. 경제를 사용자 지정하기 위한 다음 단계를 알아봅니다.

## 가상 화폐 설정

가상 화폐는 게임 내 경제의 기반입니다. 플레이어와 캐릭터에게 이러한 화폐를 부여할 수 있으며, 이를 사용해 아이템을 사거나 거래할 수 있습니다.

아이템은 가상 화폐 또는 실제 통화로 비용을 가질 수 있습니다. 각 타이틀은 여러 임의의 가상 화폐를 지원할 수 있어 게임에서 원하는 교환 매체를 구현할 수 있는 유연성을 제공합니다(예: 금, 보석, 하트, 은하 크레딧).

가상 화폐를 만들려면:

1. **Game Manager**를 열고 왼쪽 사이드 바에서 **Economy**를 선택합니다.
2. **Currency** 탭을 선택합니다.
3. **New Currency**를 선택하고 다음 필드를 변경합니다(아래 이미지 참조).
   * \*\*Currency code (2 uppercase characters)\*\*를 **GD**로 설정합니다.
   * **Display name**을 **Gold**로 설정합니다.
4. **SAVE CURRENCY**를 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fcf039d9e16ac42519f73544b6f3a8fd" alt="아이템 만들기" width="1200" height="394" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png" />

이제 화폐가 설정되었으므로 카탈로그 아이템에 가상 화폐에 해당하는 가격을 할당할 수 있습니다.

## 아이템 만들기

많은 게임은 방패, 레벨 잠금 해제, 파워업과 같은 아이템을 플레이어에게 구매할 수 있도록 제공합니다. 이러한 아이템은 카탈로그에 지정됩니다. 플레이어가 카탈로그에서 아이템을 구매하기 전에 채우기 위해 아이템을 만들어야 합니다.

아이템이 있는 카탈로그를 만들려면:

1. 왼쪽 사이드 바에서 **Economy**를 선택하고 **Catalogs** 탭을 선택합니다.

2. **NEW CATALOG** 버튼을 선택하고 **Catalog version**으로 **main**을 입력합니다. ID가 **One**인 아이템이 자동으로 추가됩니다.

3. **One**을 선택하고 다음 필드를 변경합니다(아래 이미지 참조).

   * **Item ID**를 **apple**로 설정합니다.
   * **Display name**을 **apple**로 설정합니다.
   * **Description**을 **Perfectly normal apple**로 설정합니다.

4. **PRICES** 섹션은 양식 하단에 있습니다.

5. apple의 gold(**GD**) 가격을 **5**로 설정합니다.

6. **SAVE ITEM** 버튼을 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=b07c6dc306edea1d41c9a4d73f5c3915" alt="화폐 편집 또는 저장" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/create-item.png" />

## 플레이어 인벤토리에 아이템 추가

PlayFab의 [Player Item Management (Server)](xref:titleid.playfabapi.com.server.playeritemmanagement) 및 [Player Item Management (Client)](xref:titleid.playfabapi.com.client.playeritemmanagement) API는 다음을 포함한 많은 아이템 구매 전략을 지원합니다.

* 실제 통화
* 가상 화폐
* 다른 아이템 구매를 기반으로 한 트리거된 아이템 부여
* 잠긴(습득 가능한/구매 가능한 키가 있는) 상자와 열린 상자
* 무작위 결과 테이블
* 게임 내 유료 또는 무료 이벤트에 따라 부여되는 구매 불가능한 아이템
* 특히 [Azure Functions를 사용하는 PlayFab CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)와 함께 더 많은 시나리오

**가상 화폐로 구매하여 플레이어의 인벤토리에 아이템을 추가합니다.**

1. 게임에서 가상 화폐가 부여된 플레이어로 로그인합니다. (필요한 경우 [플레이어에게 가상 화폐 부여](/services/playfab/economy-monetization/economy/items/quickstart#giving-virtual-currency-to-a-player)에 자세한 정보가 있습니다.)

2. 다음 요청의 매개 변수와 함께 [GetCatalogItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getcatalogitems)를 호출합니다.
   * `CatalogVersion = "main"`

3. 결과의 `Catalog`에 **GD** 가격 **5**의 **apple**이 포함되어 있는지 확인합니다.

4. 요청에 다음 매개 변수 값을 사용해 [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem)을 호출해 **apple**을 구매합니다.

   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency  = "GD"`
   * `Price =  5`

5. 마지막으로 [GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory)를 호출하고 해당 메서드의 결과를 살펴봅니다. 플레이어의 `Inventory`에 있는 아이템 배열에서 apple을 볼 수 있어야 합니다!

## 경제 사용자 지정을 위한 다음 단계

가상 화폐로 지원되는 아이템이 있는 카탈로그를 확보했다면 다음으로 경제를 활성화할 수 있습니다.

* **실제 통화 구매**: [PlayFab, Unity IAP, Android 시작하기](/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android) 및 [비영수증 결제 처리](/services/playfab/economy-monetization/economy/tutorials/non-receipt-payment-processing) 튜토리얼은 가상 경제를 기존 스토어와 연결하는 데 도움이 됩니다.
* **카탈로그 활용**: 번들, 컨테이너, 드롭 테이블을 만들 수 있습니다. 자세한 내용은 [카탈로그](/services/playfab/economy-monetization/economy/items/catalogs) 튜토리얼을 참조하세요.
* **아이템 특성 사용**: 여러 가격을 정의하고 스택 가능, 거래 가능, 한정판 [아이템](/services/playfab/economy-monetization/economy/items)을 지정할 수 있습니다.
* **고유한 게임 내 판매자 또는 세일 이벤트 설정**: [스토어 및 세일](/services/playfab/economy-monetization/economy/tutorials/stores-and-sales)을 사용합니다.
* **일부 플레이어 세그먼트 생성 및 스토어 사용**: 게임 라이프 사이클 어디에 있든 관계없이 플레이어에게 서로 다른 아이템 및 번들 오퍼를 제공할 수 있습니다. 예제는 [플레이어 세그먼트용 사용자 지정 스토어](/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments) 튜토리얼을 참조하세요.
* **경제 데이터 수집**: PlayFab [보고서](/services/playfab/data-analytics/learn-data/reports/overview)를 사용해 게임을 개선하고 반복할 수 있습니다.


## Related topics

- [스토어(Economy 레거시) 빠른 시작](/ko/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [아이템(레거시 Economy) 빠른 시작](/ko/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Economy(레거시)에서의 스토어 및 세일](/ko/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [카탈로그(레거시 Economy)](/ko/services/playfab/economy-monetization/economy/items/catalogs.md)
- [PlayFab Economy 레거시, Unity IAP, Android 시작하기](/ko/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android.md)