無料アイテム
どのように動作するか
無料アイテムとは、ユーザーが仮想通貨や実際通貨を使わずに手に入れることができるアイテムの一種です。以下が含まれます：
- 仮想アイテム
- バンドル
- 仮想通貨パッケージ
無料アイテムは、認証されたユーザーだけが利用できます。認証されていないユーザーは、無料アイテムのカタログのみを表示できます。
使用例：
- プロジェクトにとって重要な日（例えば、プロジェクト設立の日など）に無料アイテムを配布し、ユーザーロイヤリティに報いることができます。
- ストアでゲームのスターターパックを無料で配布することで、新しいユーザーをゲームに引き付けることができます。
ユーザーがすでに持っている場合は、ユニークなアイテムの無料配布を制限することができます。
使用に適した方
- すでにショップビルダーを持っていて、新しいタイプのアイテム — 無料アイテムをセットアップしたいパートナー向け。
- 現在のユーザーロイヤルティを高めたい、または新しいプレーヤーを引き付けたいパートナー向け。
統合フロー
- 次の方法で無料アイテムを作成します：
- ストアをセットアップする。
- ユーザーの注文状況を取得します。
パブリッシャーアカウント経由で作成する
無料アイテムを作成するには（仮想アイテムの例に基づく）：- パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想アイテムセクションに移動します。
- 「+」をクリックし、ドロップダウンリストからアイテムを作成を選択します。
- 以下を指定します：
- 画像
- SKU
- アイテムが属するべき1つまたは複数のグループ
- 名前
- 説明
- アイテム属性：消耗品、非消耗品、期間限定アイテムなど。
- 価格を設定ブロックで、無料アイテムを選択します。
- 特定のユーザーにアイテムの購入を制限したい場合は、1ユーザーがこのアイテムを購入できる回数を制限するのトグルをオンに切り替えて、回数を指定してください。
- ストアにアイテムを表示する場合は、ストアでアイテムを表示するのトグルをオンに設定します。
- 「アイテムを作成」をクリックします。
APIコール経由で作成する
- 無料アイテムを作成するには、管理サブセクションからAPIコールを使用します。
- 仮想通貨の場合 — 仮想アイテムを作成する
- 通貨パッケージの場合 — 仮想通貨パッケージを作成する
- バンドルの場合 — バンドルを作成する
is_free = trueを渡してください。 - 特定のユーザーにアイテムの利用を制限したい場合は、アイテムを作成または編集する任意のAPIメソッドを呼び出し、
limits.per_userパラメータの値を指定します。
ストアをセットアップする
迅速な購入
ユーザーが迅速な購入を使用する場合（カートを使用しないユーザー）、無料アイテムを受け取る機会を提供するために、指定した無料アイテムで注文を作成するAPIを呼び出す必要があります。ユーザーのインベントリへのアイテム配信は、このメソッドへのリクエストが成功した直後に行われます（ペイステーションの決済フォームを開く必要はありません）。エクソーラは注文支払い完了ウェブフックを送信し、商品が配送されたことを知らせます。リクエストの例：Copy
- http
1{
2 "method": "POST",
3 "url": "https://mybestgame.com/xsolla/notification",
4 "body": {
5 "items": [
6 {
7 "sku": "gift_direct_game_reward-supercoin",
8 "type": "virtual_currency",
9 "is_pre_order": false,
10 "quantity": 500,
11 "amount": "0",
12 "promotions": [
13
14 ]
15 },
16 {
17 "sku": "package-500_supercoin",
18 "type": "bundle",
19 "is_pre_order": false,
20 "quantity": 1,
21 "amount": "0",
22 "promotions": [
23
24 ]
25 },
26 {
27 "sku": "xsolla-giveaway_offer_11_14_22",
28 "type": "bundle",
29 "is_pre_order": false,
30 "quantity": 1,
31 "amount": "0",
32 "promotions": [
33
34 ]
35 }
36 ],
37 "notification_type": "order_paid",
38 "order": {
39 "id": 12345678,
40 "mode": "default",
41 "currency_type": "unknown",
42 "currency": null,
43 "amount": "0",
44 "status": "paid",
45 "platform": "xsolla",
46 "comment": null,
47 "invoice_id": null,
48 "promotions": [
49
50 ]
51 },
52 "user": {
53 "external_id": "1234567812345678",
54 "email": null
55 }
56 },
57 "headers": {
58 "Authorization": "Signature 3b840ccefea111dcdfd111db1fdc6df969a3ec11",
59 "Accept": "application/json",
60 "Content-Type": "application/json"
61 },
62 "type": "webhook_payment",
63 "callback_parameters": {
64 "order_id": 12345678
65 }
66}
お知らせ
無料アイテムの場合、order.invoice_idパラメータは
nullに設定されます。- リスナーがウェブフックを正しく受け入れて処理した場合 — HTTP応答コード200または204。
- 予期したエラーが発生した場合 — HTTP応答コード4xx。
- リスナーは、サーバー上の一時的なエラーのために5xxHTTP応答コードを返すこともあります。この場合、エクソーラアラートサービスは再試行イメカニズムを使用します。
お知らせ
この場合、アイテムはプレイヤーのインベントリに追加され、注文はエクソーラ側で成功としてマークされます。
カート購入
ユーザーがカート購入を使用する場合：
- ユーザーのカートに有料アイテムと無料アイテムの両方が含まれている場合は、標準の特定のカートの全アイテムを対象とした注文を作成すると現在のカートの全アイテムを含む注文を作成するAPIを呼び出して注文を作成します。ユーザーは、ペイステーションの支払いフォームを通じて注文の支払いを行います。
- ユーザーのカートに無料のアイテムしか含まれていない場合は、無料カートで注文を作成するおよび特定の無料カートで注文を作成するAPIを呼び出して、無料のカートを取得します。この場合、支払いインターフェースは使用されず、支払いは自動的に処理されます。
ウェブフックの例は、迅速的な購入の例と同様です。
この記事は役に立ちましたか？
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
