割引プロモーション

どのように動作するか

割引プロモーションは、新規プレイヤーを獲得して売上を伸ばすためのマーケティングツールです。

主な機能：

1つまたは複数のアイテムの割引を構成します。
1つのアイテムに無制限の数の割引プロモーションを適用します。
アイテムの価格を自動計算してアイテムのカタログを作成します。カタログを作成するためのメソッドは、アイテムごとにpriceオブジェクトを返します。このオブジェクトには、現在の割引がある項目とない項目の価格が含まれています。

Copy

Full screen

Small screen

"price": {
  "amount": "2.3900000000000000",
  "amount_without_discount": "2.9900000000000000",
  "currency": "USD"
}

制限：

1から99までの範囲内のパーセンテージ値でのみ割引を設定することができます。
割引キャンペーンに地域限定を適用することはできません。

いくつものアイテムにプロモーションを設定することができます。1つのアイテムに対して、割引キャンペーンを無制限に適用することができます。

アイテムに対して、割引、クーポン、プロモーションコード、ボーナスなど、さまざまなタイプのプロモーションを設定することができます。

購入時に1つのアイテムに複数のプロモーションが有効な場合、割引は1つずつ項目に適用されます。割引が適用される順番は関係ありません。

例：

仮想アイテムの価格は$10です。アドミンページでは、仮想アイテムに対して、以下のプロモーションが作成されています：

ブラックフライデー11月4日から30日まで10％割引の割引キャンペーン
セール 11月15日から12月15日まで20％割引の割引キャンペーン
11月4日から30日まで、5％割引のプロモーションコードを使ったキャンペーン

11月20日にアイテムを購入した場合、割引キャンペーンとプロモーションコードによるプロモーションコードの両方が有効です。

仮想アイテムの総額は、(($10 - 10%) - 20%) - 5%で計算され、$6.84になります。

アイテムカタログを取得するために使用されるのと同じAPIメソッドを使用して、割引またはボーナスタイプのプロモーションキャンペーンに関する情報を取得できます。応答では、仮想アイテムに関する情報に加えて、指定されたタイプの現在のプロモーションに関する情報を受け取ります：

タイトル
開始日と終了日
割引タイプのプロモーションの割引のサイズ
ボーナスタイプのプロモーションのボーナスアイテム
このプロモーションでユーザーが利用できるアイテムの総数
このプロモーションでユーザーが利用できる残りのアイテム数

Copy

Full screen

Small screen


"item_id": 193166,
"sku": "helmet",
"type": "virtual_good",
"name": "{
Helmet",
"description": "---",
"image_url": "https://static.xsolla.com/misc/publisher_account/virtual_item_default_image.png",
"price": {
    "amount": "31.50",
    "amount_without_discount": "34.99",
    "currency": "TRY"
},
"virtual_prices": [],
"can_be_bought": true,
"promotions": [
    {
        "name": "store_promotion_164901_b5ef62b0551711edaedb22484f053720_name",
        "date_start": "2022-10-25T00:00:00+03:00",
        "date_end": "2022-11-30T23:59:59+03:00",
        "discount": {
            "percent": "10.00",
            "value": null
        },
        "bonus": [],
        "limits": {
            "per_user": {
                "available": 3,
                "total": 3
            }
        }
    },
    {
        "name": "store_promotion_164901_dc1fd2b2551711ed82b722484f053720_name",
        "date_start": "2022-10-24T00:00:00+03:00",
        "date_end": "2022-11-30T23:59:59+03:00",
        "discount": null,
        "bonus": [
            {
                "sku": "22",
                "quantity": 1
            },
            {
                "sku": "sword",
                "quantity": 2
            }
        ],
        "limits": {
            "per_user": {
                "available": 1,
                "total": 1
            }
        }
    }
],
"limits": null,
"attributes": [
    {
        "external_id": "sh4",
        "name": "sh4",
        "values": [
            {
                "external_id": "hd",
                "value": "20"
            }
        ]
    }
],
"is_free": false,
"groups": [
    {
        "external_id": "imported",
        "name": "Imported"
    }
],
"virtual_item_type": "consumable",
"inventory_options": {
    "consumable": {
        "usages_count": 1
    },
    "expiration_period": null
}
}

入手方法

割引キャンペーンを設定する

次のいずれかの方法で割引キャンペーンを設定できます：

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

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

アドミンページ経由で割引キャンペーンを設定した場合：

