クーポン

どのように動作するか

クーポンプロモーションは、新規ユーザーの獲得や売上アップのためのマーケティングツールです。クーポンを利用したプレイヤーは、それに連動した報酬を得ることができます。報酬には以下のものが含まれます:

  • 仮想通貨パッケージ
  • ゲームキー
  • 仮想アイテム

すべてのクーポンにはコードがあります。クーポンを使用するには、ユーザーはゲーム内、ウェブサイト、またはモバイルアプリケーションでそのコードを入力します。

主な機能:

  • 1回のキャンペーンでのクーポン還元数の目安を決めます。
  • 1回のキャンペーンで1ユーザーのクーポン還元数を決めます。
  • クーポンのコードを複数回生成します。
  • クーポンと連動したプロモーションやアイテムの地域別販売制限を適用します。

制限:

  • ゲームキーとクーポンをリンクさせた場合、クーポンを利用したプレイヤーにゲームキーのうち1つがメールで送られます。キャンペーン中に鍵が残っていない場合は、プレイヤーからのクーポン還元のリクエストは拒否されます。
  • クーポンに地域限定のプロモーションが含まれている場合、地域限定のユーザーはクーポンを還元することができません。
  • クーポンに地域限定販売のアイテムが含まれている場合、地域限定のユーザーはこのクーポンと連動したアイテムを入手することができません。

ユーザーフロー:

  1. ユーザーがクーポンを還元します。
  2. クーポンにリンクされている報酬は、次のいずれかの方法でユーザーに配信されます:

入手方法

前提条件

  1. エクソーラアドミンページを作成する
  2. プロジェクトにストアを接続する

統合フロー

  1. クーポンを使った販促キャンペーンを設定する
  2. クーポン報酬を入手するメソッドを利用する
  3. コードによるクーポン還元メソッドを利用する

クーポンを使ったキャンペーンを設定する

  1. パブリッシャーアカウントストア > LiveOpsとプロモーションツールに移動して、プロモーションを作成します。
  2. 必要なパラメータを指定します:
    1. プロモーションタイトルを入力します。
    2. クーポンをプロモーションタイプとして選択します。
  3. ユーザーがクーポンを還元した際に受け取るボーナスアイテムを選択します。
    1. 仮想通貨パッケージ
    2. ゲームキー
    3. 仮想アイテム(1つまたは複数、バンドルや期間限定アイテムを含む)。
  4. 総償還数とユーザー1人あたりの償還数を指定します。
  5. キャンペーンの開始日と終了日を設定します。
  6. 設定を確認し、プロモーションを保存します。
  7. プロモーション編集メニューに移動します。
  8. コードメニューで、クーポンの生成方法を選択します。
  9. クーポンコードを生成するか、手動で入力します。
  10. 変更を保存します。
  11. プロモーションを有効にします。

仮想通貨パッケージのクーポン

仮想通貨パッケージクーポンの通貨パッケージを指定する必要があります。仮想通貨パッケージを作成するには:
  1. 仮想通貨モジュールの設定に移動し、次のパラメーターを指定します:
    • イメージ
    • SKU
    • 通貨名
    • 仮想通貨の1単位の価格
    • デフォルトの通貨
  2. 必要な数の通貨パッケージを作成し、パッケージごとに次のパラメーターを指定します:
    • イメージ
    • SKU
    • 名前
    • 説明
    • 使用済みの通貨
    • パッケージ内の通貨の量
    • 価格
    • デフォルトの通貨
  3. ストアでの通貨パッケージの表示を有効にします。

ゲームキー付きのクーポン

ゲームキーSKUとゲームキークーポンのDRM情報を指定する必要があります。2つのオプションがあります:
  • 既に設定されているDRMのクーポンを生成します。クーポン生成時にパラメータを設定します。
  • クーポン使用時にDRMを選択します。

バーチャルアイテム付きクーポン

仮想アイテムクーポンには、仮想アイテムのSKUとその数量を指定する必要があります。バンドルや期間限定アイテムを含む、1つのクーポンに対して異なるSKUを持つ1つまたは複数のアイテムを選択することができます。

クーポンを生成する

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

地域制限

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

クーポン特典を入手する

クーポン報酬を取得するメソッドのコールを実装し、クーポンを引き換えた後にユーザーが受け取るアイテムのリストを取得します。応答のis_selectableパラメータの値に応じて、2つの可能なフローがあります:
  1. 値がis_selectable=trueの場合は、type=unitの要素を持つitemごとにunit_itemsオブジェクトから要素を選択するフォームを表示する必要があります。このフォームでは、ユーザーはunitタイプごとに1つの要素のみを選択します。
