ボーナスプロモーション

どのように動作するか

ボーナスプロモーションは、仮想アイテムの購入者にボーナスアイテムを付与し、インセンティブを与えるマーケティングツールです。

主な機能：

• 販促アイテム購入時に1つまたは複数のボーナスアイテムを提供します。
• ユーザーがプロモーションを利用できる回数を指定します。
• パーソナライズされたボーナスプロモーションを設定します。

使用例：

• ボーナスは、仮想通貨として仮想アイテムに使用することができます。
• プロジェクトの記念日など、プロジェクトの重要な日にボーナスプロモーションを行い、ユーザーのロイヤリティに報いることができます。
• ゲーム内で一定のレベルに達したユーザーに対して、アイテム購入に加えて、ボーナスアイテムを提供し、ユーザーのロイヤリティに報いることができます。

• 期間限定でユーザーにボーナスアイテムを提供して、ユーザーが仮想アイテムを購入するように動機付けます。

APIメソッドを使用してアイテムのカタログを構築する際、プロモーションに関する情報を取得することができます。応答では、仮想アイテムに関する情報に加えて、「ボーナス」タイププロモーションに関する以下の情報が表示されます：

• 名称
• 開始日と終了日
• ボーナスアイテム
• ユーザーが利用できるプロモーションの総数
• ユーザーが利用できる残りのプロモーション数

ユーザーが利用できるプロモーションの残数がゼロの場合、カタログにプロモーション情報は表示されません。

 1{
 2  "item_id": 400962,
 3  "sku": "test_item",
 4  "type": "virtual_good",
 5  "name": "name_test_limit",
 6  "description": "description_test_limit",
 7  "price": {
 8    "amount": "1.00",
 9    "amount_without_discount": "1.00",
10    "currency": "USD"
11  },
12  "virtual_prices": [
13    {
14      "description": null,
15      "item_id": 322172,
16      "sku": "1234500",
17      "name": "virt currency only",
18      "type": "virtual_currency",
19      "amount": 1,
20      "amount_without_discount": 1,
21      "calculated_price": {
22        "amount": "1.00",
23        "amount_without_discount": "1.00"
24      },
25      "is_default": true
26    }
27  ],
28  "can_be_bought": true,
29  "promotions": [
30    {
31      "name": "New Year Bonus",
32      "date_start": "2022-12-30T22:00:00+03:00",
33      "date_end": "2023-01-02T21:59:59+03:00",
34      "discount": null,
35      "bonus": [
36        {
37          "quantity": 3,
38          "name": "mybonusitem",
39          "sku": "444777",
40          "type": "virtual_good"
41        }
42      ],
43      "limits": {
44        "per_user": {
45          "available": 7,
46          "total": 7
47        }
48      }
49    }
50  ],
51  "limits": null,
52  "attributes": [],
53  "is_free": false,
54  "groups": [
55    {
56      "external_id": "01022023",
57      "name": "Group1"
58    }
59  ],
60  "virtual_item_type": "consumable",
61  "inventory_options": {
62    "consumable": {
63      "usages_count": 1
64    },
65    "expiration_period": null
66  }
67}

入手方法

ボーナスプロモーションのセットアップ

• アドミンページ経由
• APIメソッド経由

アドミンページ経由のセットアップ

• プロモーションの有効期間を設定する
• ユーザーがプロモーションを使用できる回数を制限する
• プロモーションがトリガーされる条件を設定する

• あらゆるタイプのアイテムに適用されるプロモーションをセットアップします：

  • 仮想通貨パッケージ
  • 仮想アイテム（期間限定アイテムを含む）
  • ゲームキー
  • バンドル

「アクティブ」のステータスのボーナスプロモーションを編集することは、現在、アドミンページで利用できません。

APIメソッドを使用して、ボーナスプロモーションの設定オプションを強化することができます。

アドミンページ経由でプロモーションをセットアップするには：

1. パブリッシャーアカウントでの「ストア > LiveOpsとプロモーションツール」に移動します。

2. プロモーションを作成するをクリックします。

3. 以下のパラメータを指定してください：
   1. プロモーションのタイトルを入力します。
   2. 「ボーナス」をプロモーションタイプとして選択します。
   3. プロモーションアイテムを指定します。
   4. 販促アイテムの購入時にユーザーに付与されるアイテムを指定します。

4. 「次へ」をクリックします。
5. 必要に応じて、プロモーションの使用回数を設定できます。これを行うには、「条件と制限」ページで、「1人のユーザーがプロモーションを使用できる回数を制限する」トグルを「オン」に切り替えて、回数を指定します。
6. パーソナライズされたプロモーションを設定するには、「特定のユーザーのみプロモーションをトリガーする」を「オン」に設定し、条件を指定します。個人用設定を設定するには、次の説明に従います。
7. 「次へ」をクリックします。
8. プロモーション期間を指定します。

9. 「次へ」をクリックします。
10. 設定内容を確認し、「保存して終了する」をクリックします。
11. プロモーションを有効にするには：
    1. プロモーションカタログでプロモーションを見つけます。
    2. 「•••」アイコンをクリックし、ドロップダウンリストで「プロモーションを編集する」を選択するか、アクションカタログのアクションをクリックして編集に進みます。
    3. 右上隅にあるドロップダウンメニューを開き、「プロモーションを有効にする」を選択します。

APIメソッド経由のセットアップ

ボーナスプロモーションを使用するには、プロモーションメソッドグループの「共通」または「ボーナス」サブセクションのメソッドを使用することができます。

ボーナスプロモーションを作成するには、ボーナスプロモーションを作成するメソッドを使用し、必要なパラメータを指定します。

ボーナスプロモーションを有効にするには、“is_enabled”:trueパラメータを指定してボーナスプロモーションを更新するメソッドを使用するか、プロモーションを有効にするメソッドを使用します。

プロモーションを無効にするには、プロモーションを無効にするメソッドを使用します。

APIメソッドでプロモーションを編集するには、新しいプロモーションパラメータを指定してボーナスプロモーションを更新するメソッドを呼び出します。プロモーションの編集は、「アクティブ」のステータスのプロモーションでも可能です。

APIメソッドでボーナスプロモーションを作成または編集する場合、以下のようなことも可能です：

• プロジェクト内のすべてのアイテムに対してプロモーションのアクションを設定するには、“condition”:nullパラメータをボーナスプロモーションを作成するまたはボーナスプロモーションを更新するメソッドに渡します。

1“condition”: null

• 無期限のプロモーションを設定するには、“date_end”:nullパラメータをボーナスプロモーションを作成するまたはボーナスプロモーションを更新するメソッドに渡してください。

1“date_end”: null