仮想通貨
仕組み
仮想通貨とは、仮想商品の購入に用いられる仮想的な貨幣です。使用方法に応じて、仮想通貨はゲーム経済のバランスに影響を与えたり、アプリケーションの収益化に関連したりします。
主な機能:
- 任意の金額の仮想通貨、または固定数量の仮想通貨パッケージを販売
- 実際通貨または仮想通貨で、仮想通貨および仮想通貨パッケージを販売
- 購入可能な仮想通貨パッケージ数を制限
- ストアでの仮想通貨および仮想通貨パッケージの表示期間を制限
- 無料の仮想通貨パッケージ
仮想通貨の販売には、以下のオプションが利用可能です:
- 任意の金額:ユーザーが指定した金額の仮想通貨を販売できます。このオプションを使うには、購入時に希望金額を入力できるよう、クライアント側に入力用フィールドを実装します。
- パッケージ:あらかじめ定義した数量で仮想通貨を販売できます。パッケージの価格は個別に設定でき、同じ数量の通貨に対する標準価格とは異なる場合があります。
例: 100枚のゴールドコインを含むパッケージの価格は $90、コイン1枚の価格は $1。
制限:
- 1つのパッケージに追加できる仮想通貨は1種類のみです。
- 別の仮想通貨建ての価格はAPIコールでのみ設定できます。
- 仮想通貨パッケージは、実際通貨または仮想通貨の価格を指定せずに無料にできます。この設定はパブリッシャーアカウントまたはAPIコールで行えます。パッケージに含まれない無料の仮想通貨は、APIコールでのみ作成できます。
- 仮想通貨パッケージは、実際通貨または仮想通貨の価格を指定せずに無料にできます。この設定はモバイルゲーム用のアカウントまたはAPIコールで行えます。パッケージに含まれない無料の仮想通貨は、APIコールでのみ作成できます。
- パッケージに含まれる仮想通貨の数量は、整数でしか指定できません。
セットアップ方法
パブリッシャーアカウントで設定
アカウントで設定
API で設定
仮想通貨を設定するには、仮想アイテムと仮想通貨グループのAdminサブセクションにある API コールを使用します。
| タスク | APIコール |
|---|---|
| 仮想通貨を作成 | Create virtual currency. |
| 仮想通貨を取得 | Get virtual currency. |
| 仮想通貨の一覧を取得 | Get list of virtual currencies. |
| 仮想通貨を更新 | Update virtual currency. |
| 仮想通貨を削除 | Delete virtual currency. |
| 購入可能な仮想通貨の数量を制限 | Create virtual currency または Update virtual currency API コールで、次のパラメーターを渡します:
|
| 仮想通貨パッケージを作成 | Create virtual currency package. |
| 仮想通貨パッケージを取得 | Get virtual currency package. |
| 仮想通貨パッケージの一覧を取得 | Get list of virtual currency packages. |
| 仮想通貨パッケージを更新 | Update virtual currency package. |
| 仮想通貨パッケージを削除 | Delete virtual currency package. |
| 購入可能な仮想通貨パッケージ数を制限 | Create virtual currency package または Update virtual currency package API コールで、次のパラメーターを渡します:
|
制限の詳細については、以下のガイドを参照してください:
カタログで仮想通貨を表示
カタログの実装方法により、仮想通貨または仮想通貨パッケージの表示方法が異なります。サイトエディター経由またはAPI 経由。
サイトエディターで表示
仮想通貨パッケージを表示するには:
パブリッシャーアカウントのプロジェクトで、Storefronts > Websites セクションに移動します。
対象サイトのペインをクリック.
アカウントのプロジェクトで、Storefronts > Websites セクションに移動します。
対象サイトのペインをクリック.
アカウントのプロジェクトで、Storefronts > Websites セクションに移動します。
対象サイトのペインをクリック.
アカウントのプロジェクトで、Storefronts > Websites セクションに移動します。
対象サイトのペインをクリック.
モバイルゲーム用のアカウントのプロジェクトで、Web Shop セクションに移動。
対象サイトのペインをクリック.
サイトに複数のページがある場合は、必要なページを選択:
- エディター上部の現在のページタイトルをクリック。
- ドロップダウンリストから必要なページを選択。
Store ブロックセクションの Item type フィールドで、ウェブサイトで販売したい仮想通貨パッケージを選択します。
必要な変更を行い、ウェブサイトの公開準備が整ったら:
- サイトエディターの右上で Publish をクリックします。
- 公開するページにチェックを入れます。
- Publish をクリックします。
ウェブサイトを公開できない場合は、次の条件をすべて満たしていることを確認してください:
- ウェブサイトに空のセクションがない(赤いインジケーターで表示されます)
- エクソーラとのライセンス契約に署名済み
- メインページが公開済み、または公開対象に選択されている。メインページより先に子ページを公開することはできません。
サイトを公開すると、仮想通貨パッケージのセクションが利用可能になります。パッケージが表示されない場合は、ステータスが Available に設定され、時間ベースの表示制限が有効になっていないことを確認してください。
API で仮想通貨情報を取得
クライアント側で仮想通貨および仮想通貨パッケージのカタログを取得するには、仮想アイテムと仮想通貨グループのCatalogサブセクションにある API コールを使用します。
| タスク | APIコール |
|---|---|
| SKU で仮想通貨を取得 | Get virtual currency by SKU API コールに virtual_currency_sku パラメーターを渡します。 |
| 仮想通貨の一覧を取得 | Get virtual currency list。 |
| SKU で仮想通貨パッケージを取得 | Get virtual currency package by SKU API コールに virtual_currency_package_sku パラメーターを渡します。 |
| 仮想通貨パッケージの一覧を取得 | Get virtual currency package list。 |
ユーザーに仮想通貨を付与
アイテムタイプや統合設定に応じて、以下のいずれかの方法で仮想通貨がユーザーに付与されます:
PlayFab を統合している場合、仮想通貨とアイテムはユーザーの PlayFab インベントリに自動で付与されます。
カスタム配信システムを使用している場合、すべての仮想アイテムと仮想通貨は貴社側で付与します。注文データをバックエンドで受信するため、ウェブフックハンドラーの設定をお勧めします。必要なデータは Successful payment for order ウェブフックに含まれています。
詳細については、注文状況の追跡の設定を参照してください。
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。




