仮想アイテム

どのように動作するか

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

主な機能:

  • 実際通貨と仮想通貨で価格を設定します。
  • いくつかのレベルのカタログを構成します。
  • ユーザーの通貨と国を自動的に決定します。

価格設定の特徴:

  • 1つのアイテムには、実際通貨と仮想通貨の両方の価格を持つことができます。
  • いくつかの実在通貨または仮想通貨で価格を設定することができます。この場合、デフォルトの通貨を選択していることを確認してください。

価格設定の制限:

  • 実質通貨や仮想通貨で価格を指定しないとアイテムを作成することができません。
  • 値段がゼロのアイテムは作れません。

仮想アイテムには3種類あります:

消耗品の仮想アイテム

消耗品とは、大量に持っていて何度も購入できるインベントリ内のアイテムのことです。ユーザーが消費するとその量は減ります。

主な特徴:

  • インベントリ内のアイテムの在庫を補充します。
  • ユーザーインベントリ内に同じアイテムのインスタンスを多数保存します。
  • クライアント側から消費することができます。

例えば:手榴弾、弾丸など。

非消耗品の仮想アイテム

非消耗品アイテムとは、インベントリ内のアイテムであり、1回のみ発生または購入できます。

主な特徴:

  • ユーザーは、インベントリにこのアイテムを1つだけ含めることができます。
  • クライアント側で消費されてインベントリから削除することはできません。サーバーメソッドでのみ撤回することができます。

例えば:位置情報、ステータス、化粧品、プリインストールされているDLC、モバイルゲームのNO ADSオプションなどへのアクセス。

非更新サブスクリプション

非更新サブスクリプションは、1回限りの購入です。ユーザーは、有効期限が切れたときに再度購入する必要があります。

主な特徴:

  • 有効期限が切れると無効になります。
  • ユーザーは、このサブスクリプションを有効化するために再度このサブスクリプションを購入します。

例えば:Battle PassSeason Pass、ゲーム内の化粧品アイテム、アイテム、追加コンテンツに一時的にアクセスできます。

詳細については、非更新サブスクリプションレシピを参照してください。

使用に適した方

  • ゲームに仮想通貨を追加し、この通貨で仮想アイテムを販売することで、ゲームエコノミーやマネタイズを設定したいパートナー。
  • ゲーム内ストアを統合し、新しいタイプの製品である仮想アイテムを設定したいパートナー向けです。

入手方法

前提条件

  1. エクソラパブリッシャーアカウントに新規登録します。
  2. あなたのプロジェクトを開きます。

  1. プロジェクト設定 > 統合設定に移動し、Commerce APIを統合するトグルがオンになっていることを確認します。

統合フロー

  1. 仮想アイテムと仮想アイテムのグループを構成します。
  2. 地域制限と地域価格を構成します。

仮想アイテムと仮想アイテムのグループを構成する

仮想アイテムを設定するには、仮想アイテムのグループを設定する必要があります。グループを設定することで、マルチレベルのカタログを持つことができます。指定されたグループを持たないアイテムは、Ungroupedグループに追加されます。

仮想アイテムや仮想アイテムのグループを設定するには、以下のことができます:

パブリッシャーアカウント経由の構成

仮想アイテムのグループを設定するには:

  1. パブリッシャーアカウント仮想アイテムモジュールを接続します。

  1. ストア > 仮想アイテムに移動して、グループを作成するをクリックします。

  1. 以下のパラメータを指定します:
    1. グループコード。
    2. グループ名。

  1. ストアでグループを表示するトグルをオンに設定します。
  2. グループを作成するをクリックします。

仮想アイテムを設定するには:

  1. パブリッシャーアカウント仮想アイテムモジュールを接続します。

  1. アイテムを作成します。

  1. すべてのアイテムについて、以下を指定します:
    1. イメージ。
    2. SKU。
    3. アイテムが属するべき1つまたは複数のグループ。
    4. 名前。
    5. 説明。
    6. アイテムプロパティ:消耗品、非消耗品、または非更新サブスクリプション。
    7. 実際通貨または仮想通貨での価格

  1. ストアでアイテムを表示するトグルをオンに設定します。
  2. アイテムを作成するをクリックします。

APIコールによる設定

仮想アイテムを設定するには、Virtual Items & CurrencyグループのAdminサブセクションからのAPIコールを使用します。

APIコールには基本的な認証が使用されます。Authorization:Basic <your_authorization_basic_key>を渡し、そこで、<your_authorization_basic_key>パラメータはマーチャントID:APIキーペア、はBase64規格に基づいてエンコードされています。マーチャントIDはパブリッシャーアカウントでのプロジェクト設定 > ウェブフックにあります。APIキーはパブリッシャーアカウントで会社設定 > APIキーにあります。

Notice
Adminサブセクションのメソッドは、フロントエンド側のストアでカタログを構築するために作成されたものではありません。ランディングページ、ウェブストア、ゲーム内ロジックに使用してください。

クライアント側で仮想アイテムのカタログを取得するには、Virtual Items & CurrencyグループのCatalogサブセクションからのAPIコールを使用します。これらの呼び出しは基本的な認証を必要としません。

グループに分割されていない項目の完全なリストを取得するには、Get virtual items listAPIコールを使用します。定数グループから項目のリストを取得するには、external_idパラメータをGet items list by specified group呼び出しに渡します。

地域制限と地域価格を設定する

仮想アイテムの地域制限を設定するには、アイテムがCreate itemまたは Update item呼び出しで利用可能になる地域の識別子を持つオブジェクトの配列を渡します。

Copy
Full screen
Small screen
"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

仮想アイテムの地域価格を設定するには、地域価格を設定したオブジェクトの配列をCreate itemまたはUpdate itemコールに渡します。

Copy
Full screen
Small screen
"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

Note
プロジェクトで事前にリージョンを設定しておく必要があります。これを行うには、アカウントマネージャーに連絡してください。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか?

答えたくない

ご意見ありがとうございました!
最終更新日: 2020年9月15日

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

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!