仮想通貨

どのように動作するか

仮想通貨は、仮想商品の売買に使用される仮想のお金です。その目的に応じて、仮想通貨はゲーム経済のバランスに影響を与えたり、アプリのマネタイズに繋がったりします。

主な機能：

任意の金額の仮想通貨または固定金額の別の通貨パッケージを販売します。
ハード通貨を販売します。
実際通貨または仮想通貨で仮想通貨と仮想通貨のパッケージを販売します。
購入できる仮想通貨パッケージ数を制限します。
ストア内の仮想通貨および仮想通貨パッケージの表示時間を制限します。
無料アイテム。

価格の価値がゼロの仮想通貨と仮想通貨のパッケージを作成したい場合は、カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。

割引、プロモーションコードまたはクーポンのあるキャンペーンでは、仮想通貨パッケージを使用する必要があります。任意の金額の仮想通貨は、ボーナスのあるキャンペーンでのみ使用できます。

通貨を販売するためのオプション

仮想通貨の売却方法には、以下のような選択肢があります：

任意の金額の仮想通貨を販売する
仮想通貨のパッケージを販売する

任意の量の仮想通貨を販売する

仮想通貨をユーザーが必要とする金額で販売します。アプリのクライアント側に、購入に必要な通貨の金額を入力するリクエストを実装します。

まずは最低でも1つのアイテムを作成します。

事前定義された金額で仮想通貨を販売します。この機能では、ゲーム内通貨をパッケージで販売することができ、その通貨をカスタム金額で購入した場合よりも価格を下げることができます。

例：パッケージの場合、そのパッケージ内の仮想通貨の金額と等しくない特別価格を定義できます。例えば：1仮想コイン = 1米ドル。500仮想コイン = 450米ドル。

制限：

1つのパッケージには1種類の仮想通貨しか追加できません。
仮想通貨パッケージは、実際通貨や仮想通貨での価格を指定せずに作成することができます。そのようなアイテムがストアに表示された場合、ユーザーは無料で入手できます。
仮想通貨の金額は整数値でのみ指定できます。

通貨配送

利用可能な配送方法：

エクソーラインベントリに直接（デフォルトの方法）。配信前に仮想通貨のパッケージが解凍され、パッケージからの通貨がプレイヤーインベントリに付与されます。
統合を構成するには、PlayFabへ。

インゲームストアロジックがサーバーに実装されている場合は、ウェブフック購入を設定することができます。

ハード通貨

ハード通貨とは、購入のプラットフォームに連動した通貨で、リアルマネーでしか購入できない通貨のことです。

制限：

最初の設定時のみ通貨のステータスをハードにすることができます。
実際通貨だけのハード仮想通貨を使って、仮想通貨のパッケージを販売することができます。

ハード通貨を別のプラットフォームで別々に保管するには：

ハード仮想通貨トグルをオンに設定します。

インベントリ管理のためのAPIエンドポイントを呼び出す際には、platformフィールドに購入プラットフォームを指定した文字列を渡します。

例

Copy

Full screen

Small screen


"platform": “playstation_network”

購入できる仮想通貨パッケージ数を制限する

仮想通貨パッケージ購入の制限をすることができます。例えば、以下の制限することができます：

1ユーザーあたりの仮想通貨パッケージ数
一度しか購入できないウェルカム仮想通貨パッケージ

ユーザーが指定した上限に達している場合、仮想通貨パッケージはカタログに表示されません。

ユーザーが利用できる最大パッケージ数および残りのパッケージ数を表示することができます。

アドミンページで仮想通貨パッケージを作成する時に購入制限を設定するには、1人のユーザーがこのパッケージを購入できる回数を制限するのトグルをオンに切り替え、パッケージ購入可能回数を指定します。

仮想通貨パッケージに関する情報を取得するには、仮想アイテム＆通貨メソッドグループからカタログサブセクションのメソッドを使用します。

応答では、仮想通貨パッケージに関する情報のほか、以下の情報を受け取ることができます：

1ユーザーが購入できる最大仮想通貨パッケージ数
ユーザーが購入可能な仮想通貨パッケージ数の残数

制限を設定または更新する方法の詳細については、ユーザーの制限に関する説明を参照してください。

未認証のユーザーに対しては、購入可能な仮想通貨パッケージの最大数が常に表示されます。ユーザーに残りの仮想通貨パッケージ数を表示するには（現在の制限に従う）、仮想アイテム＆通貨メソッドグループのカタログサブセクションのメソッドを使用して仮想通貨パッケージカタログを要求するときにユーザーの認証データを渡します。

ユーザーが利用できる仮想通貨パッケージ数を正しく表示するには、認証を設定する必要があります。

ユーザー属性を持つ応答の例：

Copy

Full screen

Small screen


{
  "items": [
    {
      "sku": "vc_package_1",
      "name": "VC Name first package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "2.0000",
        "amount_without_discount": "2.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "Big Rocket - short description",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "sku": "big_rocket",
          "name": "Big Rocket",
          "type": "virtual_currency",
          "quantity": 100,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    },
    {
      "sku": "vc_package_3",
      "name": "VC Name third package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "4.0000",
        "amount_without_discount": "4.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "description",
          "image_url": "http://image.png",
          "sku": "shotgun_raider",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "quantity": 200,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    }
  ]
}

