販促キャンペーンをセットアップする

ストアをゲームに統合した後、クーポン、プロモーションコード、ボーナス、または割引プロモーションを設定して、新しいユーザーを引き付けて売り上げを増やすことができます。

また、パーソナライズされたプロモーションの実行、つまり特定のユーザーに対するキャンペーンを設定することができます。プロモーションでユーザーが利用できるアイテムの数を設定することができます。これは、割引販促プロモーションキャンペーンとボーナス販促プロモーションキャンペーンでのみ可能です。

ログイン製品のみで、パーソナライズカタログを使用することができます。

すでにログイン製品と統合している場合は、ユーザー向けのパーソナライズプロモーションを設定する前に、以下のステップを従ってください：

プロジェクトに応じたユーザー属性を設定します。
ログインセクションでユーザー属性スキーマを設定します。

属性は、キーと値のペアとして保存されるユーザー機能です。属性の力を借りて、以下のことができます：

ユーザーを小グループに分ける
ウェブショップのユーザーグループごとに、個人用のストアを用意することができます。

送信データの整合性を確保するために、アドミンページでJSONスキーマ形式の属性検証ルールを設定し、ログインAPIメソッドやウェブフックを使ってユーザー属性を管理することができます。また、アドミンページで属性の値を編集することもできます。詳しくは、ユーザー属性の設定方法を参照してください。

クーポンには、購入やショッピングカートに入れることなく、無料で商品を付与するコードがあります。クーポンを使用するには、ゲーム、ウェブサイト、またはモバイルアプリケーションでコードを入力する必要があります。関連付けられた特典は、ユーザーのインベントリに配信されます。特典は以下の通り：

クーポンについて詳しく情報はクーポン一覧セクションを参照してください。

プロモーションコードは、チェックアウトの際にショッピングカートに割引を適用したり、無料のアイテムを追加します。プロモコードを有効にし、カート内のアイテムの代金を支払うと、ユーザーは以下の特典のいずれかを受け取ることができます：

ユーザーのカートに適用される割引
ボーナスアイテム：

仮想通貨パッケージ
バンドルまたは期間限定アイテムを含む仮想アイテム

プロモーションについて詳しく情報はプロモーションコード一覧セクションを参照してください。

ユーザーは販促品を購入する際にボーナスを受け取ることができます。ボーナスは以下通り：

仮想通貨パッケージ
バンドルまたは期間限定アイテムを含む仮想アイテム

割引プロモーションは、1つまたは複数の製品に割引を設定することができます。1つの製品に適用されるプロモーションの数は無制限です。割引は累積ではなく、個々のアイテムの代金に適用されます。割引は、以下の項目のうち1つまたは複数に適用されます：

仮想通貨パッケージ
バンドルまたは期間限定アイテムを含む仮想アイテム

割引について詳しく情報は割引プロモーション一覧セクションを参照してください。

割引、プロモーションコードまたはクーポンのあるキャンペーンでは、仮想通貨パッケージを使用する必要があります。任意の金額の仮想通貨は、ボーナスのあるキャンペーンでのみ使用できます。

クーポン販促キャンペーン

クーポン販促キャンペーンを開始するには：

クーポン販促キャンペーンをセットアップします。
クーポンコードのご利用方法を使用します。
クーポン特典を取得するメソッドを使用します。

地域制限は、キャンペーン全体に適用されます。地域制限の適用については、エクソーラにメールでお問い合わせください。

クーポン販促キャンペーンをセットアップする

アドミンページであなたのプロジェクトを開きます。
サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。

「プロモーションを作成する」をクリックします。

以下のパラメータを指定します：
1. プロモーションタイトルを入力します。
2. クーポンをプロモーションタイプとして選択します。
ユーザーがクーポンを引き換えるときに受け取る特典を選択します。利用可能なオプション：
- 仮想通貨パッケージ
- 仮想アイテム（1つまたは複数、バンドルや期間限定アイテムを含む）。
以下を追加します：
1. External IDに含まれるプロモーション識別子
2. ユーザーがクーポンを引き換えるときに受け取るボーナスアイテム。
3. アイテムのタイプと数量。
次へをクリックします。

合計引き換え数とユーザーごとの引き換え数を指定します。

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

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

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

サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
プロモーションを選択し、「•••」メニューボタンをクリックしてメニューを表示し、「プロモーションを編集する」をクリックします。

「コード」タブに移動します。
クーポンの生成方法を指定します。

クーポンコードを生成するか、手動で入力します。
プロモーションをアクティブ化にします。

コードでクーポンを引き換える

エクソーラAPIを呼び出すには、ゲームエンジンやプラットフォームに対応したSDKの既成のメソッドを利用することができます。

クーポンを利用するために、クーポンコードを引き換えるメソッドのコールを実装します。クーポン報酬を取得するメソッド応答のis_selectableパラメータ値に応じて、2つの可能なフローがあります：

is_selectable=trueの場合、クーポン報酬を取得するメソッドを呼び出すときは、次の形式で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
  }
  ]
}

is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

クーポン特典を入手する

エクソーラAPIを呼び出すには、ゲームエンジンやプラットフォームに対応したSDKの既成のメソッドを利用することができます。

