プロモーションコード

どのように動作するか

プロモーションコードは、新規ユーザーを獲得し、売上を伸ばすためのマーケティングツールです。プロモーションコードを有効にした後、ユーザーは以下の特典のいずれかを受け取ることができます:

  • ユーザーのカートや特定の商品に適用される割引です。
  • 一つのボーナスアイテム:
    • ゲームキー
    • 仮想通貨パッケージ
    • バンドルまたは期間限定アイテムを含む仮想アイテム

主な機能:

  • 割引のみ、特典のみ、割引と特典の両方を選ぶ
  • キャンペーン期間中のプロモーションコードの総使用回数の設定
  • キャンペーン期間中の1ユーザーに対するプロモーションコードの使用回数の設定
  • リクエストに応じて地域制限の設定
  • プロモーションコードの複数回生成
  • プロモーションコード適用後にボーナスアイテムをカートに入れる
  • プロモーションコードを使用した後にアイテムに割引を適用する

制限:

  • プロモーションコードはカートに1つだけ適用できます
  • 割引や特典を受けるには、カートに入れた商品の代金を支払う必要があります
  • プロモコードに地域限定販売のアイテムが含まれている場合、これらのアイテムが限定されている地域のユーザーは、このプロモコードを使用してアイテムを受け取ることができません

どのように動作するか

ユーザーフロー:

  1. ユーザーは、UIの対応するフィールドにプロモーションコードを入力します。

  1. アイテムのコストを再計算し、ボーナスアイテムを追加します。
  2. ユーザーが支払いを行うと、プロモーションコードが引き換えられたと見なされます。
  3. プロモーションコードにボーナスアイテムが含まれている場合、それらは次のいずれかの方法でユーザーに配信されます:
    • インベントリに直接配信(仮想アイテムまたは仮想通貨パッケージ)
    • メール経由配信(ゲームキー)
    • エンタイトルメントシステム(ゲームキー)に直接配信
注意

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

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

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

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

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

キーの総額は、(($10 - 10%) - 20%) - 5%で計算され、$6.84になります。

注文を作成する際に、ユーザーはプロモーションコードを利用し、適用されたプロモーションの情報を確認することができます:
  • 割引キャンペーンを適用した結果:
    • キャンペーン割引額
    • 割引なしの価格
    • 割引価格
  • ボーナスプロモーションを適用した結果:
    • ボーナスアイテム
    • ボーナスアイテムの価格ラインの無料
  • プロモーションコードを適用した結果
    • プロモーションコードの割引額
    • 割引なしの価格
    • 割引価格
    • ボーナスアイテム
    • ボーナスアイテムの価格ラインの無料

入手方法

前提条件

  1. エクソーラアドミンページを作成します
  2. ゲームキーモジュールを接続し、設定します

統合フロー

指定したアイテムで注文を作成するメソッドを使用して1つのキーのクイック購入を実装している場合、ユーザーはカートに移動せずに支払いに進みます。

同時に、エクソーラ側でカートが作成されますが、ユーザーには表示されません。これは、ユーザーの購入に既存のすべての割引を正しく適用し、決済フォームにすべての割引を含む金額を表示するために必要なものです。

プロモーションコードでキャンペーンを設定する

  1. アドミンページでの「ストア > プロモーションと報酬」に移動して、プロモーションを作成します。
  2. 以下のパラメータを指定します:
    1. プロモーション名を入力します。
    2. プロモーションタイプとしてプロモーションコードを選択します。
  3. External IDを作成する — プロモーションを管理するために使用される一意のプロモーション識別子で、特典の受け取りプロモーションコードの引き換えのメソッドを使用します。
  4. プロモーションコードの割引率を指定します。割引は、カート全体または特定のアイテムに適用できます。
  5. ユーザーがプロモーションコードを引き換えたときに受け取るボーナスアイテムを選択します:
  6. 総引き換え回数とユーザーごとの引き換え回数を指定します。
  7. キャンペーンの期間を指定します。
  8. 設定を確認し、プロモーションを保存します。
  9. プロモーション編集メニューに移動します。
  10. コードタブで、プロモーションコードの生成方法を選択します。
  11. プロモーションコードを生成するか、手動で入力します。
  12. 変更内容を保存します。
  13. プロモーションを有効にします。