応答の例:
Copy
Full screen
Small screen
 1{
 2	"bonus": [{
 3		"item": {
 4			"sku": "xsollus_gold_edition",
 5			"name": "Xsollus: Gold Edition",
 6			"type": "unit",
 7			"description": null,
 8			"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
 9			"unit_items": [{
10				"sku": "xsollus_gold_edition_steam",
11				"name": "Xsollus: Gold Edition (steam)",
12				"type": "game_key",
13				"drm_name": "Steam",
14				"drm_sku": "steam"
15			}, {
16				"sku": "xsollus_gold_edition_playstation",
17				"name": "Xsollus: Gold Edition (playstation)",
18				"type": "game_key",
19				"drm_name": "Playstation",
20				"drm_sku": "playstation"
21			}, {
22				"sku": "xsollus_gold_edition_xbox",
23				"name": "Xsollus: Gold Edition (xbox)",
24				"type": "game_key",
25				"drm_name": "XBox",
26				"drm_sku": "xbox"
27			}, {
28				"sku": "xsollus_gold_edition_rockstar",
29				"name": "Xsollus: Gold Edition (rockstar)",
30				"type": "game_key",
31				"drm_name": "Rockstar Games Launcher",
32				"drm_sku": "rockstar"
33			}]
34		},
35		"quantity": 1
36	}, {
37		"item": {
38			"sku": "xsollus_bonus_pack_edition",
39			"name": "Xsollus: Bonus Pack",
40			"type": "unit",
41			"description": null,
42			"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
43			"unit_items": [{
44				"sku": "xsollus_bonus_pack_edition_steam",
45				"name": "Xsollus: Bonus Pack (steam)",
46				"type": "game_key",
47				"drm_name": "Steam",
48				"drm_sku": "steam"
49			}, {
50				"sku": "xsollus_bonus_pack_edition_playstation",
51				"name": "Xsollus: Bonus Pack (playstation)",
52				"type": "game_key",
53				"drm_name": "Playstation",
54				"drm_sku": "playstation"
55			}, {
56				"sku": "xsollus_bonus_pack_edition_xbox",
57				"name": "Xsollus: Bonus Pack (xbox)",
58				"type": "game_key",
59				"drm_name": "XBox",
60				"drm_sku": "xbox"
61
62			}]
63		},
64		"quantity": 3
65	}],
66	"is_selectable": true
  1. is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

コードでクーポンを還元する

クーポンを利用するために、クーポンコードを引き換えるメソッドのコールを実装します。クーポン報酬を取得するメソッド応答のis_selectableパラメータ値に応じて、2つの可能なフローがあります:
  1. is_selectable=trueの場合、クーポン報酬を取得するメソッドを呼び出すときは、次の形式でselected_unit_itemsオブジェクトを渡す必要があります:
Copy
Full screen
Small screen
1selected_unit_items:{
2      unit_1_sku: "selected_unit_item_sku",
3      unit_2_sku: "selected_unit_item_sku"
4}

応答の例:

Copy
Full screen
Small screen
 1{
 2  {
 3    "items": [
 4    {
 5      "sku": "xsollus_gold_edition_steam",
 6      "name": "Xsollus: Gold Edition (steam)",
 7      "type": "game_key",
 8      "description": null,
 9      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
10      "attributes": [],
11      "is_free": true,
12      "groups": [],
13      "price": null,
14      "virtual_prices": [],
15      "drm_name": "Steam",
16      "drm_sku": "steam",
17      "has_keys": false,
18      "is_pre_order": true,
19      "release_date": null,
20      "quantity": 1
21    },
22    {
23      "sku": "xsollus_bonus_pack_edition_origin",
24      "name": "Xsollus: Bonus Pack (origin)",
25      "type": "game_key",
26      "description": null,
27      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
28      "attributes": [],
29      "is_free": true,
30      "groups": [],
31      "price": null,
32      "virtual_prices": [],
33      "drm_name": "Origin",
34      "drm_sku": "origin",
35      "has_keys": false,
36      "is_pre_order": true,
37      "release_date": null,
38      "quantity": 3
39  }
40  ]
41}
  1. is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2025年6月18日

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

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!
フィードバックを送信できませんでした
後でもう一度お試しいただくか、doc_feedback@xsolla.comまでお問い合わせください。