仮想通貨

仕組み

仮想通貨とは、仮想商品の購入に用いられる仮想的な貨幣です。使用方法に応じて、仮想通貨はゲーム経済のバランスに影響を与えたり、アプリケーションの収益化に関連したりします。

主な機能:

  • 任意の金額の仮想通貨、または固定数量の仮想通貨パッケージを販売
  • 実際通貨または仮想通貨で、仮想通貨および仮想通貨パッケージを販売
  • 購入可能な仮想通貨パッケージ数を制限
  • ストアでの仮想通貨および仮想通貨パッケージの表示期間を制限
  • 無料の仮想通貨パッケージ
お知らせ
割引キャンペーンやプロモーションコードまたはクーポンを使うキャンペーンでは、仮想通貨パッケージを使用する必要があります。仮想通貨の任意金額は、ボーナスキャンペーンでのみ使用できます。

仮想通貨の販売には、以下のオプションが利用可能です:

  • 任意の金額:ユーザーが指定した金額の仮想通貨を販売できます。このオプションを使うには、購入時に希望金額を入力できるよう、クライアント側に入力用フィールドを実装します。
  • パッケージ:あらかじめ定義した数量で仮想通貨を販売できます。パッケージの価格は個別に設定でき、同じ数量の通貨に対する標準価格とは異なる場合があります。

例: 100枚のゴールドコインを含むパッケージの価格は $90、コイン1枚の価格は $1。

制限:

  • 1つのパッケージに追加できる仮想通貨は1種類のみです。
  • 別の仮想通貨建ての価格はAPIコールでのみ設定できます。
  • 仮想通貨パッケージは、実際通貨または仮想通貨の価格を指定せずに無料にできます。この設定はパブリッシャーアカウントまたはAPIコールで行えます。パッケージに含まれない無料の仮想通貨は、APIコールでのみ作成できます。
  • 仮想通貨パッケージは、実際通貨または仮想通貨の価格を指定せずに無料にできます。この設定はアカウントまたはAPIコールで行えます。パッケージに含まれない無料の仮想通貨は、APIコールでのみ作成できます。
  • 仮想通貨パッケージは、実際通貨または仮想通貨の価格を指定せずに無料にできます。この設定はモバイルゲーム用のアカウントまたはAPIコールで行えます。パッケージに含まれない無料の仮想通貨は、APIコールでのみ作成できます。
  • パッケージに含まれる仮想通貨の数量は、整数でしか指定できません。

セットアップ方法

パブリッシャーアカウントで設定

アカウントで設定

注意
仮想通貨や仮想通貨パッケージを設定する前に、アイテムを整理しストアでの表示を管理しやすくするために、グループを作成することをお勧めします。

API で設定

仮想通貨を設定するには、仮想アイテムと仮想通貨グループのAdminサブセクションにある 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 コールで、次のパラメーターを渡します:
  • limits — 購入可能な仮想通貨の最大数量を指定します。
  • limits.recurrent_schedule — 制限をリセットする頻度を定義します。
仮想通貨パッケージを作成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 コールで、次のパラメーターを渡します:
  • limits — 購入可能な仮想通貨パッケージの最大数量を指定します。
  • limits.recurrent_schedule — 制限をリセットする頻度を定義します。
お知らせ
ストアでの仮想通貨の表示期間は、APIコールのみで設定できます。

カタログで仮想通貨を表示

カタログの実装方法により、仮想通貨または仮想通貨パッケージの表示方法が異なります。サイトエディター経由またはAPI 経由。

サイトエディターで表示

注意
ストアのカタログに表示できるのは、仮想通貨パッケージのみです。

仮想通貨パッケージを表示するには:

  1. 仮想通貨パッケージを作成.

  2. パブリッシャーアカウントのプロジェクトで、Storefronts > Websites セクションに移動します。

  3. 対象サイトのペインをクリック.

  1. 仮想通貨パッケージを作成.

  2. アカウントのプロジェクトで、Storefronts > Websites セクションに移動します。

  3. 対象サイトのペインをクリック.

  1. 仮想通貨パッケージを作成.

  2. アカウントのプロジェクトで、Storefronts > Websites セクションに移動します。

  3. 対象サイトのペインをクリック.

  1. 仮想通貨パッケージを作成.

  2. アカウントのプロジェクトで、Storefronts > Websites セクションに移動します。

  3. 対象サイトのペインをクリック.

  1. 仮想通貨パッケージを作成.

  2. モバイルゲーム用のアカウントのプロジェクトで、Web Shop セクションに移動。

  3. 対象サイトのペインをクリック.

  1. サイトに複数のページがある場合は、必要なページを選択:

    1. エディター上部の現在のページタイトルをクリック。
    2. ドロップダウンリストから必要なページを選択。

  2. Store ブロックセクションの Item type フィールドで、ウェブサイトで販売したい仮想通貨パッケージを選択します。

  1. アイテムカードのレイアウトを設定。

  2. 必要な変更を行い、ウェブサイトの公開準備が整ったら:

    1. サイトエディターの右上で Publish をクリックします。
    2. 公開するページにチェックを入れます。
    3. 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 ウェブフックに含まれています。

詳細については、注文状況の追跡の設定を参照してください。

この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2026年5月15日

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

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!
フィードバックを送信できませんでした
後でもう一度お試しいただくか、[email protected]までお問い合わせください。