仮想通貨をパッケージにしたプロモーションコード

仮想通貨パッケージでプロモーションコードを作成するには:

  1. 仮想通貨パッケージを作成します。
  2. ボーナスアイテムとして、仮想通貨パッケージを指定します。

仮想通貨パッケージを作成するには:

  1. ストア > 仮想通貨モジュール設定に移動して仮想通貨を作成します。これを行うには、新規仮想通貨をクリックして以下のことを追加します:
    • パッケージの画像(任意)
    • 仮想通貨SKU
    • 仮想通貨名
    • 仮想通貨1単位の価格
    • デフォルト通貨
    • 属性(任意)
  2. 仮想通貨パッケージを作成します。これを行うには、新規パッケージをクリックして以下のことを追加します:
    • パッケージの画像(任意)
    • パッケージSKU
    • パッケージ名
    • パッケージの簡単な説明
    • パッケージの仮想通貨
    • パッケージ内の通貨の量
    • 実際通貨または(および)仮想通貨での価格
    • デフォルト通貨
    • 属性(任意)
  3. パッケージを作成するをクリックします。
お知らせ
仮想アイテム、仮想通貨、または仮想通貨パッケージを作成した後、アイテムにステータスを設定し、利用可能、利用不可、または部分的に利用可能かを決定できます。

仮想アイテムを使ったプロモーションコード

仮想アイテムでプロモーションコードを作成するには:

  1. 仮想アイテムを作成します。
  2. ボーナスアイテムとして、仮想アイテムを指定します。

仮想アイテムを作成するには:

  1. ストア > 仮想アイテムモージュル設定に移動してアイテムを作成するをクリックします。
  2. 各アイテムに次を追加します:
    • 画像(任意)
    • SKU
    • アイテムが属するべき1つまたは複数のグループ(任意)
    • アイテム名
    • アイテムに関する説明
    • アイテムプロパティ-消耗品、非消耗品、期間限定品
    • 実際通貨または(および)仮想通貨での価格
  3. アイテムを作成するをクリックします。
お知らせ
仮想アイテム、仮想通貨、または仮想通貨パッケージを作成した後、アイテムにステータスを設定し、利用可能、利用不可、または部分的に利用可能かを決定できます。
バンドルや期間限定商品など、1つのプロモーションコードで1つまたは複数の異なるSKUの商品を選択することができます。

ゲームキー付きのプロモーションコード

ゲームキー付きのプロモーションコードを作成するには:
  1. ゲームキーパッケージを作成します
  2. ボーナスとして作成したゲームキーパッケージのSKUと、購入するプラットフォームの選択方法を指定します:

    • プロモーションコードは、すでに設定されている特定のプラットフォームに対して生成されます。
    • ユーザーはプロモーションコードを使用する際に、特定のプラットフォームを選択します。

1つのプロモーションコードに対して、SKUの異なる複数のキーを選択することができます。

プロモーションコードを生成する

キャンペーンには、1つまたは複数のプロモコードが含まれている場合があります。プロモコードの形式には2つのオプションがあります:
  • 手動で入力された文字列 - 何度も使用できるプロモコードが1つだけのキャンペーンに適しています(最大128文字)。
  • 生成された文字列 - 数字とラテン記号(10文字)の行。多くのプロモコードを使ったキャンペーンに適しています。
プロモコードでプロモーションを作成した後、プロモーションエディターでプロモコードを生成することができます。プロモコードを複数回生成することができます。手動で入力したコードのアップロードは、エクソーラに電子メールにてオンデマンドで行われます。
お知らせ
クーポンコードは大文字と小文字を区別します。例えば、winter2021WINTER20212つの異なるクーポンです。

地域制限

地域制限はプロモーションキャンペーン全体に適用されます。地域制限は、エクソーラに電子メールにてオンデマンドで適用されます。

プロモコードの特典を入手する

クーポン還元後にユーザーが受け取るアイテムのリストを取得するために、Get promo code rewardsメソッドの呼び出しを実装します。応答でis_selectableパラメータの値に応じて、2つの可能なフローがあります:
  1. 値がis_selectable=true場合は、type=unit要素を持つitemごとにunit_itemsオブジェクトから要素を選択するフォームを表示する必要があります。このフォームでは、ユーザーはunitタイプごとに1つの要素のみを選択します。
