仮想通貨
どのように動作するか
仮想通貨は、仮想商品の売買に使用される仮想のお金です。その目的に応じて、仮想通貨はゲーム経済のバランスに影響を与えたり、アプリのマネタイズに繋がったりします。
主な機能：
- 任意の金額の仮想通貨または固定金額の別の通貨パッケージを販売します。
- ハード通貨を販売します。
- 実際通貨または仮想通貨で仮想通貨と仮想通貨のパッケージを販売します。
- 購入できる仮想通貨パッケージ数を制限します。
- ストア内の仮想通貨および仮想通貨パッケージの表示時間を制限します。
- 無料アイテム。
通貨を販売するためのオプション
仮想通貨の売却方法には、以下のような選択肢があります：任意の量の仮想通貨を販売する
仮想通貨をユーザーが必要とする金額で販売します。アプリのクライアント側に、購入に必要な通貨の金額を入力するリクエストを実装します。まずは最低でも1つのアイテムを作成します。
事前定義された金額で仮想通貨を販売します。この機能では、ゲーム内通貨をパッケージで販売することができ、その通貨をカスタム金額で購入した場合よりも価格を下げることができます。
例：パッケージの場合、そのパッケージ内の仮想通貨の金額と等しくない特別価格を定義できます。例えば：1仮想コイン = 1米ドル。500仮想コイン = 450米ドル。
制限：
- 1つのパッケージには1種類の仮想通貨しか追加できません。
- 仮想通貨パッケージは、実際通貨や仮想通貨での価格を指定せずに作成することができます。そのようなアイテムがストアに表示された場合、ユーザーは無料で入手できます。
- 仮想通貨の金額は整数値でのみ指定できます。
通貨配送
利用可能な配送方法：- エクソーラインベントリに直接（デフォルトの方法）。配信前に仮想通貨のパッケージが解凍され、パッケージからの通貨がプレイヤーインベントリに付与されます。
- 統合を構成するには、PlayFabへ。
ハード通貨
ハード通貨とは、購入のプラットフォームに連動した通貨で、リアルマネーでしか購入できない通貨のことです。
制限：
- 最初の設定時のみ通貨のステータスをハードにすることができます。
- 実際通貨だけのハード仮想通貨を使って、仮想通貨のパッケージを販売することができます。
ハード通貨を別のプラットフォームで別々に保管するには：
- ハード仮想通貨トグルをオンに設定します。
- インベントリ管理のためのAPIエンドポイントを呼び出す際には、
platformフィールドに購入プラットフォームを指定した文字列を渡します。
例
- html
1"platform": “playstation_network”
購入できる仮想通貨パッケージ数を制限する
仮想通貨パッケージ購入の制限をすることができます。例えば、以下の制限することができます：
- 1ユーザーあたりの仮想通貨パッケージ数
- 一度しか購入できないウェルカム仮想通貨パッケージ
ユーザーが指定した上限に達している場合、仮想通貨パッケージはカタログに表示されません。
ユーザーが利用できる最大パッケージ数および残りのパッケージ数を表示することができます。
アドミンページで仮想通貨パッケージを作成する時に購入制限を設定するには、1人のユーザーがこのパッケージを購入できる回数を制限するのトグルをオンに切り替え、パッケージ購入可能回数を指定します。
仮想通貨パッケージに関する情報を取得するには、仮想アイテム＆通貨メソッドグループからカタログサブセクションのメソッドを使用します。
応答では、仮想通貨パッケージに関する情報のほか、以下の情報を受け取ることができます：
- 1ユーザーが購入できる最大仮想通貨パッケージ数
- ユーザーが購入可能な仮想通貨パッケージ数の残数
制限を設定または更新する方法の詳細については、ユーザーの制限に関する説明を参照してください。
- json
1{
2 "items": [
3 {
4 "sku": "vc_package_1",
5 "name": "VC Name first package",
6 "groups": [],
7 "attributes": [],
8 "type": "bundle",
9 "description": "VC Short Package Description",
10 "image_url": "http://vc_package_image.png",
11 "is_free": false,
12 "price": {
13 "amount": "2.0000",
14 "amount_without_discount": "2.0000",
15 "currency": "USD"
16 },
17 "bundle_type": "virtual_currency_package",
18 "content": [
19 {
20 "description": "Big Rocket - short description",
21 "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
22 "sku": "big_rocket",
23 "name": "Big Rocket",
24 "type": "virtual_currency",
25 "quantity": 100,
26 "inventory_options": {
27 "consumable": {
28 "usages_count": 1
29 },
30 "expiration_period": null
31 }
32 }
33 ],
34 "virtual_prices": [],
35 "limits": {
36 "per_user": {
37 "total": 5,
38 "available": 5
39 },
40 "per_item": null
41 },
42 "can_be_bought": true
43 },
44 {
45 "sku": "vc_package_3",
46 "name": "VC Name third package",
47 "groups": [],
48 "attributes": [],
49 "type": "bundle",
50 "description": "VC Short Package Description",
51 "image_url": "http://vc_package_image.png",
52 "is_free": false,
53 "price": {
54 "amount": "4.0000",
55 "amount_without_discount": "4.0000",
56 "currency": "USD"
57 },
58 "bundle_type": "virtual_currency_package",
59 "content": [
60 {
61 "description": "description",
62 "image_url": "http://image.png",
63 "sku": "shotgun_raider",
64 "name": "SHOTGUN FOR TRUE RAIDERS",
65 "type": "virtual_currency",
66 "quantity": 200,
67 "inventory_options": {
68 "consumable": {
69 "usages_count": 1
70 },
71 "expiration_period": null
72 }
73 }
74 ],
75 "virtual_prices": [],
76 "limits": {
77 "per_user": {
78 "total": 5,
79 "available": 5
80 },
81 "per_item": null
82 },
83 "can_be_bought": true
84 }
85 ]
86}
エクソーラは、制限を超えないようにし、ユーザーが設定された上限を超えて仮想通貨パッケージを購入することを防ぎます。
決済インターフェースを開き、パッケージの代金を支払うと、そのパッケージの未払い注文はすべて無効となります。
例：ユーザーは、パッケージが購入されるまで、いくつかのブラウザータブで購入制限のあるパッケージの決済フォームを開くことができます。これにより、自動的に同じパッケージの注文が複数作成されます。1つのタブでパッケージを購入した後、エクソーラは同じパッケージの未払い注文をすべて無効にします。
ストア内の仮想通貨および仮想通貨パッケージの表示時間を制限する
ストア内の仮想通貨および仮想通貨パッケージの表示期間を次のように設定できます：- ホリデーセール中など、特定の時間帯にカタログの関連性を維持する
- 仮想通貨と仮想通貨パッケージをカタログに表示せずに事前に作成する
- アイテムの横にタイマーを表示して、ユーザーに仮想通貨や仮想通貨パッケージの購入を促す
使用に適した方
ゲームに仮想通貨を追加し、そのための仮想アイテムを販売することにより、ゲームの経済性または収益化を設定したいパートナー向け。
入手方法
仮想通貨を設定する
以下のいずれかの方法で仮想通貨を設定することができます：アドミンページで仮想通貨を設定する
APIコールで仮想通貨を設定する
仮想アイテム＆通貨APIエンドポイントの管理者サブセクションからのAPIコールを使用します。誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
