クーポン

仕組み

クーポンキャンペーンは、潜在的なユーザーを製品に引きつけ、売上を促進するために設計されたマーケティングツールです。ユーザーがクーポンを引き換えると、1つまたは複数のボーナスアイテムを受け取ることができます。報酬として、以下のアイテムを使用できます:

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

クーポンには固有のコードが含まれています。クーポンを引き換えるには、ユーザーがゲームクライアント内、またはウェブショップを含むゲームストアでそのコードを入力する必要があります。

主な機能:

  • キャンペーン内での合計引換回数の設定。
  • キャンペーン内でのユーザーごとの引換回数の設定。
  • クーポン用コードの一括生成。
  • キャンペーン、およびクーポンにリンクされたアイテムに対する地域別制限の適用。
注意
キャンペーンに地域別制限を設定するには、igs@xsolla.comまでお問い合わせください。

制限:

  • ゲームキーをボーナスアイテムとして使用する場合、引き換え後にキーがメールでユーザーに送信されるか、エンタイトルメントシステムに送られます。キャンペーンのキーが在庫切れになった場合、ユーザーはクーポンを引き換えることができなくなります。
  • クーポンキャンペーンに地域別制限が適用されている場合、該当する地域のユーザーはクーポンを引き換えることができません。
  • クーポンに地域別制限のあるボーナスアイテムが少なくとも1つ含まれている場合、その地域のユーザーはそのクーポンを使用してアイテムを受け取ることができません。
  1. 例: クーポンのボーナスとして「盾」と「剣」が提供されるとします。「盾」には地域別制限があり、米国でのみ購入可能です。米国以外のユーザーがクーポンコードを入力した場合、プロモーションコードを検証するまたはクポーンコードを引き換えるAPIコールに対するレスポンスとしてエラーが返されます。ユーザーは、クーポンに含まれるどのアイテムも取得することができません。
注意

ストアには、プロモーションコードプロモーションを設定することもできます。

主な違い:

  • クーポンではボーナスアイテムのみを受け取ることができます。プロモーションコードでは、ボーナスアイテムに加え、特定のアイテムへの割引や、カート全体への割引を提供できます。

  • プロモーションコードは購入時(チェックアウト時)に引き換えられますが、クーポンはユーザーがコードを入力して適用した時点で引き換えられます。

ユーザーフロー:

  1. 認証されたユーザーがストアに移動します。
  2. ユーザーがクーポンコードを入力します。
  3. エクソーラが、そのクーポンで利用可能なボーナスアイテムのリストを返します(任意)。
  4. ユーザーがボーナスを選択します(任意)。
  5. ユーザーがクーポンを引き換えます。
  6. クーポンにリンクされたアイテムは、通常の購入時と同様の方法でユーザーに付与されます。

クーポンキャンペーンのセットアップ

前提条件

クーポンキャンペーンを設定する前に、ボーナスとして発行されるアイテムをあらかじめ設定しておく必要があります。

パブリッシャーアカウントのプロジェクト内で手動でアイテムを作成するには、アイテムカタログ > すべてのアイテムセクションに移動します。この方法や、その他のアイテム作成方法に関する詳細は、ドキュメントのアイテムカタログセクションでご確認いただけます。

パブリッシャーアカウントでのセットアップ

クーポンキャンペーンを作成するには:

  1. パブリッシャーアカウントのプロジェクトで、LiveOps > プロモーションセクションに移動します。
  2. プロモーションタブで「プロモーションの作成」をクリックします。
  1. プロモーションの主なパラメータを指定します:
    1. プロモーション名を指定します。
    1. プロモーションタイプのドロップダウンリストで、クーポンを選択します。
    1. External IDフィールドに、APIコールを介してプロモーションを管理するために使用するプロモーションIDを指定します。
    1. ボーナスアイテムを選択 ドロップダウンリストで、ユーザーがクーポンを引き換える際に付与されるアイテムのタイプを選択します。