クーポン報酬を取得するメソッドのコールを実装し、クーポンを引き換えた後にユーザーが受け取るアイテムのリストを取得します。応答のis_selectableパラメータの値に応じて、2つの可能なフローがあります：

値が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_rockstar",
				"name": "Xsollus: Gold Edition (rockstar)",
				"type": "game_key",
				"drm_name": "Rockstar Games Launcher",
				"drm_sku": "rockstar"
			}]
		},
		"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_playstation",
				"name": "Xsollus: Bonus Pack (playstation)",
				"type": "game_key",
				"drm_name": "Playstation",
				"drm_sku": "playstation"
			}, {
				"sku": "xsollus_bonus_pack_edition_xbox",
				"name": "Xsollus: Bonus Pack (xbox)",
				"type": "game_key",
				"drm_name": "XBox",
				"drm_sku": "xbox"

			}]
		},
		"quantity": 3
	}],
	"is_selectable": true

is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

プロモーションコード販促キャンペーン

プロモーションコード販促キャンペーンを開始するには：

プロモーションコード販促キャンペーンをセットアップする

アドミンページであなたのプロジェクトを開きます。
サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。

「プロモーションを作成する」をクリックします。

以下のパラメータを指定します：
1. プロモーションのタイトルを入力します。
2. プロモーションタイプとして「プロモーションコード」を選択します。
ユーザーがプロモーションコードを引き換えたときに受け取るものを選択します：報酬なし、カート内のすべてのアイテムの割引、特定アイテムの割引、ボーナス商品、またはその組み合わせ。
割引額を設定します。
「次へ」をクリックします。

合計引き換え数とユーザーごとの引き換え数を指定します。
「次へ」をクリックします。

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

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

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

サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
プロモーションを選択し、「•••」メニューボタンをクリックしてメニューを表示し、「プロモーションを編集する」をクリックします。

「コード」タブに移動します。
プロモーションコードの生成方法を指定します。
プロモーションコードを生成するか、手動で入力します。

プロモーションをアクティブ化にします。

プロモーションコードを引き換える

エクソーラAPIを呼び出すには、ゲームエンジンやプラットフォームに対応したSDKの既成のメソッドを利用することができます。

プロモーションコードを使用して、Redeem promo codeメソッドのコールを実装します。is_selectableパラメータ値に応じて、プロモーションコード報酬を取得するメソッド応答で2つの可能なフローがあります：

is_selectable=trueの場合、プロモーションコードを引き換えるメソッドを呼び出すときは、次の形式で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
    }
    ]
}

is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

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

エクソーラAPIを呼び出すには、ゲームエンジンやプラットフォームに対応したSDKの既成のメソッドを利用することができます。

クーポンを引き換えた後にユーザーが受け取るアイテムのリストを取得するために、プロモーションコード報酬を取得するメソッドのコールを実装します。応答のis_selectableパラメータの値に応じて、2つの可能なフローがあります：

値が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

is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

ボーナス販促キャンペーン

ボーナス付きのプロモーションキャンペーンを開始するには：

アドミンページでプロジェクトを開きます。
サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。

「プロモーションを作成する」をクリックします。

以下のパラメータを指定してください：
1. プロモーションのタイトルを入力します。
2. プロモーションのタイプとして「ボーナス」を選択します。
プロモーションアイテムを選択します。

ユーザーがプロモーションアイテムを購入するときに付与されるアイテムを選択します。
「次へ」をクリックします。

初めて購入したユーザーにのみプロモーションを適用したい場合は、「初めての購入者にのみプロモーションをトリガーする]」トグルを「オン」に設定します。「一人のユーザーがプロモーションを利用できる回数の制限」と「特定のユーザーのみのプロモーション」のトグルが自動的に有効になり、プロモーションをトリガーするための一連の条件が作成されます。必要に応じて追加の条件を追加します。
「次へ」をクリックします。

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

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

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

サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
プロモーションを選択し、「•••」メニューボタンをクリックしてメニューを表示し、「プロモーションを編集する」をクリックします。

プロモーションをアクティブ化にします。

割引販促キャンペーン

割引キャンペーンに地域限定を適用することはできません。

アドミンページ経由で割引販促キャンペーンをセットアップする

割引付きのプロモーションキャンペーンを開始するには:

アドミンページでプロジェクトを開きます。
サイドバーで「ストア」をクリックします。

「プロモーションと報酬 > プロモーションを作成する」をクリックします。

以下のパラメータを指定します：
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
}

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

最終更新日: 2024年11月25日

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

Your browser is not supported. Please try a different browser

人気記事

またはよくある質問を選ぶ:

以下の出典に基づく回答:

ご意見・ご感想をお寄せください（任意）

ご意見・ご感想をお寄せください（任意）

インゲームストア

販促キャンペーンをセットアップする

クーポン販促キャンペーン

クーポン販促キャンペーンをセットアップする

コードでクーポンを引き換える

クーポン特典を入手する

プロモーションコード販促キャンペーン

プロモーションコード販促キャンペーンをセットアップする

プロモーションコードを引き換える

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

ボーナス販促キャンペーン

割引販促キャンペーン

アドミンページ経由で割引販促キャンペーンをセットアップする

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