決済ソリューション / ボーナスプロモーション
  ドキュメントに戻る

決済ソリューション

ボーナスプロモーション

どのように動作するか

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

主な機能:

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

使用例:

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

ボーナスプロモーションに地域制限を設定することはできません。

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

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

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

Copy
Full screen
Small screen

{
  "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メソッドを使用して、ボーナスプロモーションの設定オプションを強化することができます。

お知らせ
新規プロモーションは、デフォルトで非アクティブになっています。プロモーションをアクティブにするには、プロモーションを編集し、ドロップダウンリストの右上隅にある「プロモーションをアクティブにする」を選択します。

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

  1. アドミンページでの「ストア > プロモーションと報酬」に移動します。
  1. プロモーションを作成するをクリックします。
  1. 以下のパラメータを指定してください:
    1. プロモーションのタイトルを入力します。
    2. ボーナス」をプロモーションタイプとして選択します。
    3. プロモーションアイテムを指定します。
    4. 販促アイテムの購入時にユーザーに付与されるアイテムを指定します。
お知らせ

1つのプロモーションで複数のタイプのアイテムを選択するには、まず1タイプのアイテムを選択し、「販促アイテムのリスト」フィールドに表示されているかどうかを確認し、「販促アイテム」フィールドに戻って別のタイプを選択します。

1つのプロモーションで、異なるタイプのボーナスアイテムを複数選択するには、まず1タイプのアイテムを選択し、「ボーナスアイテムのリスト」フィールドに表示されているかどうかを確認し、「ボーナスアイテム」フィールドに戻って別のタイプを選択します。

  1. 次へ」をクリックします。
  2. 必要に応じて、プロモーションの使用回数を設定できます。これを行うには、「条件と制限」ページで、「1人のユーザーがプロモーションを使用できる回数を制限する」トグルを「オン」に切り替えて、回数を指定します。
  3. パーソナライズされたプロモーションを設定するには、「特定のユーザーのみプロモーションをトリガーする」を「オン」に設定し、条件を指定します。個人用設定を設定するには、次の説明に従います。
  4. 次へ」をクリックします。
  5. プロモーション期間を指定します。
  1. 次へ」をクリックします。
  2. 設定内容を確認し、「保存して終了する」をクリックします。
  3. プロモーションを有効にするには:
    1. プロモーションカタログでプロモーションを見つけます。
    2. •••」アイコンをクリックし、ドロップダウンリストで「プロモーションを編集する」を選択するか、アクションカタログのアクションをクリックして編集に進みます。
    3. 右上隅にあるドロップダウンメニューを開き、「プロモーションを有効にする」を選択します。

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

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

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

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

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

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

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

Copy
Full screen
Small screen

“condition”: null
Copy
Full screen
Small screen

“date_end”: null
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか?

答えたくない

ご意見ありがとうございました!
最終更新日: 2024年1月22日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!