> ## 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 v2 실물 화폐 가격

> PlayFab Economy v2 카탈로그 아이템에 RealMoneyPriceDetails를 구성하여 마켓플레이스별 가격을 설정하고 Apple, Google, Steam의 수익을 추적합니다.

# 실물 화폐 가격

<Info>
  Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 [PlayFab Forum](https://community.playfab.com)을 방문하세요.
</Info>

실물 화폐 가격을 사용하면 마켓플레이스별로 카탈로그 아이템에 실물 화폐 가치를 연결할 수 있습니다. 카탈로그 아이템의 `RealMoneyPriceDetails` 속성에는 지원되는 각 마켓플레이스에 대한 별도의 가격 사전이 포함되어 있습니다. 이 데이터는 PlayFab에서 마켓플레이스 트랜잭션의 수익을 추적하는 데 사용됩니다.

## 개요

플레이어가 외부 마켓플레이스(Apple App Store, Google Play, Steam, Microsoft Store, Nintendo eShop, PlayStation Store)를 통해 아이템을 구매하면 트랜잭션에 실물 화폐가 포함됩니다. 카탈로그 아이템에 `RealMoneyPriceDetails`를 설정하면 PlayFab은 다음을 수행할 수 있습니다.

* [marketplace\_transaction\_redeemed](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed) 이벤트에서 마켓플레이스 리뎀션의 **수익 추적**.

## 형식

`RealMoneyPriceDetails`는 지원되는 각 마켓플레이스에 대한 별도의 가격 사전을 포함하는 개체입니다.

| 속성                       | 형식                        | 설명                              |
| :----------------------- | :------------------------ | :------------------------------ |
| `AppleAppStorePrices`    | `Dictionary<string, int>` | 통화 코드별 Apple App Store 가격 금액.   |
| `GooglePlayPrices`       | `Dictionary<string, int>` | 통화 코드별 Google Play 가격 금액.       |
| `MicrosoftStorePrices`   | `Dictionary<string, int>` | 통화 코드별 Microsoft Store 가격 금액.   |
| `NintendoEShopPrices`    | `Dictionary<string, int>` | 통화 코드별 Nintendo eShop 가격 금액.    |
| `PlayStationStorePrices` | `Dictionary<string, int>` | 통화 코드별 PlayStation Store 가격 금액. |
| `SteamPrices`            | `Dictionary<string, int>` | 통화 코드별 Steam 가격 금액.             |

각 사전은 세 자리 [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) 통화 코드를 **가장 작은 통화 단위**로 표현한 가격(예: USD의 경우 센트)에 매핑합니다.

<Note>
  현재는 통화 코드로 **미국 달러(USD)** 만 지원됩니다.
</Note>

타이틀과 관련된 마켓플레이스 속성만 채우면 됩니다. 예를 들어 게임이 Google Play와 Apple App Store에서만 사용 가능한 경우 `GooglePlayPrices`와 `AppleAppStorePrices`만 설정하면 됩니다.

### 가격 예제

| 실제 가격      | 사전 값           |
| :--------- | :------------- |
| \$0.99 USD | `{"USD": 99}`  |
| \$1.39 USD | `{"USD": 139}` |
| \$4.99 USD | `{"USD": 499}` |
| \$9.99 USD | `{"USD": 999}` |

## 카탈로그 아이템에 실물 화폐 가격 설정

실물 화폐 가격은 일반적으로 `AlternateIds`를 통해 외부 마켓플레이스 제품에 연결된 **번들**에 설정됩니다. 플레이어가 마켓플레이스 구매를 리뎀션할 때 PlayFab은 일치하는 카탈로그 번들의 `RealMoneyPriceDetails` 값을 사용하여 수익을 기록합니다.

### API

`CreateDraftItem` 또는 `UpdateDraftItem`을 사용하여 카탈로그 아이템을 만들거나 업데이트할 때 `RealMoneyPriceDetails`를 설정할 수 있습니다.

```json theme={null}
{
  "Item": {
    "Type": "bundle",
    "Title": {
      "NEUTRAL": "Starter Pack"
    },
    "ItemReferences": [
      {
        "Id": "{{LaserSwordID}}",
        "Amount": 1
      },
      {
        "Id": "{{GoldCurrencyID}}",
        "Amount": 500
      }
    ],
    "RealMoneyPriceDetails": {
      "GooglePlayPrices": {
        "USD": 499
      },
      "AppleAppStorePrices": {
        "USD": 499
      },
      "SteamPrices": {
        "USD": 499
      }
    },
    "AlternateIds": [
      {
        "Type": "GooglePlay",
        "Value": "com.mygame.starterpack"
      },
      {
        "Type": "AppleAppStore",
        "Value": "com.mygame.starterpack"
      },
      {
        "Type": "Steam",
        "Value": "starterpack_001"
      }
    ]
  },
  "Publish": true
}
```

스토어 간에 가격이 다른 경우 마켓플레이스별로 다른 가격을 설정할 수도 있습니다.

```json theme={null}
"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "MicrosoftStorePrices": {
    "USD": 499
  }
}
```

### Game Manager

1. **Economy** > **Catalog (V2)** 로 이동합니다.
2. **Bundles** 탭에서 편집하려는 번들을 선택하거나 새로 만듭니다.
3. **Prices** 섹션에서 각 마켓플레이스의 실물 화폐 가격을 구성합니다.
4. **Marketplace Mapping** 섹션에서 번들을 외부 마켓플레이스 제품에 연결합니다.

***

## 이벤트에 실물 화폐 가격이 표시되는 방법

마켓플레이스 트랜잭션이 리뎀션되면 해당 마켓플레이스의 가격이 [marketplace\_transaction\_redeemed](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed) 이벤트에 `RealMoneyPrices`로 포함됩니다. 예를 들어 Google Play 리뎀션의 경우:

```json theme={null}
{
  "Marketplace": "GooglePlay",
  "MarketplaceTransctionId": "GPA.1234-5678-9012-34567",
  "MarketplaceAlternateId": "com.mygame.starterpack",
  "Amount": 1,
  "ItemId": "{{BundleID}}",
  "ItemType": "bundle",
  "RealMoneyPrices": {
    "USD": 499
  }
}
```

이 이벤트 데이터는 다음과 같이 사용할 수 있습니다.

* Insights Explorer를 통한 사용자 지정 분석 쿼리

## 모범 사례

* **마켓플레이스 번들에는 항상 `RealMoneyPriceDetails`를 설정하세요.** 이렇게 하면 정확한 수익 추적과 분석이 보장됩니다.
* **가장 작은 통화 단위를 사용하세요.** USD의 경우 가격을 센트로 제공하세요(예: \$4.99의 경우 `499`).
* **사용하는 마켓플레이스만 채우세요.** 모든 마켓플레이스의 가격을 설정할 필요는 없습니다 — 타이틀이 게시된 것만 설정하세요.
* **마켓플레이스 목록과 가격을 동기화하세요.** 외부 마켓플레이스에서 가격을 업데이트할 때 정확한 보고를 유지하기 위해 `RealMoneyPriceDetails`의 해당 속성을 업데이트하세요.
* **마켓플레이스별 가격이 다를 때 설정하세요.** 스토어 간 게임의 가격이 다른 경우 마켓플레이스별 속성을 사용하여 각 플랫폼의 실제 가격을 반영하세요.

## 참고 항목

* [Economy v2 번들](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [스토어](/services/playfab/economy-monetization/economy-v2/catalog/stores)
* [Fraud prevention quickstart](/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart)
* [Marketplace integrations](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview)
* [marketplace\_transaction\_redeemed 이벤트](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed)


## Related topics

- [Economy v2 가상 화폐 빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md)
- [Economy v2의 실제 통화 가격 추적](/ko/services/playfab/economy-monetization/economy-v2/tutorials/real-money-price-tracking.md)
- [Catalog 개요](/ko/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview.md)
- [Economy 버전 2(V2) FAQ](/ko/services/playfab/economy-monetization/economy-v2/faq.md)
- [사기 방지, 상환, 영수증 검증](/ko/services/playfab/economy-monetization/economy-v2/fraud-prevention/index.md)