無料アイテム

無料アイテムとは、ユーザーが仮想通貨や実際通貨を使わずに手に入れることができるアイテムの一種です。以下が含まれます：

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

無料アイテムは、認証されたユーザーだけが利用できます。認証されていないユーザーは、無料アイテムのカタログのみを表示できます。

使用例：

• プロジェクトにとって重要な日（例えば、プロジェクト設立の日など）に無料アイテムを配布し、ユーザーロイヤリティに報いることができます。
• ストアでゲームのスターターパックを無料で配布することで、新しいユーザーをゲームに引き付けることができます。

ユーザーがすでに持っている場合は、ユニークなアイテムの無料配布を制限することができます。

無料アイテムをセットアップするには：

1. 無料アイテムをカタログに追加します。
2. ユーザーが無料アイテムを注文するロジックを実装します。
3. 無料アイテムをユーザーに付与するロジックを実装します。

無料アイテムをカタログに追加する

アイテムの詳しい作成方法については、次のドキュメンテーションセクションを参照してください：

• 仮想通貨パッケージを設定する
• 仮想アイテムを作成する
• バンドルを作成する

無料アイテムを作成または編集する場合、有料または無料セクションで、無料アイテム、無料パッケージ、無料バンドルを選択する必要があります。

ユーザーによる無料アイテムを注文する

ユーザーは、2つの方法で無料アイテムを注文することができます：

• ワンクリック（ショッピングカートを使用せずに） — 1つのSKU、数量は問いません。たとえば、100個の同じポーション。
• ショッピングカート経由 — 任意種類のアイテムを任意の数量。

ワンクリックで無料アイテムを注文する

このオプションを実装するには、ユーザーが無料アイテムを注文するためにカタログのボタンをクリックしたときに、ストアライブラリストアライブラリのcreateOrderWithSpecifiedFreeItemメソッドを呼び出します。

エクソラ側のユーザーインベントリへのアイテムの配送は、このメソッドへのリクエストが成功した直後に行われます（決済ステーションを開く必要はありません）。

ショッピングカートから無料アイテムを注文する

ユーザーがショッピングカート経由で購入する場合：

• ユーザーのカートに有料と無料アイテムの両方が含まれている場合：
  1. ストアライブラリのcreateOrderWithCartメソッドを使用して、決済トークンと注文IDを取得します。
  2. 決済UIを開くためのURLを取得します。これを行うには、ストアライブラリのcreatePaymentUrlメソッドを呼び出し、決済トークンと注文IDを渡します。
  3. 決済UIを開く操作を実装します：

1. 1. 1. 外部ブラウザで決済UIを開くには、UIApplication.shared.open静的メソッドを呼び出し、前のステップで取得したURLを渡します。
      2. 内蔵ブラウザで決済UIを開くには、決済ライブラリのPaystationWebViewクラスをインスタンス化し、loadPaystationメソッドを呼び出します。デモプロジェクトのPaystationVCクラスに実装例があります。

• ユーザーのカートに無料アイテムのみが含まれている場合は、決済ライブラリのcreateOrderWithFreeCartメソッドを呼び出します。エクソーラ側でのユーザーのインベントリへのアイテムの配送は、このメソッドへのリクエストが成功した直後に行われます（ペイステーションを開く必要はありません）。

ユーザーへの無料アイテムを付与する

ストアライブラリのgetOrderメソッドを繰り返し呼び出すと、無料アイテムの注文状況を追跡することができます。

注文が成功した場合、ユーザーインベントリを表示するためのSDKメソッドを使用して、アプリケーションのクライアント側でデータを更新します。

お役立ちリンク