注意
アイテムタイプを選択できるのは、そのタイプのアイテムがプロジェクト内に少なくとも1つ作成されている場合のみです。

    1. クーポンの引換時にユーザーに付与されるアイテムを選択します。
    1. 仮想アイテムについては、各アイテムの数量を指定してください。
    1. ゲームキーについては、プラットフォームを決定するタイミングを指定します:
      • 特定のプラットフォーム(Steamなど)を事前に割り当てるには、DRM選択のタイプドロップダウンリストからコード生成時にDRMを選択するを選択します。次に、DRMドロップダウンリストからプラットフォームを選択してください。
      • ユーザーに選択させる場合DRM選択のタイプドロップダウンリストから引換時にプレイヤーがDRMを選択するを選択します。

注意

ボーナスとして、異なる種類のアイテムを選択できます。アイテムタイプを切り替えるには、ボーナスアイテムを選択フィールドを使用してください。選択されたすべてのアイテムの情報は、ボーナスアイテムリストエリアに表示されます。

    1. 次へ」をクリックします。
  1. クーポンの引き換え制限を設定します:
    1. キャンペーン内の全ユーザーを通じたクーポン合計引換回数を制限するには、クーポン合計引換回数を制限するトグルをオンに設定し、ユーザーあたりの最大引換回数を指定してください。
    1. キャンペーン内で1人のユーザーが引き換え可能なクーポンの数を制限するには、ユーザーあたりの合計引換回数を制限するトグルをオンに設定し、ユーザーあたりの最大引換回数を指定してください。
    1. 任意のユニックなクーポンコードを全ユーザーで引き換えられる回数を制限するには、固有クーポンコードの引換回数を制限するトグルをオンに設定し、そのクーポンの最大引換回数を指定してください。
    1. 次へ」をクリックします。
  1. キャンペーンの有効期間を指定します:タイムゾーン、開始日、終了日。終了日のないキャンペーンを作成する場合は、終了日なしチェックボックスをオンにしてください。
  2. 次へ」をクリックします。
  3. キャンペーンの設定内容を確認します。
  4. 保存して終了する」をクリックします。

キャンペーンにクーポンコードを追加するには:

  1. パブリッシャーアカウントのプロジェクトで、LiveOps > プロモーションセクションに移動します。
  2. クーポンプロモーションの行にある「•••」をクリックし、ドロップダウンリストから「プロモーションを編集」を選択してください。
  1. コード」タブに移動します。
  2. コードを自動に生成するには:
    1. コード文字列の形式 ドロップダウンリストで、自動生成を選択します。
    1. 生成するコードの数を指定し、「生成」をクリックします。
  1. コードを手動で追加するには:
    1. コード文字列の形式 ドロップダウンリストで、手動入力を選択します。
    1. クーポンコードを入力し、「作成」をクリックします。
    1. 前のステップを繰り返し、必要な数のコードを追加します。
  1. コードが含まれたCSVファイルをダウンロードします(任意)。
注意

クーポンコードは大文字と小文字を区別します。例えば、winter123WINTER123は別のクーポンとして扱われます。

キャンペーンには、新しいコードを何度でも無制限に追加できます。ただし、追加されるコードの総数は50,000件を超えないようにしてください。

生成した大量のコードをアップロードする必要がある場合は、igs@xsolla.comまでお問い合わせください。

キャンペーンをユーザーが利用できるようにするには、キャンペーンをアクティブ化する必要があります。これを行うには:

  1. パブリッシャーアカウントのプロジェクトで、LiveOps > プロモーションセクションに移動します。
  2. クーポンプロモーションの行にある「•••」をクリックし、ドロップダウンリストから「プロモーションを編集」を選択してください。
  3. 右上のドロップダウンリストから、プロモーションをアクティブ化を選択します。

API経由のセットアップ

お知らせ
プロモーションを更新する際に使用するAPIコールのパラメータリストは、プロモーションを取得する API 呼び出しで返されるパラメータリストと一致していません。プロモーションを更新するAPIメソッドを呼び出す際には、以下を指定する必要があります:
  • 必須パラメータ
  • 変更したいパラメータ
  • プロモーション取得コールで返されるその他すべてのパラメータ

API経由でクーポンキャンペーンの設定および管理を行うには、以下のAPIコールを使用します:

