プロモーションコード

どのように動作するか

プロモコードは、新規ユーザーを獲得し、売上を増加させるためのマーケティングツールです。プロモコードを有効にしてカート内のアイテムの支払いをした後、ユーザーは報酬のオプションのいずれかを受け取ります:

  • カートに適用される割引
  • ボーナスアイテム:
    • 仮想通貨パッケージ
    • ゲームキー
    • バンドルまたは非更新サブスクリプションを含む仮想アイテム

主な機能:

  • 特典として、割引のみ、ボーナスアイテムのみ、またはその両方を選択します。
  • キャンペーンでプロモーションコードを使用できる回数を決定します。
  • 1つのキャンペーンの1人のユーザーのプロモーションコードの利用回数を確認します。
  • オンデマンドで地域制限を設定します。
  • プロモーションコードを複数回生成します。
  • プロモーションコードを使用した後、カート内のアイテムのリストを変更します。
  • プロモーションコードを使用した後にカートに追加されたアイテムに割引を適用します。

制限:

  • ユーザーは1つのカートに1つのプロモーションコードのみを適用できます。
  • ユーザーは、カートにアイテムを追加した後でのみ、カートUIでプロモーションコードをアクティブ化できます。
  • 割引またはボーナスを取得するには、ユーザーはカート内のアイテムの代金を支払う必要があります。
  • プロモーションコードに地域別の販売制限のあるアイテムが含まれている場合、制限された地域のユーザーは、このプロモーションコードにリンクされているアイテムを取得できません。

ユーザーフロー:

  1. ユーザーはカートUIの対応するフィールドにプロモーションコードを入力します。
  2. カートの合計が再計算されます。
  3. ユーザーはカートの料金を支払い、カートでプロモーションコードを還元します。
  4. プロモーションコードにいくつかのボーナスアイテムが含まれている場合、それらは次のいずれかの方法でユーザーに配信されます:
    • インベントリに直接(仮想アイテムまたは仮想通貨パッケージ)
    • メール経由(ゲームキー)
    • 資格システムに直接(ゲームキー)

使用に適した方

  • 次の製品のいずれか(または両方)を統合したパートナー:
  • プロモーションコードを利用して売上を増やしたいパートナー。

入手方法

前提条件

  1. エクソラパブリッシャーアカウントを作成する
  2. プロジェクトにストアを接続する

統合フロー

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

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

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

仮想通貨パッケージのプロモーションコードには、通貨パッケージを指定する必要があります。仮想通貨パッケージを作成するには:

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

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

ゲームキーのプロモコードには、ゲームキーのSKUとDRMの選択方法を指定する必要があります。選択肢は2つあります:

  • すでに設定されているDRMのプロモコードを生成します。プロモコードを生成する際にパラメータを設定します。
  • プロモコードを使用している場合は、DRMを選択します。
1つのプロモコードのために異なるSKUで複数のキーを選択することができます。

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

仮想アイテムのプロモーションコードには、仮想アイテムのSKUとその数量を指定する必要があります。バンドルや非更新サブスクリプションを含む1つのプロモーションコードに対して異なるSKUを持つ1つまたは複数のアイテムを選択することができます。

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

キャンペーンには、1つまたは複数のプロモコードが含まれている場合があります。プロモコードの形式には2つのオプションがあります:

  • 手動で入力された文字列 - 何度も使用できるプロモコードが1つだけのキャンペーンに適しています(最大128文字)。
  • 生成された文字列 - 数字とラテン記号(10文字)の行。多くのプロモコードを使ったキャンペーンに適しています。
プロモコードでプロモーションを作成した後、プロモーションエディターでプロモコードを生成することができます。プロモコードを複数回生成することができます。手動で入力したコードのアップロードは、エクソラに電子メールにてオンデマンドで行われます。

Note
プロモーションコードは大文字と小文字を区別します。例えば、winter2021WINTER2021は2つ異なるプロモーションコードです。

地域制限

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

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

クーポン還元後にユーザーが受け取るアイテムのリストを取得するために、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の場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか?

答えたくない

ご意見ありがとうございました!
最終更新日: 2021年6月25日

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

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