ボーナスプロモーション

どのように動作するか

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

主な機能：

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

使用例：

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

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

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

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

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

{
  "item_id": 400962,
  "sku": "test_item",
  "type": "virtual_good",
  "name": "name_test_limit",
  "description": "description_test_limit",
  "price": {
    "amount": "1.00",
    "amount_without_discount": "1.00",
    "currency": "USD"
  },
  "virtual_prices": [
    {
      "description": null,
      "item_id": 322172,
      "sku": "1234500",
      "name": "virt currency only",
      "type": "virtual_currency",
      "amount": 1,
      "amount_without_discount": 1,
      "calculated_price": {
        "amount": "1.00",
        "amount_without_discount": "1.00"
      },
      "is_default": true
    }
  ],
  "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