> ## 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(레거시)에서의 쿠폰 및 프로모션

> Game Manager에서 PlayFab 레거시 Economy 쿠폰을 생성하고 상환하며 번들 또는 CloudScript와 함께 사용해 게임 내 프로모션을 제공합니다.

# 쿠폰 및 프로모션(레거시 Economy)

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

쿠폰은 고객이 게임에서 인벤토리 아이템을 상환할 수 있도록 생성할 수 있는 문자열 토큰입니다. 번들이나 CloudScript와 결합하면 이러한 쿠폰을 사용해 게임에서 거의 모든 기능을 트리거할 수 있습니다.

## 요구 사항

* [카탈로그](/services/playfab/economy-monetization/economy/items/catalogs), 번들, 컨테이너에 대한 이해.
* [Game Manager](/services/playfab/live-service-management/gamemanager)에 대한 이해.
* [플레이어 인벤토리](/services/playfab/player-progression/player-data/player-inventory)에 대한 이해.

## 쿠폰 생성 및 상환 지침

다음의 모든 예제는 쿠폰을 생성하는 첫 번째 기본 단계를 공유합니다. 이는 Game Manager에서 수행됩니다.

**Game Manager**에서:

* **Title**로 이동합니다.
* 왼쪽 메뉴에서 **Economy**를 선택합니다.
* **Catalogs** 탭으로 이동합니다.

**Items**, **Bundles**, **Containers**의 세 가지 탭 섹션 중 하나에 **Coupons** 링크가 있습니다.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=01c2a878fe4e703656b294f53ee70c21" alt="Game Manager - Economy - Catalog Items - Coupons 버튼" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png" />

이 링크는 해당 섹션의 모든 아이템에 대한 쿠폰을 생성할 수 있는 창을 엽니다. 특정 아이템에 대한 쿠폰을 만들려면:

* **Items** 탭에서 **Coupons**를 선택합니다.
* **Bundles** 아래의 Bundle **Coupons**와 **Containers** 아래의 Container **Coupons**를 선택합니다.

팝업 창은 아래에 제공된 것과 유사합니다. (아이템 목록은 사용자의 타이틀과 일치해야 합니다. 표시된 아이템은 [드롭 테이블](/services/playfab/economy-monetization/economy/tutorials/drop-tables) 튜토리얼에서 설명됩니다).

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=ca852ef6cb03a6bc62d187fa93dca085" alt="Game Manager - 쿠폰 생성" width="1053" height="733" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png" />

쿠폰 생성을 완료하려면:

* 생성할 **쿠폰**의 수량을 선택합니다.

* 그런 다음 **쿠폰**이 생성해야 하는 **Item**을 선택합니다.

* 그러면 **쿠폰** 목록이 있는 **CSV** 텍스트 파일을 다운로드할 수 있습니다.

예제의 링크 중 하나를 선택하면 다음의 쉼표로 구분된 10개의 **쿠폰**이 생성됩니다.

```xml theme={null}
65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz
```

마지막으로, 고객이 코드를 입력할 수 있는 GUI를 제공하면 고객은 쿠폰을 상환할 수 있으며, 이는 [RedeemCoupon](xref:titleid.playfabapi.com.client.playeritemmanagement.redeemcoupon)을 호출합니다.

```csharp theme={null}
// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}
```

### 예제 사례: 인벤토리 아이템 쿠폰

쿠폰을 사용하는 가장 간단한 방법은 인벤토리 아이템을 선물하는 것입니다. 카탈로그를 만든 후에는 앞서 논의한 지침에 따라 일반 아이템에 대한 쿠폰을 생성할 수 있습니다. 이 경우에는 다른 특별 단계가 없습니다.

### 예제 사례: 가상 화폐 쿠폰 *또는* 여러 아이템 쿠폰

쿠폰은 [가상 화폐](/services/playfab/economy-monetization/economy/tutorials/currencies)를 직접 부여할 수 없으며, 단일 아이템만 부여할 수 있습니다.

그러나 번들을 사용해 인벤토리 아이템을 아이템 그룹이나 가상 화폐로 원활하게 변환할 수 있습니다. VC 예제에서는 VC 콘텐츠가 포함된 새 번들 아이템을 만들어야 합니다.

번들을 **15초** 후에 만료되도록 설정합니다. 이렇게 하면 플레이어가 번들을 열자마자 VC를 볼 수 있고 중간 아이템은 보이지 않습니다.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=1811ef16679c9be97687ef51cc436fc0" alt="Game Manager - Economy - 카탈로그 번들 편집" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png" />

여러 아이템도 동일한 방식으로 작동합니다.

* 여러 아이템 또는 [드롭 테이블](/services/playfab/economy-monetization/economy/tutorials/drop-tables)이 있는 번들을 만듭니다.
* **15초** 후에 만료되도록 설정합니다.
* 쿠폰이 번들을 생성할 수 있습니다.
* 그런 다음 번들은 여러 아이템으로 변환됩니다.
* 중간 번들 아이템은 사라집니다.

## 사용 시나리오

* 컨벤션에서의 물리적 보상:
  * 쿠폰 코드 목록을 인쇄하고 컨벤션에서 굿즈로 배포할 수 있습니다.
* 포럼, [푸시 알림](/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart), 이메일과 같은 게임 외 통신.
  * 재획득 캠페인이나 기타 커뮤니티 아웃리치의 일환으로 플레이어에게 쿠폰 코드를 *직접* 보냅니다.
* 토너먼트:
  * [재설정 가능한 리더보드](/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards)를 사용할 때 최고 순위 플레이어에게 쿠폰을 보냅니다.

<Note>
  이 경우 인벤토리 아이템을 직접 부여할 수도 있으므로 게임에 더 관련 있는 것을 선택하세요.
</Note>

## 모범 사례

PlayFab 인벤토리를 사용하면 인벤토리 크기를 상대적으로 작게 유지해야 합니다. 즉, 플레이어당 총 *100개 미만*의 아이템입니다. *너무 많은 아이템*을 부여하는 번들은 조절되거나 속도 제한이 있을 수 있습니다.


## Related topics

- [Economy(레거시)에서의 스토어 및 세일](/ko/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Economy(레거시)에서의 드롭 테이블](/ko/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Economy(레거시)에서의 시간 제한 소모품](/ko/services/playfab/economy-monetization/economy/tutorials/timed-consumables.md)
- [프로모션 코드 주문](/ko/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-promo-codes.md)
- [Economy(레거시)에서의 스토어 세분화 모범 사례](/ko/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation.md)