パーセント値で割引を設定します。
期間限定の割引キャンペーンを設定する。
任意のタイプのアイテムに適用される割引を設定します：
- 仮想通貨パッケージ
- 仮想アイテム（期間限定アイテムを含む）
- ゲームキー
- バンドル

現在、アドミンページでは、次の操作は利用できません：

小数値で割引を設定します。
無制限の期間で割引を設定します。
割引キャンペーンの状況を「有効」に編集します。

APIメソッドを使用して、割引キャンペーンの設定オプションを増加できます。

新規プロモーションは、デフォルトで非アクティブになっています。割引を有効にするには、作成後、割引の編集に移動します。

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

ストア > プロモーションと報酬に移動し、アドミンページで「プロモーションの作成」をクリックします。

必要なパラメータを指定します：
1. プロモーションタイトルを入力します。
2. 割引をプロモーションタイプとして選択します。
3. 割引額を決定します。
4. 製品タイプを選択します。

1. 割引が適用されるアイテムを1つまたは複数選択します。

1つのプロモーションで異なる商品タイプを選択するには、まず1つの商品タイプを選択し、それらが対象商品リストフィールドに表示されているかどうかを確認します。その後、製品タイプフィールドに戻り、別のタイプを選択します。

「次へ」をクリックします。
一人のユーザーがプロモーションを利用できる回数を制限することができます。セットアップするには「条件と制限」ページで、「1人のユーザーがプロモーションを利用できる回数を制限する」を「オン」にして、制限値を指定します。
パーソナライズされたプロモーションを設定するには、「特定のユーザーのみを対象とするプロモーション」を「オン」に設定し、この説明に従います。
「次へ」をクリックします。

キャンペーンの開始日と終了日を設定します。
次へをクリックします。

設定を確認し、保存終了をクリックします。

プロモーションが有効な間は、変更することはできません。

プロモーションを有効にするには：
1. プロモーションカタログでプロモーションを見つけます。
2. •••メニューボタンをクリックしてプロモーションを編集するを選択します。

1. 右上隅のドロップダウンメニューを開き、プロモーションを有効にするを選択します。

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

割引プロモーションを使用するには、プロモーションメソッドグループの割引サブセクションのメソッドを使用することができます。

APIメソッド経由でプロモーションを作成するには：

必要なパラメータを指定してアイテムの割引プロモーションを作成するメソッドを呼び出します。
“is_enabled”:trueパラメータがあるアイテムプロモーションを更新するメソッドを呼び出し、プロモーションを有効にします。

API経由でプロモーションを編集するには、新しいプロモーションパラメータがあるアイテムプロモーションを更新するメソッドを呼び出します。また、Activeステータスを持つプロモーションを編集することもできます。

APIメソッドを使用して割引プロモーションを作成または編集する場合は、次のこともできます：

プロジェクト内のすべてのアイテムに割引を構成します。“items”:nullパラメータをアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。

Copy

Full screen

Small screen


"items": null

物理的な商品の割引を構成します。物理的な商品のSKUを含む配列をアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。

Copy

Full screen

Small screen


"items": [{
     “sku”: “strw2030”
  }, {
     “sku”: “strw4060”
  }, {
     “sku”: “cupred200”
  }
]

端数の割合値で割引を構成します。端数の割合値があるdiscount.percentパラメータをアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。

Copy

Full screen

Small screen


"discount": {
    “percent”: ”49.9”
}

さまざまなタイプのアイテムの割引を構成します。必要なアイテムのSKUを含む配列をアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。

Copy

Full screen

Small screen

"items": [{
     “sku”: “storm_shield”
  }, {
     “sku”: “heaven_crystals_pack_x500”
  },{
     “sku”: “strw2030”
  }
]

ゲームの明確なDRMの割引を構成します。必要なDRMのSKUを含む配列を含む配列をアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。

Copy

Full screen

Small screen

"items": [{
     “sku”: “brilliant_game_sku_steam”
  }
  ]

指定された期間がない割引プロモーションを構成します。“date_end”:nullパラメータをアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。

Copy

Full screen

Small screen


“date_end”: null

初回購入者向けのプロモーションを設定します。そのためには、アイテムAPIのアイテムの割引キャンペーンを作成するまたはアイテムのプロモーションを更新するAPIで、配列attribute_conditionsのオブジェクトを渡します：

Copy

Full screen

Small screen

"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}