無料アイテム

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

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

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

使用例：

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ユーザーがショッピング カートを通じて購入する場合：

• カートに有料アイテムと無料アイテムの両方が含まれている場合は、CartクラスのPurchase SDKメソッドを呼び出します。このメソッドは、注文を作成し、決済UIを開き、注文ステータスを追跡するためのメソッドをカプセル化します。

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

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

Purchase、PurchaseFreeItem、およびPurchaseFreeCartメソッドには、注文ステータスを追跡するためのロジックが含まれています。これらのメソッドを呼び出すときは、注文がdoneステータスに移行したときに呼び出される関数をonSuccessパラメータに渡します。次のいずれかのオプションを使用して、アプリケーションのクライアント側でインベントリを更新します。

• ユーザーインベントリを表示するためのSDKメソッドを使用する
• 購入メソッドのonSuccessコールバック関数に渡される注文内容データを使用する

お役立ちリンク