インゲームストア / 仮想通貨
  ドキュメントに戻る

インゲームストア

仮想通貨

どのように動作するか

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

主な機能:

お知らせ
価格の価値がゼロの仮想通貨と仮想通貨のパッケージを作成したい場合は、カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。
注意
割引、プロモーションコードまたはクーポンのあるキャンペーンでは、仮想通貨パッケージを使用する必要があります。任意の金額の仮想通貨は、ボーナスのあるキャンペーンでのみ使用できます。

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

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

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

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

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

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

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

制限:

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

通貨配送

利用可能な配送方法:
  • エクソーラインベントリに直接(デフォルトの方法)。配信前に仮想通貨のパッケージが解凍され、パッケージからの通貨がプレイヤーインベントリに付与されます。
  • 統合を構成するには、PlayFabへ。
お知らせ
インゲームストアロジックがサーバーに実装されている場合は、ウェブフック購入を設定することができます。

ハード通貨

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

制限:

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

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

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

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つのタブでパッケージを購入した後、エクソーラは同じパッケージの未払い注文をすべて無効にします。

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

ストア内の仮想通貨および仮想通貨パッケージの表示期間を次のように設定できます:
  • ホリデーセール中など、特定の時間帯にカタログの関連性を維持する
  • 仮想通貨と仮想通貨パッケージをカタログに表示せずに事前に作成する
  • アイテムの横にタイマーを表示して、ユーザーに仮想通貨や仮想通貨パッケージの購入を促す
お知らせ
サイトビルダーを使用してカタログインターフェイスを作成すると、タイマーが自動的に表示されます。独自のインターフェースでカタログを作成するときは、タイマーを実装する必要があります。

使用に適した方

  • ゲームに仮想通貨を追加し、そのための仮想アイテムを販売することにより、ゲームの経済性または収益化を設定したいパートナー向け
  • 次の製品の少なくとも1つを統合しているパートナーの場合:

入手方法

前提条件

  1. エクソーラアドミンページに新規登録します。
  2. あなたのプロジェクトを開きます。
  1. ゲーム内ストアまたはBuy Buttonのモジュールを構成します。

仮想通貨を設定する

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

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

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

Virtual Items & Currency API エンドポイントのAdminサブセクションからのAPIコールを使用します。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2023年10月10日

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

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!