応答の例:
Copy
Full screen
Small screen
{
	"bonus": [{
		"item": {
			"sku": "xsollus_gold_edition",
			"name": "Xsollus: Gold Edition",
			"type": "unit",
			"description": null,
			"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
			"unit_items": [{
				"sku": "xsollus_gold_edition_steam",
				"name": "Xsollus: Gold Edition (steam)",
				"type": "game_key",
				"drm_name": "Steam",
				"drm_sku": "steam"
			}, {
				"sku": "xsollus_gold_edition_playstation",
				"name": "Xsollus: Gold Edition (playstation)",
				"type": "game_key",
				"drm_name": "Playstation",
				"drm_sku": "playstation"
			}, {
				"sku": "xsollus_gold_edition_xbox",
				"name": "Xsollus: Gold Edition (xbox)",
				"type": "game_key",
				"drm_name": "XBox",
				"drm_sku": "xbox"
			}, {
				"sku": "xsollus_gold_edition_nintendo_eshop",
				"name": "Xsollus: Gold Edition (nintendo_eshop)",
				"type": "game_key",
				"drm_name": "Nintendo Switch eShop",
				"drm_sku": "nintendo_eshop"
			}]
		},
		"quantity": 1
	}, {
		"item": {
			"sku": "xsollus_bonus_pack_edition",
			"name": "Xsollus: Bonus Pack",
			"type": "unit",
			"description": null,
			"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
			"unit_items": [{
				"sku": "xsollus_bonus_pack_edition_steam",
				"name": "Xsollus: Bonus Pack (steam)",
				"type": "game_key",
				"drm_name": "Steam",
				"drm_sku": "steam"
			}, {
				"sku": "xsollus_bonus_pack_edition_origin",
				"name": "Xsollus: Bonus Pack (origin)",
				"type": "game_key",
				"drm_name": "Origin",
				"drm_sku": "origin"
			}, {
				"sku": "xsollus_bonus_pack_edition_drmfree",
				"name": "Xsollus: Bonus Pack (drmfree)",
				"type": "game_key",
				"drm_name": "DRM Free",
				"drm_sku": "drmfree"
			}, {
				"sku": "xsollus_bonus_pack_edition_gog",
				"name": "Xsollus: Bonus Pack (gog)",
				"type": "game_key",
				"drm_name": "GOG",
				"drm_sku": "gog"
			}, {
				"sku": "xsollus_bonus_pack_edition_rockstar",
				"name": "Xsollus: Bonus Pack (rockstar)",
				"type": "game_key",
				"drm_name": "Rockstar Games Launcher",
				"drm_sku": "rockstar"
			}]
		},
		"quantity": 3
	}],
	"discount": {
		"percent": null
	},
	"is_selectable": true
  1. is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

プロモーションコードを還元する

プロモーションコードを使用して、Redeem promo codeメソッドの呼び出しを実装します。is_selectableパラメータ値に応じて、Get promo code rewardsメソッド応答で2つの可能なフローがあります:
  1. is_selectable=trueの場合、Redeem promo codeメソッドを呼び出すときは、次の形式でselected_unit_itemsオブジェクトを渡す必要があります:
Copy
Full screen
Small screen
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

応答の例:

Copy
Full screen
Small screen
{
  {
    "items": [
    {
      "sku": "xsollus_gold_edition_steam",
      "name": "Xsollus: Gold Edition (steam)",
      "type": "game_key",
      "description": null,
      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
      "attributes": [],
      "is_free": true,
      "groups": [],
      "price": null,
      "virtual_prices": [],
      "drm_name": "Steam",
      "drm_sku": "steam",
      "has_keys": false,
      "is_pre_order": true,
      "release_date": null,
      "quantity": 1
    },
    {
      "sku": "xsollus_bonus_pack_edition_origin",
      "name": "Xsollus: Bonus Pack (origin)",
      "type": "game_key",
      "description": null,
      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
      "attributes": [],
      "is_free": true,
      "groups": [],
      "price": null,
      "virtual_prices": [],
      "drm_name": "Origin",
      "drm_sku": "origin",
      "has_keys": false,
      "is_pre_order": true,
      "release_date": null,
      "quantity": 3
    }
    ]
}
  1. is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2024年11月8日

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

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