プロモーションコード
どのように動作するか
プロモーションコードは、新規ユーザーを獲得し、売上を伸ばすためのマーケティングツールです。プロモーションコードを有効にした後、ユーザーは以下の報酬のいずれかを受け取ることができます：
- ユーザーのカートや特定の商品に適用される割引です。
- 一つのボーナスアイテム：
- ゲームキー
- 仮想通貨パッケージ
- バンドルまたは期間限定アイテムを含む仮想アイテム
主な機能：
- 割引のみ、報酬のみ、割引と報酬の両方を選ぶ
- キャンペーン期間中のプロモーションコードの総使用回数の設定
- キャンペーン期間中の1ユーザーに対するプロモーションコードの使用回数の設定
- リクエストに応じて地域制限の設定
- プロモーションコードの複数回生成
- プロモーションコード適用後にボーナスアイテムをカートに入れる
- プロモーションコードを使用した後にアイテムに割引を適用する
制限：
- プロモーションコードはカートに1つだけ適用できます
- 割引や報酬を受けるには、カートに入れた商品の代金を支払う必要があります
- プロモーションコードに地域限定販売のアイテムが含まれている場合、これらのアイテムが限定されている地域のユーザーは、このプロモーションコードを使用してアイテムを受け取ることができません
どのように動作するか
ユーザーフロー：
- ユーザーは、UIの対応するフィールドにプロモーションコードを入力します。
- アイテムのコストを再計算し、ボーナスアイテムを追加します。
- ユーザーが支払いを行うと、プロモーションコードが引き換えられたと見なされます。
- プロモーションコードにボーナスアイテムが含まれている場合、それらは次のいずれかの方法でユーザーに配信されます：
- インベントリに直接配信（仮想アイテムまたは仮想通貨パッケージ）
- メール経由配信（ゲームキー）
- エンタイトルメントシステム（ゲームキー）に直接配信
注意
ゲームまたはゲームのリストに対して、割引、クーポン、プロモーションコード、ボーナスなど、さまざまなタイプのプロモーションを設定することができます。
購入時に1つのゲームまたはゲームのリストに複数のプロモーションが有効な場合、割引は1つずつ項目に適用されます。割引が適用される順番は関係ありません。
例：
ゲームキーの価格は$10です。パブリッシャーアカウントでは、ゲームキーに対して、以下のプロモーションが作成されています：
- ブラックフライデー11月4日から30日まで10％割引の割引キャンペーン
- セール 11月15日から12月15日まで20％割引の割引キャンペーン
- 11月4日から30日まで、5％割引のプロモーションコードを使ったキャンペーン
11月20日にゲームキーを購入した場合、割引キャンペーンとプロモーションコードによるプロモーションコードの両方が有効です。
キーの総額は、(($10 - 10%) - 20%) - 5%で計算され、$6.84になります。
- 割引キャンペーンを適用した結果：
- キャンペーン割引額
- 割引なしの価格
- 割引価格
- ボーナスプロモーションを適用した結果：
- ボーナスアイテム
- ボーナスアイテムの価格ラインの無料値
- プロモーションコードを適用した結果
- プロモーションコードの割引額
- 割引なしの価格
- 割引価格
- ボーナスアイテム
- ボーナスアイテムの価格ラインの無料値
入手方法
前提条件
統合フロー
指定したアイテムで注文を作成するメソッドを使用して1つのキーのクイック購入を実装している場合、ユーザーはカートに移動せずに支払いに進みます。
同時に、エクソーラ側でカートが作成されますが、ユーザーには表示されません。これは、ユーザーの購入に既存のすべての割引を正しく適用し、決済フォームにすべての割引を含む金額を表示するために必要なものです。
プロモーションコードでキャンペーンを設定する
- パブリッシャーアカウントでプロジェクトを開き、LiveOps > プロモーションセクションに移動してプロモーションキャンペーンを作成します。
- 以下のパラメータを指定します：
- プロモーション名を入力します。
- プロモーションタイプとしてプロモーションコードを選択します。
- External IDを作成する — プロモーションを管理するために使用される一意のプロモーション識別子で、特典の受け取りとプロモーションコードの引き換えのメソッドを使用します。
- プロモーションコードの割引率を指定します。割引は、カート全体または特定のアイテムに適用できます。
- ユーザーがプロモーションコードを引き換える時に受け取るボーナスアイテムを選択します：
- 総引き換え回数とユーザーごとの引き換え回数を指定します。
- キャンペーンの期間を指定します。
- 設定を確認し、プロモーションを保存します。
- プロモーション編集メニューに移動します。
- コードタブで、プロモーションコードの生成方法を選択します。
- プロモーションコードを生成するか、手動で入力します。
- 変更内容を保存します。
- プロモーションを有効化にします。
仮想通貨をパッケージにしたプロモーションコード
仮想通貨パッケージでプロモーションコードを作成するには：
- 仮想通貨パッケージを作成します。
- ボーナスアイテムとして、仮想通貨パッケージを指定します。
仮想通貨パッケージを作成するには：
- パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想通貨セクションに移動して仮想通貨を作成します。これを行うには、新しい仮想通貨をクリックして以下のことを追加します：
- パッケージの画像（任意）
- 仮想通貨SKU
- 仮想通貨名
- 仮想通貨1単位の価格
- デフォルト通貨
- 属性（任意）
- 仮想通貨パッケージを作成します。これを行うには、新規パッケージをクリックして以下のことを追加します：
- パッケージの画像（任意）
- パッケージSKU
- パッケージ名
- パッケージの簡単な説明
- パッケージの仮想通貨
- パッケージ内の通貨の量
- 実際通貨または（および）仮想通貨での価格
- デフォルト通貨
- 属性（任意）
- パッケージを作成するをクリックします。
お知らせ
仮想アイテム、仮想通貨、または仮想通貨パッケージを作成した後、アイテムにステータスを設定し、利用可能、利用不可、または部分的に利用可能かを決定できます。
仮想アイテムを使ったプロモーションコード
仮想アイテムでプロモーションコードを作成するには：
- 仮想アイテムを作成します。
- ボーナスアイテムとして、仮想アイテムを指定します。
仮想アイテムを作成するには：
- パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想アイテムセクションに移動して、「アイテムを作成」をクリックします。
- 各アイテムに次を追加します：
- 画像（任意）
- SKU
- アイテムが属するべき1つまたは複数のグループ（任意）
- アイテム名
- アイテムに関する説明
- アイテムプロパティ-消耗品、非消耗品、期間限定品
- 実際通貨または（および）仮想通貨での価格
- アイテムを作成するをクリックします。
お知らせ
仮想アイテム、仮想通貨、または仮想通貨パッケージを作成した後、アイテムにステータスを設定し、利用可能、利用不可、または部分的に利用可能かを決定できます。
ゲームキー付きのプロモーションコード
ゲームキー付きのプロモーションコードを作成するには：- ゲームキーパッケージを作成します。
ボーナスとして作成したゲームキーパッケージのSKUと、購入するプラットフォームの選択方法を指定します：
- プロモーションコードは、すでに設定されている特定のプラットフォームに対して生成されます。
- ユーザーはプロモーションコードを使用する際に、特定のプラットフォームを選択します。
プロモーションコードを生成する
キャンペーンには、1つまたは複数のプロモーションコードが含まれている場合があります。プロモーションコードの形式には2つのオプションがあります：- 手動で入力された文字列 - 何度も使用できるプロモーションコードが1つだけのキャンペーンに適しています（最大128文字）。
- 生成された文字列 - 数字とラテン記号（10文字）の行。多くのプロモーションコードを使ったキャンペーンに適しています。
お知らせ
クーポンコードは大文字と小文字を区別します。例えば、
winter2021とWINTER20212つの異なるクーポンです。地域制限
地域制限はプロモーションキャンペーン全体に適用されます。地域制限は、エクソーラに電子メールにてオンデマンドで適用されます。プロモーションコードの報酬を入手する
クーポンを引き換えた後にユーザーが受け取るアイテムのリストを取得するために、プロモーションコードの報酬を入手メソッドのコールを実装します。応答のis_selectableパラメータの値に応じて、2つの可能なフローがあります：- 値が
is_selectable=true場合は、type=unit要素を持つitemごとにunit_itemsオブジェクトから要素を選択するフォームを表示する必要があります。このフォームでは、ユーザーはunitタイプごとに1つの要素のみを選択します。
Copy
- json
1{
2 "bonus": [
3 {
4 "item": {
5 "sku": "xsollus_gold_edition",
6 "name": "Xsollus: Gold Edition",
7 "type": "unit",
8 "description": null,
9 "image_url": "https://cdn3.xsolla.com/img/misc/images/9541470622d96a821a9a11ea7763ea4c.png",
10 "unit_items": [
11 {
12 "sku": "xsollus_gold_edition_steam",
13 "name": "Xsollus: Gold Edition (steam)",
14 "type": "game_key",
15 "drm_name": "Steam",
16 "drm_sku": "steam"
17 },
18 {
19 "sku": "xsollus_gold_edition_playstation",
20 "name": "Xsollus: Gold Edition (playstation)",
21 "type": "game_key",
22 "drm_name": "Playstation",
23 "drm_sku": "playstation"
24 },
25 {
26 "sku": "xsollus_gold_edition_xbox",
27 "name": "Xsollus: Gold Edition (xbox)",
28 "type": "game_key",
29 "drm_name": "XBox",
30 "drm_sku": "xbox"
31 },
32 {
33 "sku": "xsollus_gold_edition_nintendo_eshop",
34 "name": "Xsollus: Gold Edition (nintendo_eshop)",
35 "type": "game_key",
36 "drm_name": "Nintendo Switch eShop",
37 "drm_sku": "nintendo_eshop"
38 }
39 ]
40 },
41 "quantity": 1
42 },
43 {
44 "item": {
45 "sku": "xsollus_bonus_pack_edition",
46 "name": "Xsollus: Bonus Pack",
47 "type": "unit",
48 "description": null,
49 "image_url": "https://cdn3.xsolla.com/img/misc/images/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
50 "unit_items": [
51 {
52 "sku": "xsollus_bonus_pack_edition_steam",
53 "name": "Xsollus: Bonus Pack (steam)",
54 "type": "game_key",
55 "drm_name": "Steam",
56 "drm_sku": "steam"
57 },
58 {
59 "sku": "xsollus_bonus_pack_edition_origin",
60 "name": "Xsollus: Bonus Pack (origin)",
61 "type": "game_key",
62 "drm_name": "Origin",
63 "drm_sku": "origin"
64 },
65 {
66 "sku": "xsollus_bonus_pack_edition_drmfree",
67 "name": "Xsollus: Bonus Pack (drmfree)",
68 "type": "game_key",
69 "drm_name": "DRM Free",
70 "drm_sku": "drmfree"
71 },
72 {
73 "sku": "xsollus_bonus_pack_edition_gog",
74 "name": "Xsollus: Bonus Pack (gog)",
75 "type": "game_key",
76 "drm_name": "GOG",
77 "drm_sku": "gog"
78 },
79 {
80 "sku": "xsollus_bonus_pack_edition_rockstar",
81 "name": "Xsollus: Bonus Pack (rockstar)",
82 "type": "game_key",
83 "drm_name": "Rockstar Games Launcher",
84 "drm_sku": "rockstar"
85 }
86 ]
87 },
88 "quantity": 3
89 }
90 ],
91 "discount": {
92 "percent": null
93 },
94 "is_selectable": true
95}
is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
プロモーションコードを還元する
プロモーションコードを使用するには、プロモーションコードを引き換えるメソッドのコールを実装します。is_selectableパラメータ値に応じて、プロモーションコードの報酬を取得するメソッド応答で2つの可能なフローがあります：is_selectable=trueの場合、プロモーションコードを引き換えるメソッドを呼び出すときは、次の形式でselected_unit_itemsオブジェクトを渡す必要があります：
Copy
- json
1"selected_unit_items": {
2 "unit_1_sku": "selected_unit_item_sku",
3 "unit_2_sku": "selected_unit_item_sku"
4 }
応答の例：
Copy
- json
1{
2 "items": [
3 {
4 "sku": "xsollus_gold_edition_steam",
5 "name": "Xsollus: Gold Edition (steam)",
6 "type": "game_key",
7 "description": null,
8 "image_url": "https://cdn3.xsolla.com/img/misc/images/9541470622d96a821a9a11ea7763ea4c.png",
9 "attributes": [],
10 "is_free": true,
11 "groups": [],
12 "price": null,
13 "virtual_prices": [],
14 "drm_name": "Steam",
15 "drm_sku": "steam",
16 "has_keys": false,
17 "is_pre_order": true,
18 "release_date": null,
19 "quantity": 1
20 },
21 {
22 "sku": "xsollus_bonus_pack_edition_origin",
23 "name": "Xsollus: Bonus Pack (origin)",
24 "type": "game_key",
25 "description": null,
26 "image_url": "https://cdn3.xsolla.com/img/misc/images/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
27 "attributes": [],
28 "is_free": true,
29 "groups": [],
30 "price": null,
31 "virtual_prices": [],
32 "drm_name": "Origin",
33 "drm_sku": "origin",
34 "has_keys": false,
35 "is_pre_order": true,
36 "release_date": null,
37 "quantity": 3
38 }
39 ]
40}
is_selectable=falseの場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
この記事は役に立ちましたか？
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
