仮想通貨

仕組み

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

主な機能：

• 任意金額の仮想通貨、または固定量の仮想通貨パッケージの販売。
• 実際通貨または仮想通貨による、仮想通貨およびパッケージの販売。
• 購入可能な仮想通貨パッケージの数量制限。
• ストアにおける仮想通貨およびパッケージの表示期間の制限。
• 無料の仮想通貨パッケージ。

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

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

1. 例：ゴールドコイン1枚の単価が1ドルの場合、100枚入りのパッケージ価格を90ドルに設定できます。

制限：

• 1つのパッケージに追加できる仮想通貨は1種類のみです。
• 別の仮想通貨による価格設定は、APIコール経由でのみ設定できます。
• 仮想通貨パッケージは、実際通貨や仮想通貨の価格を指定せずに、無料に設定することができます。この設定はパブリッシャーアカウント経由で、またはAPIコール経由で行うことができます。ただし、パッケージに含まれない無料仮想通貨を作成する場合は、APIコールからのみ設定可能です。
• パッケージに含まれる仮想通貨の数量は、整数でしか指定できません。

セットアップ方法

パブリッシャーアカウント経由のセットアップ

• 仮想通貨
• 仮想通貨パッケージ

パブリッシャーアカウント経由で仮想通貨を設定するには：

1. パブリッシャーアカウントのプロジェクトで、アイテムカタログ > すべてのアイテムセクションに移動します。
2. 「追加」をクリックしてドロップダウンリストから「仮想通貨」を選択します。

3. 以下のパラメータを設定してください：
   1. 画像（任意）。
   2. SKU。
   3. 仮想通貨名。
4. ストア内での仮想通貨の表示方法を設定するには、適切なステータスを選択してください。

5. 価格を設定するには、「価格を設定」をクリックし、実際通貨での価格を指定してください。必要に応じて、地域別価格を設定してください。
6. 以下のいずれかの方法で、バンドル属性を設定します（任意）：

1. 1. AJSON形式で属性とその値を追加します。

1. 2. 属性と値を手動で作成し、それらを特定のアイテムにリンクさせます。

7. 設定を確認し、「通貨を作成する」をクリックします。

注意

仮想通貨パッケージを設定する前に、仮想通貨を作成しておく必要があります。

パブリッシャーアカウント経由で仮想通貨パッケージを設定するには：

1. パブリッシャーアカウントのプロジェクトで、アイテムカタログ > すべてのアイテムセクションに移動します。
2. 「追加」をクリックしてドロップダウンリストから仮想通貨パッケージを選択します。

3. 以下のパラメータを指定します：
   1. イメージ（任意）。
   2. SKU。
   3. アイテムが属する1つまたは複数のグループ。
   4. 名称。
   5. 説明（任意）。
4. ストア内での仮想通貨の表示方法を設定するには、適切なステータスを選択してください。

5. パッケージに含まれる仮想通貨を指定し、数量を入力してください。
6. 有料または無料フィールドで、価格を設定するか、無料アイテムを作成します：

1. • 無料パッケージを作成するには、「無料パッケージ」を選択します。

1. • 価格を設定するには、「有料パッケージ」を選択し、実際通貨または仮想通貨で価格を指定します。必要に応じて、地域別価格を設定してください。

7. パッケージの購入回数を制限するには、1ユーザーあたりのパッケージ購入回数を制限するトグルをオンにし、希望する数量を入力してください。
8. 制限がリセットされる頻度を設定するには：

1. 1. ドロップダウンリストから期間を選択します：
      • 毎日。
      • 毎週。
      • 毎月。
      • カスタム間隔 – パッケージの表示開始日を起点として計算されます。
      • 定期的なリフレッシュなし。

1. 2. 選択した期間に基づいて、リセットスケジュールを設定します。

9. パッケージの表示時間制限を設定します（任意）：

1. 1. ストアにアイテムの表示フィールドで、期間限定を選択します。

1. 2. タイムゾーンと、期間の開始日時および終了日時を指定してください。

1. 1. アイテムの表示終了日を設定したくない場合は、終了日なしボックスにチェックを入れます。

10. 以下のいずれかの方法で、バンドル属性を設定します（任意）：

1. 1. AJSON形式で属性とその値を追加します。

1. 2. 属性と値を手動で作成し、それらを特定のアイテムにリンクさせます。

11. 設定を確認し、「パッケージを作成する」をクリックします。

API経由のセットアップ

仮想通貨を設定するには、仮想アイテムと仮想通貨グループの「管理者」サブセクションからのコールを使用します。

ストアでの仮想通貨の表示

仮想通貨または仮想通貨パッケージの表示方法は、カタログをサイトビルダー経由で実装しているか、あるいはAPIコールを経由で実装しているかによって異なります。

サイトビルダー経由での表示

1. 仮想通貨パッケージを作成する。
2. パブリッシャーアカウントのプロジェクトで、ストアフロント > ウェブサイトセクションに移動します。
3. ご希望のサイトのウィンドウで、「サイトビルダーを開く」をクリックします。

4. ストアブロックセクションのアイテムタイプフィールドで、ウェブサイトで販売したい仮想通貨パッケージを選択してください。

5. アイテムカードのレイアウトを設定します。
6. 必要な変更をすべて行い、ウェブサイトを公開する準備が整ったら：
   1. サイトビルダーの右上隅で「公開」をクリックします。
   2. 公開したいページ名の横にあるチェックボックスをオンにします。
   3. 「公開」をクリックします。

サイトが公開されると、仮想通貨パッケージのセクションが利用可能になります。パッケージが表示されない場合は、ステータスが「利用可能」に設定されているか、期間ベースの表示制限が有効になっていないかを確認してください。

API経由で仮想通貨情報の取得

クライアント側で仮想通貨および仮想通貨パッケージのカタログを取得するには、仮想アイテムと仮想通貨グループのカタログサブセクションにあるAPIコールを使用してください。

ユーザーへの仮想通貨付与

アイテムタイプや統合設定に応じて、以下のいずれかの方法で仮想通貨がユーザーに付与されます：

• PlayFabを統合している場合、仮想通貨とアイテムはユーザーのPlayFabインベントリに自動的に付与されます。
• カスタム配信システムを使用している場合は、すべての仮想アイテムと通貨は貴社側で付与されます。注文データをご自身のバックエンドで受信するために、ウェブフックハンドラーを設定することをお勧めします。必要なデータは、注文支払い成功ウェブフックに含まれています。