商品販売サイトの設定方法

独自のサイトを使用することで、サードパーティプラットフォームの手数料なしでアイテムを販売し、ゲームの収益化を向上させることができます。サイトテンプレートを使用すると、仮想アイテム、仮想通貨パッケージ、バンドル、ゲームキーを販売できます。ストアブロックまたは購入ボタンを使用したアイテムの販売方法については、以下で説明します。

ユーザーフロー：

ユーザーはサイトに行きます。
ユーザーは購入ボタンをクリックします。
認証またはメールアドレス入力のためのモーダルウィンドウが開きます（アイテムタイプによって異なります）。
ユーザーは開いた決済インターフェイスで購入を完了します。

この手順では、基本的なストアの設定方法とサイトへの接続方法について説明します。特定のアイテムタイプの販売に関する詳細については、以下のセクションを参照してください：

商品を販売するサイトを設定するには：

アイテムカタログを作成します。
ストアブロックまたは購入ボタンを追加します。

カタログを作成する

サイトでは、以下のタイプのアイテムを販売できます：

仮想通貨パッケージ
仮想アイテム
ゲームキー
バンドル

カタログを作成するには、パブリッシャーアカウント、APIコール、またはJSONファイルや外部プラットフォームからのインポートを利用できます。

仮想通貨を作成する

仮想通貨とは、ゲーム内アイテムの販売に使用される仮想のお金のことです。仮想通貨は、その目的に応じて、ゲームの経済残高に影響を与えたり、アプリの収益化につながったりします。また、ハードカレンシーとは、購入先のプラットフォームにリンクされて、リアルマネーでのみ購入可能な仮想通貨のことです。

事前定義された金額で仮想通貨を販売できます。パッケージの場合、そのパッケージ内の仮想通貨の金額と等しくない特別価格を定義できます。

仮想通貨の詳細については、仮想通貨セクションを参照してください。

仮想通貨を設定するには：

パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想通貨セクションに移動します。
「新規仮想通貨」をクリックします。
以下を指定します：
- 画像（任意）。
- SKU。
- 名称。
- 実際通貨または仮想通貨の価格。
- デフォルト通貨。
- 属性（任意）。

価格は少なくとも1つの（実際または仮想）通貨で設定する必要があります。仮想通貨の金額は整数でのみ指定できます。実際通貨による地域価格の設定に関する詳細情報は、ドキュメントをご覧ください。

仮想通貨をプレミアム通貨として定義できます。この通貨は購入が行われるプラットフォームに関連付けられており、リアルマネーでのみ販売できます。プラットフォームごとにプレミアム通貨の個別のストレージを設定するには、「プレミアム通貨」トグルを「オン」に切り替えます。

通貨は作成された時点でのみ、プレミアム通貨として定義できます。

仮想通貨パッケージを設定する

仮想通貨パッケージを作成する前に、まずそれに含まれる通貨を作成する必要があります。

仮想通貨パッケージをセットアップするには：

パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想通貨 > パッケージセクションに移動します。
「新規パッケージ」をクリックします。

以下を指定します：
- パッケージの画像（任意）。
- パッケージSKU。
- パッケージの名称。
- パッケージの簡単な説明。
- パッケージの仮想通貨。
- 実際通貨と仮想通貨の価格。
- デフォルト通貨。
- 属性（任意）。

パッケージに追加できる仮想通貨は1種類のみです。仮想通貨パッケージの価格は、最低でも現実通貨か仮想通貨のどちらかで指定する必要があります。仮想通貨の金額は整数値でしか指定できません。実際通貨による地域価格の設定に関する詳細情報は、ドキュメントをご覧ください。

ユーザーが仮想通貨パッケージを購入できる回数を制限するには、「一人のユーザーが仮想通貨パッケージを購入できる回数を制限する」トグルを「オン」に切り替えて、制限を指定します。
ストアにパッケージが表示される期限を設定するには、「ストアにアイテムを表示する」フィールドで、「期間」を選択してタイムゾーン、期間の開始日と終了日を指定します。アイテム表示期間の終了を表示しないようにするには、「終了日なし」ボックスのチェックを入れます。
設定を確認して「パッケージを作成」をクリックします。

仮想アイテム、仮想通貨、または仮想通貨パッケージを作成した後、アイテムにステータスを設定し、利用可能、利用不可、または部分的に利用可能かを決定できます。

仮想アイテムを作成する

仮想アイテムは、実際通貨と仮想通貨で販売できるゲーム内コンテンツです。

