仮想アイテム

仕組み

仮想アイテムとは、ユーザーが実際通貨または仮想通貨で購入したり、ボーナスとして受け取ったりできるゲーム内アイテムのことです。物理的実体はなく、利用範囲はゲーム内に限定されます。具体例には、スキンやポーション、武器など、プレイ体験や外見に影響を与える要素などが挙げられます。

主な機能：

• 柔軟な価格設定：
  • 個別アイテムの価格を実通貨や仮想通貨で設定
  • 無料アイテムの作成
• ユーザーの国と通貨の自動判定
• 可用性の設定：
  • 特定の地域でのアイテム販売の制限
  • 購入可能なアイテム数の制限
  • ストアでのアイテム表示期間の制限
  • 購入不可アイテムの設定。カタログでは非表示にしつつ、バンドルの一部や他アイテムのボーナスとして提供可能

セットアップ方法

2. 「手動で作成」をクリックし、ドロップダウンリストから仮想アイテムを選択します。

3. 一般設定セクションで、次を指定します：
   • SKU
   • アイテムが属すべき1つまたは複数のグループ（任意）
   • 名称
   • 簡潔な説明
   • 詳細な説明 — 追加するには、対応するトグルをオンにします（任意）

4. メディアセクションで、1つ以上の画像または動画をアップロードします（任意）。デバイスから直接、またはリンク経由で追加できます。エクソーラのサイトエディターで作成したストアでは、すべてのアイテムカードにメインとしてマークされたファイルが表示され、残りのファイルはメディアギャラリー付きのアイテムカードでのみ表示されます。メインとしてマークされたファイルは、カタログ取得のAPIコールのレスポンスでも返されます。

5. 価格設定セクションで、価格を設定するか、無料アイテムを作成します：
   • 価格を設定するには、有料アイテムを選択し、実際通貨での価格および/または仮想通貨での価格のトグルをオンにして、価格を指定します。必要に応じて、地域別価格を設定してください。
   • 無料アイテムを作成するには、無料アイテムを選択します。

6. 購入可能なアイテム数を制限するには：
   1. 制限セクションでトグルをオンにし、数量を指定します。
   2. 制限のリセット頻度を設定します。ドロップダウンリストから期間を選択します：
      1. 毎日
      2. 毎週
      3. 毎月
      4. カスタム間隔。間隔はストアでのアイテムの表示開始日時から計算されます。
      5. 定期的なリセットなし
   3. 選択した期間に対応するパラメータを指定して、リセットスケジュールを設定します。

7. アイテムの表示期間制限を設定する（任意）：

   1. 特定の表示期間を追加セクションでトグルをオンにします。
   2. タイムゾーン、開始日時、終了日時を指定します。

   アイテムの表示期間の終了を指定しない場合は、終了日なしのトグルをオンにします。

8. 以下のいずれかのオプションを使用して属性を設定します（任意）：
   1. JSON形式で属性とその値を追加する
   2. 属性とその値を手動で作成し、アイテムに関連付ける

9. 有料アイテムがランダムな報酬を伴う仕組み（例：ルートボックスやガチャなど）で使用される場合は、有料なランダム報酬としてマークのトグルを有効にします。

10. 「作成」をクリックします。

11. 表示されたウィンドウで、アイテムステータス」を選択し、「続ける」をクリックします。

作成したアイテムはすべてのアイテムセクションに表示されます。

API で設定

仮想アイテムを設定するには、Virtual items and currency グループの Admin サブセクションにあるコールを使用します。

ストアで仮想アイテムを表示

仮想アイテムの表示方法は、カタログの実装方法によって異なります — サイトビルダー経由 または API 経由。

サイトエディターで表示

ウェブサイトに仮想アイテムを表示するには：

1. 仮想アイテムを作成。

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

3. 対象サイトのペインで、Open Site Builder をクリック

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

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

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

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

5. Store ブロックセクションで、Item type フィールドで Virtual items を選択し、Item group フィールドでウェブサイトで販売するアイテムグループを選択

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

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

   1. サイトエディターの右上で Publish をクリックします。
   2. 公開するページにチェックを入れます。
   3. Publish をクリックします。

サイトを公開すると、仮想アイテムのグループを含むセクションが利用可能になります。アイテムが表示されない場合は、Status が Available に設定され、時間ベースの表示制限が有効になっていないことを確認してください。

API で仮想アイテム情報を取得

クライアント側で仮想アイテムのカタログを取得するには、Virtual items and currency メソッドグループの Catalog サブセクションにあるメソッドを使用します。これらのメソッドの利用に認証は不要です。

ユーザーに仮想アイテムを付与

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

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

この方法およびその他の購入データ取得方法の詳細は、注文状況の追跡のセットアップを参照してください。

お役立ちリンク