割引プロモーション

どのように動作するか

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

主な機能：

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

Copy

Full screen

Small screen

1"price": {
2  "amount": "2.3900000000000000",
3  "amount_without_discount": "2.9900000000000000",
4  "currency": "USD"
5}

制限：

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になります。

ユーザーは以下の時にキャンペーン情報を見ることができます：

ゲームカタログを見る際
ご注文の際

サイトビルダーを使用してストアを作成した場合、ゲームカタログには、割引額、割引なしのクロスした価格、割引ありの価格が表示されます。

独自のバージョンのストアを作成する場合は、ゲームリストを取得するメソッドで受け取ったデータに基づいて、カタログにプロモーションの表示を実装します。応答では、ゲームに関する情報に加えて、プロモーションに関する以下の情報を取得します：

タイトル
開始日と終了日
割引タイプのプロモーションの割引サイズ
割引タイプのプロモーションの割引あり/なしのアイテム価格
ボーナスタイプのプロモーションのボーナスアイテム

Copy

Full screen

Small screen

  1{
  2  "items": [
  3    {
  4      "sku": "game_1",
  5      "name": "Game name",
  6      "groups": [
  7        {
  8          "external_id": "all",
  9          "name": "All games"
 10        },
 11        {
 12          "external_id": "Xsolla",
 13          "name": "Xsolla games"
 14        }
 15      ],
 16      "type": "unit",
 17      "unit_type": "game",
 18      "description": "Game description",
 19      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
 20      "attributes": {
 21        "$ref": "../examples/client-attribute-game.yaml#/value"
 22      },
 23      "promotions": [],
 24      "unit_items": [
 25        {
 26          "sku": "game_key_01",
 27          "type": "game_key",
 28          "is_free": false,
 29          "price": {
 30            "amount": "30.5",
 31            "amount_without_discount": "30.5",
 32            "currency": "USD"
 33          },
 34          "virtual_prices": [],
 35          "can_be_bought": true,
 36          "drm_name": "Steam",
 37          "drm_sku": "steam",
 38          "has_keys": true,
 39          "is_pre_order": true,
 40          "release_date": "2020-08-11T10:00:00+03:00"
 41        },
 42        {
 43          "sku": "game_key_02",
 44          "type": "game_key",
 45          "is_free": false,
 46          "price": {
 47            "amount": "30.5",
 48            "amount_without_discount": "30.5",
 49            "currency": "USD"
 50          },
 51          "virtual_prices": [],
 52          "can_be_bought": true,
 53          "drm_name": "Origin",
 54          "drm_sku": "origin",
 55          "has_keys": false,
 56          "is_pre_order": false,
 57          "release_date": null
 58        }
 59      ]
 60    },
 61    {
 62      "sku": "game_2",
 63      "name": "Game name",
 64      "groups": [
 65        {
 66          "external_id": "all",
 67          "name": "All games"
 68        }
 69      ],
 70      "type": "unit",
 71      "unit_type": "game",
 72      "description": "Game description",
 73      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
 74      "attributes": [
 75        {
 76          "external_id": "OS",
 77          "name": "OS",
 78          "values": [
 79            {
 80              "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
 81              "value": "Windows"
 82            }
 83          ]
 84        }
 85      ],
 86      "promotions": [],
 87      "unit_items": [
 88        {
 89          "sku": "game_key_01",
 90          "type": "game_key",
 91          "is_free": false,
 92          "price": {
 93            "amount": "30.5",
 94            "amount_without_discount": "30.5",
 95            "currency": "USD"
 96          },
 97          "virtual_prices": [],
 98          "can_be_bought": true,
 99          "drm_name": "Steam",
100          "drm_sku": "steam",
101          "has_keys": false,
102          "is_pre_order": false,
103          "release_date": null
104        }
105      ]
106    }
107  ]
108}

注文時に、適用されたプロモーションに関する次の情報が表示されます：

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

サイトビルダーを使用する場合、カートまたは注文を行うウィンドウに、適用されたプロモーションに関する情報と、プロモーションコードを利用するためのフィールドが表示されます。

入手方法

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

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

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

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

アドミンページを介して割引プロモーションを設定した場合、以下のオプションがあります：

割合値の整数値で割引を設定する。
期間限定の割引プロモーションを設定する。
特定のプラットフォーム用のゲームキーの1つまたは複数のパッケージに適用される割引を設定する。

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

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

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

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

パブリッシャーアカウント経由でプロモーションを設定するには：

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

必要なパラメータを指定します：
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

1"items": null

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

Copy

Full screen

Small screen

1"items": [{
2     “sku”: “strw2030”
3  }, {
4     “sku”: “strw4060”
5  }, {
6     “sku”: “cupred200”
7  }
8]

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

Copy

Full screen

Small screen

1"discount": {
2    “percent”: ”49.9”
3}

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

Copy

Full screen

Small screen

1"items": [{
2     “sku”: “storm_shield”
3  }, {
4     “sku”: “heaven_crystals_pack_x500”
5  },{
6     “sku”: “strw2030”
7  }
8]

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

Copy

Full screen

Small screen

1"items": [{
2     “sku”: “brilliant_game_sku_steam”
3  }
4  ]

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

Copy

Full screen

Small screen

1“date_end”: null

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

Copy

Full screen

Small screen

 1"attribute_conditions": [
 2{
 3"attribute": "has_purchase",
 4"operator": "eq",
 5"value": "0",
 6"type": "number"
 7}
 8],
 9"limits": {
10"per_user": 1
11}