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

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

また、パーソナライズされたプロモーションの実施、つまり特定のユーザーに対するキャンペーンを設定することも可能です。割引のプロモーションキャンペーンボーナスのプロモーションキャンペーンにのみ可能です。

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

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

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

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

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

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

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

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

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

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

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

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

  1. パブリッシャーアカウントであなたのプロジェクトを開きます。
  2. サイドメニューでストアをクリックしてプロモーションに移動します。
  3. プロモーションを作成するをクリックします。
  4. 以下のパラメータを指定します:
    1. プロモーションタイトルを入力します。
    2. クーポンをプロモーションタイプとして選択します。
  5. ユーザーがクーポンを引き換えるときに受け取る特典を選択します。利用可能なオプション:
  6. 以下を追加します:
    1. External IDに含まれるプロモーション識別子
    2. ユーザーがクーポンを引き換えるときに受け取るボーナスアイテム。
    3. アイテムのタイプと金額。
  7. 次へをクリックします。
  8. 総引き換え回数とユーザーごとの引き換え回数を指定します。
  9. キャンペーンの開始日と終了日を設定します。
  10. 次へをクリックします。
  11. 設定を確認し、保存して終了をクリックします。

Note
プロモーションのボーナスや条件は、プロモーションが開始されると変更することはできません。

  1. サイドメニューでストアをクリックしてプロモーションに移動します。
  2. プロモーションを選択して•••メニューボタンをクリックするとメニューが表示され、プランを編集をクリックします。
  3. コードタブに移動します。
  4. クーポンを生成する方法を指定します。
  5. クーポンコードを生成するか、手動で入力します。
  6. プロモーションを有効にします。

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

Redeem coupon codeメソッドの呼び出しを実装して、クーポンを利用します。Get coupon rewardsメソッド応答でのis_selectableパラメータ値に応じて、2つの可能なフローがあります:

  1. is_selectable=trueの場合、Redeem coupon 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の場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

クーポン特典を入手する

クーポン還元後にユーザーが受け取るアイテムのリストを取得するために、Get coupon 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_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

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

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

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

  1. プロモーションコード販促キャンペーンをセットアップします
  2. プロモコードの引き換え方法を実装します
  3. プロモコード特典の取得方法を実装します

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

  1. パブリッシャーアカウントであなたのプロジェクトを開きます。
  2. サイドメニューでストアをクリックしてプロモーションに移動します。
  3. プロモーションを作成するをクリックします。
  4. 以下のパラメータを指定します:
    1. プロモーションタイトルを入力します。
    2. プロモーションコードをプロモーションタイプとして選択します。
  5. ユーザーがプロモーションコードを使用した際に受け取るものを選択します:特典なし、カート内の全アイテムの割引、特定アイテムの割引、ボーナスアイテム、またはその組み合わせ。
  6. 割引額を設定します。
  7. 次へをクリックします。
  8. 総引き換え回数とユーザーごとの引き換え回数を指定します。
  9. 次へをクリックします。
  10. キャンペーンの開始日と終了日を設定します。
  11. 次へをクリックします。
  12. 設定を確認し、保存して終了をクリックします。

Note
プロモーションのボーナスや条件は、プロモーションが開始されると変更することはできません。

  1. サイドメニューでストアをクリックしてプロモーションに移動します。
  2. プロモーションを選択して•••メニューボタンをクリックするとメニューが表示され、プランを編集をクリックします。
  3. コードタブに移動します。
  4. プロモーションコードを生成する方法を指定します。
  5. プロモーションコードを生成するか、手動で入力します。
  6. プロモーションを有効にします。

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

プロモーションコードを使用して、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の場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。

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

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

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

ボーナス販促キャンペーンを開始するには:

  1. パブリッシャーアカウントであなたのプロジェクトを開きます。
  2. サイドメニューでストアをクリックしてプロモーションに移動します。
  3. プロモーションを作成するをクリックします。
  4. 以下のパラメータを指定します:
    1. プロモーションタイトルを入力します。
    2. ボーナスをプロモーションタイプとして選択します。
  5. 販促品を選択します。
  6. ユーザーが販促品を購入した際に付与されるアイテムを選択します。
  7. 次へをクリックします。
  8. 特定のユーザーに対してプロモーションを設定したい場合、特定のユーザーに対してのみプロモーションをトリガーするトグルをオンにスイッチして条件を指定します。
  9. 次へをクリックします。
  10. キャンペーンの開始日と終了日を設定します。
  11. 次へをクリックします。
  12. 設定を確認して保存して終了をクリックします。

Note
プロモーションのボーナスや条件は、プロモーションが開始されると変更することはできません。

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

割引販促キャンペーン

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

パブリッシャーアカウント経由で割引販促キャンペーンをセットアップする

割引販促キャンペーンを開始するには:

  1. パブリッシャーアカウントであなたのプロジェクトを開きます。
  2. サイドメニューでストアをクリックしてプロモーションに移動します。
  3. プロモーションを作成するをクリックします。
  4. 以下のパラメータを指定します:
    1. プロモーションタイトルを入力します。
    2. 割引をプロモーションタイプとして選択します。
  5. 1つまたは複数のアイテムに適用される割引を設定します。
  6. 割引額を設定します。
  7. 次へをクリックします。
  8. 特定のユーザーに対してプロモーションを設定したい場合、特定のユーザーに対してのみプロモーションをトリガーするトグルをオンにスイッチして条件を指定します。
  9. 次へをクリックします。
  10. キャンペーンの開始日と終了日を設定します。
  11. 次へをクリックします。
  12. 設定を確認して保存して終了をクリックします。

Note
プロモーションのボーナスや条件は、プロモーションが開始されると変更することはできません。

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

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

割引プロモーションを使用するには、プロモーションメソッドグループのDiscountサブセクションのメソッドを使用することができます。

APIメソッド経由でプロモーションを作成するには:

  1. 必要なパラメータを指定してCreate discount promotion for itemメソッドを呼び出します。
  2. “is_enabled”:trueパラメータがあるUpdate item promotionメソッドを呼び出し、プロモーションを有効にします。

API経由でプロモーションを編集するには、新しいプロモーションパラメータがあるUpdate item promotion>メソッドを呼び出します。また、Activeステータスを持つプロモーションを編集することもできます。

APIメソッドを使用して割引プロモーションを作成または編集する場合は、次のこともできます:

割引プロモーションの条件をカスタマイズする

いくつかの条件を満たした場合にのみ適用される割引を設定することができます。例えば:

  • カートの確定額に適用される割引
  • カートに十分なアイテムがある場合にのみ適用される割引
  • ユーザーが別のアイテムを購入した場合の1つのアイテムの割引
条件付きの割引プロモーションを設定するには、アカウントマネージャーにお問い合わせください。

進捗状況
ご意見ありがとうございました!
最終更新日: 2022年6月21日

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

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