プロモーションコード

仕組み

一般情報

プロモーションコードを活用したプロモーションは、購入コンバージョン率の向上や平均客単価の引き上げを目的としたマーケティングツールです。注文に対してプロモーションコードが適用されると、ユーザーは以下を受け取ることができます:

  • 購入品全体または特定のアイテムに適用される割引
  • ボーナスアイテムは以下をを含む:
    • 仮想通貨パッケージ
    • ゲームキー
    • 仮想アイテム
    • バンドル

主な機能:

  • 柔軟なボーナス設定。単一のボーナスタイプ(購入金額の割引、対象アイテムの割引、またはボーナスアイテム)のみを設定することも、それらを自由に組み合わせて設定することも可能です。
  • キャンペーン内での合計引換回数の設定。
  • キャンペーン内でのユーザーごとの引換回数の設定。
  • プロモーションコードの一括生成。
  • プロモーションコードにリンクされたキャンペーンやアイテムに対して、地域制限の適用。
注意
キャンペーンに地域別制限を設定するには、igs@xsolla.comまでお問い合わせください。

制限:

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

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

主な違い:

  • クーポンではボーナスアイテムのみを受け取ることができます。プロモーションコードでは、ボーナスアイテムに加え、特定のアイテムへの割引や、カート全体への割引を提供できます。
  • プロモーションコードは購入時(チェックアウト時)に引き換えられますが、クーポンはユーザーがコードを入力して適用した時点で引き換えられます。

ユーザーフロー

注意
ユーザーは支払いを完了する前であれば、プロモーションコードの適用をキャンセルすることができます。

割引適用のルール

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

例:

仮想アイテムの価格が$10とします。パブリッシャーアカウントでは、仮想アイテムに対して以下のプロモーションが作成されています。

  • ブラックフライデー割引プロモーション:11月4日〜30日まで10%割引
  • セール割引プロモーション:11月15日〜12月15日まで20%割引
  • プロモーションコードによるプロモーション:11月4日〜30日まで5%割引

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

仮想アイテムの総額は、(($10 - 10%) - 20%) - 5% = $10 × (100%-10%) × (100%-20%) × (100%-5%) = $10 × 0.9 × 0.8 × 0.95で計算され、$6.84になります。

プロモーションコードでキャンペーンの設定

注意

ボーナスアイテムを含むプロモーションを作成する場合は、まず対象となるアイテムを設定し、その後にプロモーション設定に進む必要があります。

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

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

プロモーションコードを使用した新規キャンペーンを作成するには:

  1. パブリッシャーアカウントのプロジェクトで、LiveOps > プロモーションセクションに移動します。
  2. プロモーションタブで「プロモーションの作成」をクリックします。
  1. プロモーション名を指定します。
  2. プロモーションタイプのドロップダウンリストで、プロモーションコードを選択します。
  3. External IDフィルドで、APIコールを通じてプロモーションを管理するために使用するプロモーションIDを指定してください。
  4. プロモーションコードの使用時に、任意のアイテムまたはカート全体に割引を適用するには:

    1. 購入に対する割引トグルをオンに設定します。
    1. 割引額フィールドで、割引率を指定します。

  1. プロモーションコードの引き換え時に、特定のアイテムに割引を適用するには:

    1. 選択されたアイテムに対する割引トグルをオンに設定します。
    1. 割引額フィールドで、割引率を指定します。
    1. アイテムタイプドロップダウンリストで、プロモーションコードの引換時に割引対象となるアイテムの種類を選択します。
    1. アイテムを選択します。

  1. プロモーションコードの引換時にボーナスアイテムを付与するには:

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

注意

注文全体または特定のアイテムに対する割引率は、整数で指定する必要があり、99%を超えることはできません。 特定のアイテムに対する割引やボーナスアイテムを設定する際は、以下の点に注意してください:

  • アイテムタイプを選択できるのは、そのタイプのアイテムがプロジェクト内に少なくとも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コールを使用します

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

アプリケーションまたはウェブサイトでプロモーションコード使用の設定

UIでプロモーションコードの使用

  1. アプリケーションUI(カタログまたはカート内)に、以下の要素を実装してください:

    • プロモーションコードの入力フィールド
    • プロモーションコードの報酬や割引を表示するUI要素
    • プロモーションコード報酬の選択フォーム(該当する場合)
    • プロモーションコードを適用するボタン
  2. 以下のクライアントサイドAPIコールを使用して、プロモーションコードのロジックを実装します:

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

プロモーションコード報酬を取得する

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

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

プロモーションコードによる割引やボーナスアイテムを反映した、最新のカタログを表示します。カタログサブセクションのAPIコールを使用してください。promo_codeのリクエストパラメータにプロモーションコードを渡す必要があります。
特定のアイテムを直接購入(カートに追加せず購入)し、プロモーションコードを引き換えます。

指定したアイテムで注文を作成する

promo_codeのリクエストパラメータにプロモーションコードを渡す必要があります。

プロモーションコードを適用し、カートの内容と合計金額を更新(割引を適用およびボーナスアイテムを追加)します。

プロモーションコードを引き換えます。

coupon_codeのリクエストパラメータにプロモーションコードを渡す必要があります。

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

エクソーラを利用して作成されたウェブサイトでのプロモーションコードの使用

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

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

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

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

注意

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

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

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

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