タスクAPIコール
クーポンを使用してプロモーションを作成します。クーポンプロモーションを作成する
クーポンを使用してプロモーションをアクティブ化にします。クーポンプロモーションをアクティブ化にする
プロモーションを編集します。新しいプロモーションオプションを使用してクーポンのプロモーションを更新します。プロモーションの編集は、アクティブステータスのプロモーションでも利用できます。
クーポンを使用してプロモーションを非アクティブ化にします。クーポンプロモーションを非アクティブ化にする
無期限のプロモーションをセットアップします。クーポンプロモーションを作成してまたはクーポンプロモーションを更新します。“date_end”: nullパラメータをリストされたコールに渡します。
プロモーションを削除します。クーポンプロモーションを削除する
注意
アクティブなプロモーションを非アクティブ化または削除された場合、ユーザーは当該プロモーションを利用できなくなります。

アプリケーションまたはウェブサイトでのクーポン引き換え設定

独自のUIでクーポン引き換え

ユーザーがアプリケーションやウェブサイト内でクーポンを引き換えられるようにするには:

  1. UIに以下の要素を実装します:

    • クーポンコードを入力するためのフィールド。
    • クーポンの報酬を表示するためのフォーム。
    • クーポンコードを引き換えるためのボタン。
  2. 以下のクライアントサイドAPIコールを使用して、クーポンのロジックを実装します:

注意
エクソーラAPIを呼び出すには、ゲームエンジンやプラットフォームに対応したSDKの既成のメソッドを利用することができます。
タスクAPIコール
クーポンが正しいかどうかを確認します。プロモーションコードを確認する
クポーンを引き換えます。クポーンコードを引き換える
クーポンボーナスとしてゲームキーが提供された場合に、ユーザーに表示するゲーム配信プラットフォームのリストを取得します

クーポン報酬を入手する

応答でis_selectable=trueが返された場合、type=unitの各アイテムについて、unit_itemsオブジェクト内の要素を選択するためのフォームを表示する必要があります。このフォームでは、ユーザーは各unitタイプに対して1つの要素のみを選択できます。

type=unitパラメータはゲームキーに対して渡されます。この場合、ユーザーはプラットフォームを選択する必要があります。

注意
キャンペーン内でユーザーがさらに何回クーポンを適用できるかを確認するには、指定したユーザーのクーポン上限を取得するのサーバー側のAPIコールを使用してください。
  1. クーポン引き換え時に、アイテムがユーザーに正しく付与されていることを確認してください。
  1. すでにアプリケーションやウェブサイトにインゲームストアを実装している場合、追加の設定は不要です。クーポンにリンクされたアイテムは、標準的な購入と同じ方法でユーザーに付与されます
注意
ゲームキーは、メールでユーザーに送信されるか、エンタイトルメントシステムに送られます。

エクソーラで作成したウェブサイトでのクーポン引き換え

お知らせ
クーポンとプロモーションコードの引き換え機能を追加できるのはウェブショップテンプレートを使用して作成されたウェブサイトのみです。

ウェブサイトにコード入力フィールドを表示するには:

  1. パブリッシャーアカウントでプロジェクトを開き、ストアフロント > ウェブサイトセクションに移動します。
  2. サイトセクションで、サイトを選択し、「サイトビルダーを開く」をクリックします。
  3. ビルダーのメインエリアで、新しいブロックを追加したい場所を選び、「ブロックを追加」をクリックします。
  4. プロモーションコードブロックを選択します。
  5. ブロックの外観をカスタマイズします(任意):
    • ブロックのヘッダーと説明文を編集します。
    • ブロックにカスタム背景を設定します。
    • ボタンのスタイルを変更します。
    • クーポン引き換えボタンのテキストを編集します。
  6. 変更を適用するには、ウェブサイトを公開します:

    1. サイトビルダーの右上隅にある「公開」をクリックします。
    1. 公開したいページの隣にあるチェックボックスにチェックを入れます。
    1. 公開」をクリックします。

注意

サイトの公開ができない場合は、以下の条件がすべて満たされていることを確認してください:

  • ビルダーに空のセクションがないこと(赤いインジケータで表示される)。
  • エクソーラとのライセンス契約が締結済みであること
  • メインページが公開されているか、公開対象として選択されています。メインページを公開する前に、子ページを公開することはできません。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2026年2月13日

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

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