仮想アイテム

どのように動作するか

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

主な機能:

  • 実際通貨と仮想通貨で価格を設定します。
  • いくつかのレベルのカタログを構成します。
  • ユーザーの通貨と国を自動的に決定します。
  • 購入できるアイテム数を制限します
  • 無料アイテム。

価格設定の特徴:

  • 1つのアイテムには、実際通貨と仮想通貨の両方の価格を持つことができます。
  • いくつかの実在通貨または仮想通貨で価格を設定することができます。この場合、デフォルトの通貨を選択していることを確認してください。
  • 実際通貨や仮想通貨で価格を指定せずにアイテムを作成することができます。そのようなアイテムがストアに表示された場合、ユーザーは無料で利用できるようになります。

価格構成の制限:

  • 価格の値がゼロのアイテムは作成できません。

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

消耗品の仮想アイテム

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

主な特徴:

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

例:手榴弾、弾丸など。

非消耗品の仮想アイテム

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

主な特徴:

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

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

期間限定アイテム

期間限定アイテムは、1回限りの購入です。ユーザーは、有効期限が切れたときに再度購入する必要があります。

主な特徴:

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

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

詳細については、期間限定アイテムレシピを参照してください。

購入できるアイテム数を制限する

アイテム購入の制限をすることができます。例えば、以下の制限することができます:

  • 1ユーザーあたりのアイテム数
  • 一度しか購入できないウェルカムアイテム

ユーザーが指定した上限に達している場合、アイテムはカタログに表示されません。

ユーザーが利用できる最大アイテム数および残りのアイテム数を表示することができます。

パブリッシャーアカウントでアイテムを作成する時に購入制限を設定するには、1人のユーザーがこのアイテムを購入できる回数を制限するのトグルをオンに切り替え、アイテム購入可能回数を指定します。

アイテムに関する情報を取得するには、仮想アイテム&通貨メソッドグループからカタログサブセクションのメソッドを使用します。

応答では、仮想アイテムに関する情報のほか、以下の情報を受け取ることができます:

  • 1ユーザーが購入できる最大アイテム数
  • ユーザーが購入可能なアイテム数の残数

お知らせ

未認証のユーザーに対しては、購入可能なアイテムの最大数が常に表示されます。ユーザーに残りのアイテム数を表示するには(現在の制限に従う)、仮想アイテム&通貨メソッドグループのカタログサブセクションのメソッドを使用してアイテムカタログを要求するときにユーザーの認証データを渡します。

ユーザーが利用できるアイテム数を正しく表示するには、認証を設定する必要があります。

応答の例:

Copy
Full screen
Small screen

{
  "items": [
    {
      "sku": "big_rocket",
      "name": "Big Rocket",
      "groups": [
        {
          "external_id": "accessory",
          "name": "Accessory"
        }
      ],
      "attributes": [
        {
          "external_id": "stack_size",
          "name": "Stack size",
          "values": [
            {
              "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
              "value": "5"
            }
          ]
        }
      ],
      "type": "virtual_good",
      "description": "Big Rocket - description",
      "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
      "is_free": false,
      "price": {
        "amount": "100.99",
        "amount_without_discount": "100.99",
        "currency": "USD"
      },
      "virtual_prices": [
        {
          "amount": 100,
          "sku": "vc_test",
          "is_default": true,
          "amount_without_discount": 100,
          "image_url": "http://image.png",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "description": "description"
        }
      ],
      "can_be_bought": true,
      "inventory_options": {
        "consumable": {
          "usages_count": 1
        },
        "expiration_period": {
          "type": "day",
          "value": 1
        }
      },
      "virtual_item_type": "non_renewing_subscription",
      "limits": {
        "per_user": {
            "total": 5,
            "available": 5
        },
        "per_item": null
      },
}

お知らせ

エクソラは、制限を超えないようにし、ユーザーが設定された上限を超えてアイテムを購入することを防ぎます。

決済インターフェースを開き、アイテムの代金を支払うと、そのアイテムの未払い注文はすべて無効となります。

:ユーザーは、アイテムが購入されるまで、いくつかのブラウザータブで購入制限のあるアイテムの決済フォームを開くことができます。これにより、自動的に同じアイテムの注文が複数作成されます。1つのタブでアイテムを購入した後、エクソラは同じアイテムの未払い注文をすべて無効にします。

使用に適した方

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

入手方法

統合フロー

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

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

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

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

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

APIコールによる設定

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

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

APIコールには基本的な認証が使用されます。Authorization:Basic <your_authorization_basic_key>を渡し、そこで、<your_authorization_basic_key>マーチャントID:APIキーペア、はBase64規格に基づいてエンコードされています。パブリッシャーアカウントに移動して、以下のパラメータを見つかります:

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

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

注意

APIキーの操作については、APIリファレンスを参照してください。

キーに関する推奨事項:

  • 生成されたAPIキーは、お客様側で保存してください。APIキーは、パブリッシャーアカウントで作成時に一度だけ表示することができます。
  • APIキーは秘密にしておいてください。APIキーは、お客様の個人アカウントとパブリッシャーアカウントのプロジェクトへのアクセスを提供します。
  • APIキーはサーバーに保存する必要があり、決してバイナリやフロントエンドに保存してはいけません。

クライアント側で仮想アイテムのカタログを取得するには、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
  }
]

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

答えたくない

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

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

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