割引プロモーション

どのように動作するか

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

主な機能：

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です。アドミンページでは、ゲームキーに対して、以下のプロモーションが作成されています：

ブラックフライデー1月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

{
  "items": [
    {
      "sku": "game_1",
      "name": "Game name",
      "groups": [
        {
          "external_id": "all",
          "name": "All games"
        },
        {
          "external_id": "Xsolla",
          "name": "Xsolla games"
        }
      ],
      "type": "unit",
      "unit_type": "game",
      "description": "Game description",
      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
      "attributes": {
        "$ref": "../examples/client-attribute-game.yaml#/value"
      },
      "promotions": [],
      "unit_items": [
        {
          "sku": "game_key_01",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Steam",
          "drm_sku": "steam",
          "has_keys": true,
          "is_pre_order": true,
          "release_date": "2020-08-11T10:00:00+03:00"
        },
        {
          "sku": "game_key_02",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Origin",
          "drm_sku": "origin",
          "has_keys": false,
          "is_pre_order": false,
          "release_date": null
        }
      ]
    },
    {
      "sku": "game_2",
      "name": "Game name",
      "groups": [
        {
          "external_id": "all",
          "name": "All games"
        }
      ],
      "type": "unit",
      "unit_type": "game",
      "description": "Game description",
      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
      "attributes": [
        {
          "external_id": "OS",
          "name": "OS",
          "values": [
            {
              "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
              "value": "Windows"
            }
          ]
        }
      ],
      "promotions": [],
      "unit_items": [
        {
          "sku": "game_key_01",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Steam",
          "drm_sku": "steam",
          "has_keys": false,
          "is_pre_order": false,
          "release_date": null
        }
      ]
    }
  ]
}

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

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

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

入手方法

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

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

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

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

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

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

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

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

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

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

アドミンページを介してプロモーションを設定するには：

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

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

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

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

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

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

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

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

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

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

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

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

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

必要なパラメータを指定してCreate discount promotion for itemメソッドを呼び出します。
“is_enabled”:trueパラメータがあるUpdate item promotionメソッドを呼び出し、プロモーションを有効にします。

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

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

プロジェクト内のすべてのアイテムに割引を構成します。“items”:nullパラメータをCreate discount promotion for itemまたは Update item promotionメソッドに渡します。

Copy

Full screen

Small screen

"items": null

物理的な商品の割引を構成します。物理的な商品のSKUを含む配列をCreate discount promotion for itemまたはUpdate item promotionメソッドに渡します。

Copy

Full screen

Small screen

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

端数の割合値で割引を構成します。端数の割合値があるdiscount.percentパラメータをCreate discount promotion for itemまたはUpdate item promotionメソッドに渡します。

Copy

Full screen

Small screen

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

さまざまなタイプのアイテムの割引を構成します。必要なアイテムのSKUを含む配列をCreate discount promotion for itemまたはUpdate item promotionメソッドに渡します。

Copy

Full screen

Small screen

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

ゲームの明確なDRMの割引を構成します。必要なDRMのSKUを含む配列を含む配列をCreate discount promotion for itemまたはUpdate item promotionメソッドに渡します。

Copy

Full screen

Small screen

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

指定された期間がない割引プロモーションを構成します。“date_end”:nullパラメータをCreate discount promotion for itemまたはUpdate item promotionメソッドに渡します。

Copy

Full screen

Small screen

“date_end”: null