クーポン
どのように動作するか
クーポンプロモーションは、新規ユーザーの獲得や売上アップのためのマーケティングツールです。クーポンを利用したプレイヤーは、それに連動した報酬を得ることができます。報酬には以下のものが含まれます：
- 仮想通貨パッケージ
- ゲームキー
- 仮想アイテム
すべてのクーポンにはコードがあります。クーポンを使用するには、ユーザーはゲーム内、ウェブサイト、またはモバイルアプリケーションでそのコードを入力します。
主な機能：
- 1回のキャンペーンでのクーポン還元数の目安を決めます。
- 1回のキャンペーンで1ユーザーのクーポン還元数を決めます。
- クーポンのコードを複数回生成します。
- クーポンと連動したプロモーションやアイテムの地域別販売制限を適用します。
制限：
- ゲームキーとクーポンをリンクさせた場合、クーポンを利用したプレイヤーにゲームキーのうち1つがメールで送られます。キャンペーン中に鍵が残っていない場合は、プレイヤーからのクーポン還元のリクエストは拒否されます。
- クーポンに地域限定のプロモーションが含まれている場合、地域限定のユーザーはクーポンを還元することができません。
- クーポンに地域限定販売のアイテムが含まれている場合、地域限定のユーザーはこのクーポンと連動したアイテムを入手することができません。
ユーザーフロー：
- ユーザーがクーポンを還元します。
- クーポンにリンクされている報酬は、次のいずれかの方法でユーザーに配信されます：
- インベントリに直接（仮想アイテムまたは仮想通貨パッケージ）
- メール経由（ゲームキー）
- エンタイトルメントシステムに直接（ゲームキー）
使用に適した方
クーポンプロモーションを利用して売り上げを伸ばしたいパートナー。
入手方法
前提条件
- エクソーラパブリッシャーアカウントを作成する。
- プロジェクトにストアを接続する。
統合フロー
クーポンを使ったキャンペーンを設定する
- パブリッシャーアカウントでプロジェクトを開き、LiveOps > プロモーションセクションに移動します。
- 必要なパラメータを指定します：
- プロモーションタイトルを入力します。
- をプロモーションタイプとしてクーポン選択します。
- ユーザーがクーポンを引き換える際に受け取るボーナスアイテムを選択します。
- 合計引き換え回数とユーザーあたりの引き換え回数を指定します。
- キャンペーンの開始日と終了日を設定します。
- 設定を確認し、プロモーションを保存します。
- プロモーション編集メニューに移動します。
- コードメニューで、クーポンの生成方法を選択します。
- クーポンコードを生成するか、手動で入力します。
- 変更を保存します。
- プロモーションを有効化にします。
仮想通貨パッケージのクーポン
仮想通貨パッケージクーポンの通貨パッケージを指定する必要があります。仮想通貨パッケージを作成するには：- 仮想通貨モジュールの設定に移動し、次のパラメータを指定します：
- イメージ
- SKU
- 通貨名
- 仮想通貨の1単位の価格
- デフォルトの通貨
- 必要な数の通貨パッケージを作成し、パッケージごとに次のパラメータを指定します：
- イメージ
- SKU
- 名前
- 説明
- 使用済みの通貨
- パッケージ内の通貨の量
- 価格
- デフォルトの通貨
- ストアでの通貨パッケージの表示を有効にします。
ゲームキー付きのクーポン
ゲームキーSKUとゲームキークーポンのDRM情報を指定する必要があります。2つのオプションがあります：- 既に設定されているDRMのクーポンを生成します。クーポン生成時にパラメータを設定します。
- クーポン使用時にDRMを選択します。
仮想アイテム付きのクーポン
仮想アイテムクーポンには、仮想アイテムのSKUとその数量を指定する必要があります。バンドルや期間限定アイテムを含む、1つのクーポンに対して異なるSKUを持つ1つまたは複数のアイテムを選択することができます。クーポンを生成する
キャンペーンには、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_rockstar",
34 "name": "Xsollus: Gold Edition (rockstar)",
35 "type": "game_key",
36 "drm_name": "Rockstar Games Launcher",
37 "drm_sku": "rockstar"
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_playstation",
60 "name": "Xsollus: Bonus Pack (playstation)",
61 "type": "game_key",
62 "drm_name": "Playstation",
63 "drm_sku": "playstation"
64 },
65 {
66 "sku": "xsollus_bonus_pack_edition_xbox",
67 "name": "Xsollus: Bonus Pack (xbox)",
68 "type": "game_key",
69 "drm_name": "XBox",
70 "drm_sku": "xbox"
71 }
72 ]
73 },
74 "quantity": 3
75 }
76 ],
77 "is_selectable": true
78}
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を押します。
