プロモーションコード
どのように動作するか
プロモコードは、新規ユーザーを獲得し、売上を増加させるためのマーケティングツールです。プロモコードを有効にしてカート内のアイテムの支払いをした後、ユーザーは報酬のオプションのいずれかを受け取ります：
- カートに適用される割引
- ボーナスアイテム：
- 仮想通貨パッケージ
- ゲームキー
- バンドルまたは非更新サブスクリプションを含む仮想アイテム
主な機能：
- 特典として、割引のみ、ボーナスアイテムのみ、またはその両方を選択します。
- キャンペーンでプロモーションコードを使用できる回数を決定します。
- 1つのキャンペーンの1人のユーザーのプロモーションコードの利用回数を確認します。
- オンデマンドで地域制限を設定します。
- プロモーションコードを複数回生成します。
- プロモーションコードを使用した後、カート内のアイテムのリストを変更します。
- プロモーションコードを使用した後にカートに追加されたアイテムに割引を適用します。
制限：
- ユーザーは1つのカートに1つのプロモーションコードのみを適用できます。
- ユーザーは、カートにアイテムを追加した後でのみ、カートUIでプロモーションコードをアクティブ化できます。
- 割引またはボーナスを取得するには、ユーザーはカート内のアイテムの代金を支払う必要があります。
- プロモーションコードに地域別の販売制限のあるアイテムが含まれている場合、制限された地域のユーザーは、このプロモーションコードにリンクされているアイテムを取得できません。
ユーザーフロー：
- ユーザーはカートUIの対応するフィールドにプロモーションコードを入力します。
- カートの合計が再計算されます。
- ユーザーはカートの料金を支払い、カートでプロモーションコードを還元します。
- プロモーションコードにいくつかのボーナスアイテムが含まれている場合、それらは次のいずれかの方法でユーザーに配信されます：
- インベントリに直接（仮想アイテムまたは仮想通貨パッケージ）
- メール経由（ゲームキー）
- 資格システムに直接（ゲームキー）
使用に適した方
- 次の製品のいずれか（または両方）を統合したパートナー：
- プロモーションコードを利用して売上を増やしたいパートナー。
入手方法
前提条件
- エクソラパブリッシャーアカウントを作成する。
- プロジェクトにストアを接続する。
統合フロー
プロモーションコードでキャンペーンを設定する
- パブリッシャーアカウントでストア > プロモーションに移動して、プロモーションを作成します。
- 必要なパラメータを指定します：
- プロモーションタイトルを入力します。
- プロモーションコードをプロモーションタイプとして選択します。
- プロモーションコードの割引額を選択します。
- ユーザーがプロモーションコードを利用したときに受け取るボーナス商品を選択します。利用可能なオプション：
- 報酬はありません。
- 仮想通貨パッケージ。
- ゲームキー。
- 仮想アイテム（1つまたは複数、バンドルや非更新サブスクリプションを含む）。
- 総償還数とユーザー1人あたりの償還数を決定します。
- キャンペーンの開始日と終了日を設定します。
- 設定を確認して、プロモーションを保存します。
- プロモーション編集メニューに移動します。
- コードメニューで、プロモーションコードの生成方法を選択します。
- プロモーションコードを生成するか、手動で入力します。
- 変更を保存します。
- プロモーションを有効にします。
仮想通貨をパッケージにしたプロモーションコード
仮想通貨パッケージのプロモーションコードには、通貨パッケージを指定する必要があります。仮想通貨パッケージを作成するには：
- 仮想通貨モジュールの設定に移動し、以下のパラメータを指定します：
- イメージ
- SKU
- 通貨名
- 仮想通貨の1単位の価格
- デフォルトの通貨
- 必要な数の通貨パッケージを作成し、それぞれに以下のパラメータを指定します：
- イメージ
- SKU
- 名前
- 説明
- 使用済みの通貨
- パッケージ内の通貨の量
- 価格
- デフォルトの通貨
- ストアでの通貨パッケージの表示を有効にします。
ゲームキー付きのプロモーションコード
ゲームキーのプロモコードには、ゲームキーのSKUとDRMの選択方法を指定する必要があります。選択肢は2つあります：
- すでに設定されているDRMのプロモコードを生成します。プロモコードを生成する際にパラメータを設定します。
- プロモコードを使用している場合は、DRMを選択します。
仮想アイテムを使ったプロモーションコード
仮想アイテムのプロモーションコードには、仮想アイテムのSKUとその数量を指定する必要があります。バンドルや非更新サブスクリプションを含む1つのプロモーションコードに対して異なるSKUを持つ1つまたは複数のアイテムを選択することができます。
プロモーションコードを生成する
キャンペーンには、1つまたは複数のプロモコードが含まれている場合があります。プロモコードの形式には2つのオプションがあります：
- 手動で入力された文字列 - 何度も使用できるプロモコードが1つだけのキャンペーンに適しています（最大128文字）。
- 生成された文字列 - 数字とラテン記号（10文字）の行。多くのプロモコードを使ったキャンペーンに適しています。
Note
クーポンコードは大文字と小文字を区別します。例えば、
winter2021とWINTER20212つの異なるクーポンです。地域制限
地域制限はプロモーションキャンペーン全体に適用されます。地域制限は、エクソラに電子メールにてオンデマンドで適用されます。
プロモコードの特典を入手する
クーポン還元後にユーザーが受け取るアイテムのリストを取得するために、is_selectableパラメータの値に応じて、2つの可能なフローがあります：
- 値が
is_selectable=true場合は、type=unit要素を持つitemごとにunit_itemsオブジェクトから要素を選択するフォームを表示する必要があります。 このフォームでは、ユーザーはunitタイプごとに1つの要素のみを選択します。
Copy
- http
{
"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": trueis_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
プロモーションコードを還元する
プロモーションコードを使用して、is_selectableパラメータ値に応じて、
is_selectable=trueの場合、Redeem promo code メソッドを呼び出すときは、次の形式でselected_unit_itemsオブジェクトを渡す必要があります：
Copy
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}応答の例：
Copy
- http
{
{
"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
}
]
}is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
この記事は役に立ちましたか？
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。このページを評価する
このページを評価する
答えたくない
ご意見ありがとうございました！
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