仮想アイテムには次の3つのタイプがあります：

消耗品 — 大量に持っていて、何度も購入することができるアイテム。ユーザーが消費すると、その量は減少します。
非消耗品 — 一度だけ発生または購入することができるアイテム。これらのアイテムはユーザーのインベントリに保管され、クライアント側で消費されてもインベントリから削除することはできません。クライアント側で消費してインベントリから取り出すことはできず、サーバー側のメソッドでのみ取り出すことができます。
期間限定アイテム — 期間限定で入手可能で、有効期限が切れても在庫から消えない非消耗品アイテム。ユーザーは、このアイテムを再度購入してアクティブ化する必要があります。

仮想アイテムの詳細については、仮想アイテムセクションを参照してください。

仮想アイテムを設定するには、仮想アイテムグループを設定する必要があります。グループを設定することで、複数レベルのカタログを作成し、ストア内のアイテムの表示を管理することができます。

仮想アイテムのグループを作成するには：

パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想アイテムセクションに移動します。
「+」をクリックして、ドロップダウンリスト「グループを作成」を選択します。

以下のパラメータを指定します：
- グループコード。
- グループ名。
グループをカタログに表示する場合は、ストアにグループを表示するトグルをオンに設定します。

「グループを作成」をクリックします。

グループが指定されていないアイテムは、未グループ化グループに追加されます。

仮想アイテムをセットアップするには：

パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想アイテムセクションに移動します。
「+」をクリックして、ドロップダウンリスト「アイテムを作成」を選択します。

以下を指定します：
- イメージ（任意）。
- SKU。
- アイテムが属する1つまたは複数のグループ。
- 名称。
- 説明（任意）。

アイテム説明は255個のシンボルに制限されます。255個のシンボルを超える説明を追加する必要がある場合は、カスタマーサクセスマネージャーに連絡するか、csm@xsolla.comにメールを送信してください。

アイテムのプロパティ: 消耗品、非消耗品、または期間限定のアイテム。
実際通貨または仮想通貨での価格。

実際通貨や仮想通貨で価格を指定しないとアイテムを作成することができません。価格の値がゼロのアイテムを作成することはできません。実際通貨での価格設定に関する詳細情報は、ドキュメントをご覧ください。

アイテムの購入制限を設定します（任意）。これを行うには、「一人のユーザーがこのアイテムを購入できる回数を制限する」トグルを「オン」に設定してユーザーが購入できるアイテムの数を指定します。
ストアで表示されるアイテムの時間制限を設定するには、「ストアにアイテムを表示する」フィールドで、「期間」を選択してタイムゾーン、期間の開始日と終了日を指定します。アイテム表示期間の終了日を表示しないようにするには、「終了日なし」ボックスのチェックを入れます。
設定を確認して「アイテムを作成」をクリックします。

バンドルを作成する

バンドルとは、複数の商品をセットにして1つのユニットとして販売することです。バンドルには異なる種類のアイテムを追加することができます：

仮想通貨。
仮想通貨のパッケージ。
期間限定アイテムを含む仮想アイテム。
バンドル。

バンドルの詳細については、バンドルセクションを参照してください。

バンドルをセットアップするには：

パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > バンドルセクションに移動します。
「+」をクリックして、ドロップダウンリスト「バンドルを作成」を選択します。

以下を指定します：
- 画像（任意）。
- SKU。
- 名前。
- 説明（任意）
- コンテンツ。
バンドル価格を設定します。価格を設定するか、無料バンドルを作成します：
1. 無料バンドルを作成するには、「有料または無料」フィールドで、「無料バンドル」を選択します。
2. 価格を設定するには、「有料または無料」フィールドで、「有料バンドル」を選択して実際通貨または仮想通貨で価格を指定します。必要に応じて、地域価格を設定します。

同じバンドルや物理的な商品をバンドルに追加することはできません。空のバンドルを作成することはできません。

バンドルは、実際通貨や仮想通貨で価格を指定せずに作成することができます。そのようなバンドルがストアに表示された場合、ユーザーは無料で利用できるようになります。地域価格を含む実際通貨による価格設定のに関する詳細情報は、ドキュメントをご覧ください。

