ボーナスプロモーション

どのように動作するか

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

主な機能：

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

使用例：

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

• ユーザーに期間限定でボーナスアイテムを付与することで、仮想アイテムやゲームの購入意欲を高めることができます。

• ボーナスキャンペーンに地域限定を適用することはできません。
• そのゲームに設定された地域制限に関係なく、どの地域のユーザーもボーナスとしてゲームを受け取ることができます。

• ボーナスとして提供されるゲームのキーが不足すると、ユーザーはそのボーナスでプロモーションアイテムを購入できなくなります。

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

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

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

{
  "item_id": 400962,
  "sku": "test_game",
  "type": "game_key",
  "name": "name_test_limit",
  "description": "description_test_limit",
  "price": {
    "amount": "1.00",
    "amount_without_discount": "1.00",
    "currency": "USD"
  },
  "can_be_bought": true,
  "promotions": [
    {
      "name": "New Year Bonus",
      "date_start": "2022-12-30T22:00:00+03:00",
      "date_end": "2023-01-02T21:59:59+03:00",
      "discount": null,
      "bonus": [
        {
          "quantity": 3,
          "name": "mybonusitem",
          "sku": "444777",
          "type": "virtual_good"
        }
      ],
      "limits": {
        "per_user": {
          "available": 7,
          "total": 7
        }
      }
    }
  ],
  "limits": null,
  "attributes": [],
  "is_free": false,
  "groups": [
    {
      "external_id": "01022023",
      "name": "Group1"
    }
  ],
  "virtual_item_type": "consumable",
  "inventory_options": {
    "consumable": {
      "usages_count": 1
    },
    "expiration_period": null
  }
}

• 割引キャンペーンを適用した結果：
  • キャンペーン割引額
  • 割引なしの価格
  • 割引価格
• ボーナスプロモーションを適用した結果：
  • ボーナスアイテム
  • ボーナスアイテムの価格ラインの無料値
• プロモーションコードを適用した結果
  • プロモーションコードの割引額
  • 割引なしの価格
  • 割引価格
  • ボーナスアイテム
  • ボーナスアイテムの価格ラインの無料値

入手方法

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

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

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

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

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

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

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

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

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

1. アドミンページでの「ストア > プロモーションと報酬」に移動します。

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パラメータをボーナスプロモーションを作成するまたはボーナスプロモーションを更新するメソッドに渡します。

“condition”: null

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

“date_end”: null