エクソーラは、制限を超えないようにし、ユーザーが設定された上限を超えて仮想通貨パッケージを購入することを防ぎます。

決済インターフェースを開き、パッケージの代金を支払うと、そのパッケージの未払い注文はすべて無効となります。

例：ユーザーは、パッケージが購入されるまで、いくつかのブラウザータブで購入制限のあるパッケージの決済フォームを開くことができます。これにより、自動的に同じパッケージの注文が複数作成されます。1つのタブでパッケージを購入した後、エクソーラは同じパッケージの未払い注文をすべて無効にします。

ストア内の仮想通貨および仮想通貨パッケージの表示時間を制限する

ストア内の仮想通貨および仮想通貨パッケージの表示期間を次のように設定できます：

ホリデーセール中など、特定の時間帯にカタログの関連性を維持する
仮想通貨と仮想通貨パッケージをカタログに表示せずに事前に作成する
アイテムの横にタイマーを表示して、ユーザーに仮想通貨や仮想通貨パッケージの購入を促す

サイトビルダーを使用してカタログインターフェイスを作成すると、タイマーが自動的に表示されます。独自のインターフェースでカタログを作成するときは、タイマーを実装する必要があります。

ストア内の仮想通貨の表示期間は、APIメソッドを使用してのみ設定できます。

APIを使用してストアに仮想通貨を表示する時間制限を設定するには、仮想通貨を作成するまたは仮想通貨を更新するAPIコールで次のパラメータを渡します：

periods[0].date_fromはアイテムの表示期間の開始日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mm GMT形式のタイムゾーンインジケーターです。
periods[0].date_untilはアイテムの表示期間の終了日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mm GMT形式のタイムゾーンインジケーターです。アイテムの表示期間の終了を示さないようにするには、nullを渡します。

ストアにパッケージを表示する期間を複数設定できます。これを行うには、仮想通貨を作成するまたは仮想通貨を更新するメソッドで、すべての期間の開始日と終了日を含むオブジェクトの配列を渡します。

例：

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

アドミンページでストアに仮想通貨パッケージを表示する時間制限を設定するには、「期間」を選択し、タイムゾーン、期間の開始日と終了日を指定します。パッケージ表示期間の終了を示さないようにするには、「終了日なし」ボックスにチェックを入れます。

APIを使用してストアにパッケージを表示する時間制限を設定するには、仮想通貨パッケージを作成するまたは仮想通貨パッケージを更新するAPIコールで次のパラメータを渡します：

periods[0].date_fromはアイテムの表示期間の開始日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mm GMT形式のタイムゾーンインジケーターです。
periods[0].date_untilはアイテムの表示期間の終了日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mm GMT形式のタイムゾーンインジケーターです。アイテムの表示期間の終了を示さないようにするには、nullを渡します。

ストアにパッケージを表示する期間を複数設定できます。これを行うには、仮想通貨パッケージを作成するまたは仮想通貨パッケージを更新するメソッドで、すべての期間の開始日と終了日を含むオブジェクトの配列を渡します。

例：

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

使用に適した方

ゲームに仮想通貨を追加し、そのための仮想アイテムを販売することにより、ゲームの経済性または収益化を設定したいパートナー向け
次の製品の少なくとも1つを統合しているパートナーの場合：
- 設定された仮想アイテムモジュールを使用したインゲームストア。
- 構成されたゲームキーモジュールでのBuy Button。

入手方法

前提条件

エクソーラアドミンページに新規登録します。
あなたのプロジェクトを開きます。

ゲーム内ストアまたはBuy Buttonのモジュールを構成します。

仮想通貨を設定する

以下のいずれかの方法で仮想通貨を設定することができます：

アドミンページを使用する
APIコールを使用する

アドミンページで仮想通貨を設定する

APIコールで仮想通貨を設定する

仮想アイテム＆通貨APIエンドポイントの管理者サブセクションからのAPIコールを使用します。

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

最終更新日: 2023年10月10日

誤字脱字などのテキストエラーを見つけましたか？テキストを選択し、Ctrl+Enterを押します。

Your browser is not supported. Please try a different browser

人気記事

またはよくある質問を選ぶ:

以下の出典に基づく回答:

ご意見・ご感想をお寄せください（任意）

ご意見・ご感想をお寄せください（任意）

インゲームストア

仮想通貨

どのように動作するか

通貨を販売するためのオプション

任意の量の仮想通貨を販売する

まずは最低でも1つのアイテムを作成します。

通貨配送

ハード通貨

購入できる仮想通貨パッケージ数を制限する

ストア内の仮想通貨および仮想通貨パッケージの表示時間を制限する

使用に適した方

入手方法

前提条件

仮想通貨を設定する

アドミンページで仮想通貨を設定する

APIコールで仮想通貨を設定する