バンドルの購入制限を設定します（任意）。これを行うには、「一人のユーザーがバンドルを購入できる回数を制限する」トグルを「オン」にしてユーザーが購入できるバンドルの数を指定します。
「次へ」をクリックします。
ストアでバンドルの表示を設定します：
- ステータスを「利用可能」に変更します。
- ストアでバンドルを表示する時間制限を設定します（任意）。これを行うには「期間」タイムゾーン、期間の開始と終了を指定します。アイテム表示期間の終了を表示したくない場合は、「終了日なし」にチェックを入れてください。
「次へ」をクリックします。
設定を確認して「保存」をクリックします。

Shop Builder APIコールを使用して、カタログの作成と更新を自動化できます。自動化により、時間をかけずにカタログを最新の状態に保つことができます。カタログ自動化では、アイテムやプロモーションの作成と更新、外部システムからのデータのインポートを行うことができます。

基本認証は、アイテムやプロモーションを作成または更新するためのAPIコールに使用されます。Authorization:Basic <your_authorization_basic_key>を渡し、そこで、<your_authorization_basic_key>はマーチャントID：APIキーペア、はBase64規格に基づいてエンコードされています。パブリッシャーアカウントに移動して、以下のパラメータを見つかります：

マーチャントIDは以下の場所で表示されます：
- 会社設定 > 会社セクション。
- パブリッシャーアカウントページのブラウザーアドレスバーのURL。URLは以下の形式があります：https://publisher.xsolla.com/<merchant_id>/。

APIキーは、作成時に一度だけパブリッシャーアカウントに表示され、お客様側で保存する必要があります。次のセクションで新しいキーを作成できます：
- 会社設定 > APIキー
- プロジェクト設定 > APIキー

API経由でアイテムを作成するには：

お使いのシステムからアイテムデータをエクスポートします。
エクスポートされたデータを、対応するアイテムタイプのAPIコールが要求するデータ形式に変換します。
エクスポートの各アイテムについて、対応するAPIメソッドを呼び出すスクリプトを作成します：

JSONファイル経由でアイテムをインポートするAPIコールを使用して、アイテムをインポートすることも可能です。

アイテムグループを使用したい場合は、事前にパブリッシャーアカウントで作成してください。

APIコールによるカタログ管理の詳細については、説明を参照してください。

パブリッシャーアカウントでプロジェクトを開き、アイテムカタログセクションで、設定したいアイテムタイプに移動します：
カタログ管理のドロップダウンリストから、アイテム（JSON）をインポート。

アクションを選択します：
- 新規アイテムの追加 — 新しいSKUを持つアイテムのみが追加されます。
- 新規アイテムの追加、既存アイテムの更新 — 新しいSKUのアイテムが追加され、既存のアイテムのデータが更新されます。
- 新規アイテムの追加、既存アイテムの更新、欠落アイテムの無効化 — ファイルからSKUを持つアイテムが追加/更新されます。カタログにアイテムがあるが、ファイルにそのようなSKUがない場合、パブリッシャーアカウントのアイテムのステータスは一部利用可能（アイテムは個別に購入できませんが、バンドルまたはボーナスの一部として購入できます）に変更されます。

インポート用のファイルを記入します：
- ダウンロードウィンドウでファイルテンプレートをダウンロードし、以下の例に従って入力します。
- アイテムをエクスポートし、エクスポートされたファイルをテンプレートとして使用します。
- 独自のJSONファイルを作成し、以下の例に従って記入します。

完全なJSONファイルの例：

Copy

Full screen

