실물 화폐 가격

Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 PlayFab Forum을 방문하세요.

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

개요

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

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 통화 코드를 가장 작은 통화 단위로 표현한 가격(예: USD의 경우 센트)에 매핑합니다.

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

타이틀과 관련된 마켓플레이스 속성만 채우면 됩니다. 예를 들어 게임이 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를 설정할 수 있습니다.

{
  "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
}

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

"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "MicrosoftStorePrices": {
    "USD": 499
  }
}

Game Manager

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

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

마켓플레이스 트랜잭션이 리뎀션되면 해당 마켓플레이스의 가격이 marketplace_transaction_redeemed 이벤트에 RealMoneyPrices로 포함됩니다. 예를 들어 Google Play 리뎀션의 경우:

{
  "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의 해당 속성을 업데이트하세요.
마켓플레이스별 가격이 다를 때 설정하세요. 스토어 간 게임의 가격이 다른 경우 마켓플레이스별 속성을 사용하여 각 플랫폼의 실제 가격을 반영하세요.

XBOX Services

PlayFab

Economy v2 실물 화폐 가격

실물 화폐 가격

개요

형식

가격 예제

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

API

Game Manager

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

모범 사례

참고 항목

​실물 화폐 가격

​개요

​형식

​가격 예제

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

​API

​Game Manager

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

​모범 사례

​참고 항목

실물 화폐 가격

개요

형식

가격 예제

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

API

Game Manager

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

모범 사례

참고 항목