Small screen

  1{
  2    "virtual_currency": [
  3        {
  4            "sku": "Gem_test_import",
  5            "name": {
  6                "en": "Gem_test_import"
  7            },
  8            "type": "virtual_currency",
  9            "description": {
 10                "en": "my test imported currency"
 11            },
 12            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
 13            "description": {
 14                "en": "my test imported currency",
 15                "de": "meine importierte Testwährung"
 16            },
 17            "attributes": [],
 18            "is_free": false,
 19            "order": 1,
 20            "groups": [],
 21            "regional_prices": [],
 22            "prices": [
 23                {
 24                    "amount": 2,
 25                    "currency": "USD",
 26                    "is_default": true,
 27                    "is_enabled": true
 28                }
 29            ],
 30            "media_list": [],
 31            "vc_prices": [],
 32            "is_enabled": true,
 33            "is_show_in_store": true,
 34            "regions": [],
 35            "limits": {
 36                "per_user": null,
 37                "per_item": null,
 38                "recurrent_schedule": null
 39            },
 40            "periods": [],
 41            "inventory_options": {
 42                "consumable": true,
 43                "expiration_period": null
 44            },
 45            "is_hard": false
 46        }
 47    ],
 48    "virtual_items": [
 49        {
 50            "sku": "event_access_test_import",
 51            "name": {
 52                "en": "Special Event Access_test_import"
 53            },
 54            "type": "virtual_good",
 55            "description": {
 56                "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
 57            },
 58            "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
 59            "long_description": null,
 60            "attributes": [],
 61            "is_free": false,
 62            "order": 1,
 63            "groups": [
 64                "my_test_group"
 65            ],
 66            "regional_prices": [],
 67            "prices": [
 68                {
 69                    "amount": 35,
 70                    "currency": "USD",
 71                    "is_default": true,
 72                    "is_enabled": true
 73                }
 74            ],
 75            "media_list": [],
 76            "vc_prices": [],
 77            "is_enabled": true,
 78            "is_show_in_store": true,
 79            "regions": [],
 80            "limits": {
 81                "per_user": null,
 82                "per_item": null,
 83                "recurrent_schedule": null
 84            },
 85            "periods": [],
 86            "inventory_options": {
 87                "consumable": true,
 88                "expiration_period": null
 89            }
 90        }
 91    ],
 92    "virtual_currency_packages": [
 93        {
 94            "item_id": 441982,
 95            "sku": "small_gold_pack_test_import",
 96            "type": "bundle",
 97            "name": {
 98                "en": "Small gold pack"
 99            },
100            "bundle_type": "virtual_currency_package",
101            "description": {
102                "en": "Gold x100"
103            },
104            "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
105            "vc_prices": [],
106            "regional_prices": [],
107            "prices": [
108                {
109                    "amount": 5,
110                    "currency": "USD",
111                    "is_default": true,
112                    "is_enabled": true
113                }
114            ],
115            "is_enabled": true,
116            "is_show_in_store": true,
117            "regions": [],
118            "limits": {
119                "per_user": null,
120                "per_item": null,
121                "recurrent_schedule": null
122            },
123            "periods": [],
124            "attributes": [],
125            "long_description": null,
126            "media_list": [],
127            "order": 100000000,
128            "is_free": false,
129            "groups": [],
130            "content": [
131                {
132                    "sku": "Gem_test_import",
133                    "quantity": 100
134                }
135            ]
136        }
137    ],
138    "bundles": [
139        {
140            "item_id": 684024,
141            "sku": "start_pack_test_import_test_import",
142            "type": "bundle",
143            "name": {
144                "en": "Legendary Start Pack"
145            },
146            "bundle_type": "standard",
147            "description": {
148                "en": "Crystal x 1\nGem x 1"
149            },
150            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
151            "regional_prices": [],
152            "prices": [
153                {
154                    "amount": 20,
155                    "currency": "USD",
156                    "is_default": true,
157                    "is_enabled": true
158                }
159            ],
160            "virtual_prices": [],
161            "is_enabled": true,
162            "is_show_in_store": true,
163            "regions": [],
164            "limits": {
165                "per_user": null,
166                "per_item": null,
167                "recurrent_schedule": null
168            },
169            "periods": [],
170            "attributes": [],
171            "long_description": null,
172            "media_list": [],
173            "order": 5,
174            "is_free": false,
175            "groups": [
176                "my_test_group"
177            ],
178            "content": [
179                {
180                    "sku": "Gem_test_import",
181                    "quantity": 1
182                },
183                {
184                    "sku": "event_access_test_import",
185                    "quantity": 1
186                }
187            ]
188        }
189    ]
190}

インポートウィンドウの対応するフィールドに完全なファイルをアップロードします。
インポート中にエラーが発生した場合は、そのエラーのリストと修正推奨事項がインポートウィンドウに表示されます。ファイルに必要な変更を加え、再度アップロードしてください。

アップロードに成功すると、指定したSKUのアイテムが作成、更新、または無効になります。

JSONファイル経由でアイテムをインポートするAPIコールを使用して、アイテムをインポートすることも可能です。

JSONファイル経由でのアイテムインポートの詳細については、説明を参照してください。

Google PlayやApp Storeなど、外部プラットフォームからカタログをインポートすることもできます。

ストアブロックまたは購入ボタンを作成する

ストアブロックは、ウェブサイト上でアイテムカタログを販売するために使用します。このブロックには、販売用に選択したグループ内のすべてのアイテムが表示されます。購入ボタンは、個別のアイテムを販売するためのツールです。ビルダーの複数のブロックでこのボタンを使用できますが、バンドルとゲームキーのみを販売可能です。