販促キャンペーンをセットアップする
ストアをゲームに統合した後、クーポン、プロモーションコード、ボーナス、または割引プロモーションを設定して、新しいユーザーを引き付けて売り上げを増やすことができます。
また、パーソナライズされたプロモーションの実行、つまり特定のユーザーに対するキャンペーンを設定することができます。プロモーションでユーザーが利用できるアイテムの数を設定することができます。これは、割引販促プロモーション キャンペーンとボーナス販促プロモーション キャンペーンでのみ可能です。
すでにログイン製品と統合している場合は、ユーザー向けのパーソナライズプロモーションを設定する前に、以下のステップを従ってください:
- プロジェクトに応じたユーザー属性を設定します。
- ログインセクションでユーザー属性スキーマを設定します。
属性は、キーと値のペアとして保存されるユーザー機能です。属性の力を借りて、以下のことができます:
- ユーザーを小グループに分ける
- ウェブショップのユーザーグループごとに、個人用のストアを用意することができます。
送信データの整合性を確保するために、アドミンページでJSONスキーマ形式の属性検証ルールを設定し、ログインAPIメソッドやウェブフックを使ってユーザー属性を管理することができます。また、アドミンページで属性の値を編集することもできます。詳しくは、ユーザー属性の設定方法を参照してください。
クーポンには、購入やショッピングカートに入れることなく、無料で商品を付与するコードがあります。クーポンを使用するには、ゲーム、ウェブサイト、またはモバイルアプリケーションでコードを入力する必要があります。関連付けられた特典は、ユーザーのインベントリに配信されます。特典は以下の通り:
クーポンについて詳しく情報はクーポン一覧セクションを参照してください。プロモーションコードは、チェックアウトの際にショッピングカートに割引を適用したり、無料のアイテムを追加します。プロモコードを有効にし、カート内のアイテムの代金を支払うと、ユーザーは以下の特典のいずれかを受け取ることができます:
プロモーションについて詳しく情報はプロモーションコード一覧セクションを参照してください。ユーザーは販促品を購入する際にボーナスを受け取ることができます。ボーナスは以下通り:
割引プロモーションは、1つまたは複数の製品に割引を設定することができます。1つの製品に適用されるプロモーションの数は無制限です。割引は累積ではなく、個々のアイテムの代金に適用されます。割引は、以下の項目のうち1つまたは複数に適用されます:
割引について詳しく情報は割引プロモーション一覧セクションを参照してください。クーポン販促キャンペーン
クーポン販促キャンペーンを開始するには:
クーポン販促キャンペーンをセットアップする
- アドミンページであなたのプロジェクトを開きます。
- サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
- 「プロモーションを作成する」をクリックします。
- 以下のパラメータを指定します:
- プロモーションタイトルを入力します。
- クーポンをプロモーションタイプとして選択します。
- ユーザーがクーポンを引き換えるときに受け取る特典を選択します。利用可能なオプション:
- 以下を追加します:
- External IDに含まれるプロモーション識別子
- ユーザーがクーポンを引き換えるときに受け取るボーナスアイテム。
- アイテムのタイプと数量。
- 次へをクリックします。
- 合計引き換え数とユーザーごとの引き換え数を指定します。
- キャンペーンの開始日と終了日を設定します。
- 「次へ」をクリックします。
- 設定を確認し、「保存して終了する」をクリックします。
- サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
- プロモーションを選択し、「•••」メニューボタンをクリックしてメニューを表示し、「プロモーションを編集する」をクリックします。
- 「コード」タブに移動します。
- クーポンの生成方法を指定します。
- クーポンコードを生成するか、手動で入力します。
- プロモーションをアクティブ化にします。
コードでクーポンを引き換える
クーポンを利用するために、クーポンコードを引き換えるメソッドのコールを実装します。クーポン報酬を取得するメソッド応答のis_selectable
パラメータ値に応じて、2つの可能なフローがあります:
is_selectable=true
の場合、クーポン報酬を取得するメソッドを呼び出すときは、次の形式でselected_unit_items
オブジェクトを渡す必要があります:
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
応答の例:
- 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
の場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
クーポン特典を入手する
クーポン報酬を取得するメソッドのコールを実装し、クーポンを引き換えた後にユーザーが受け取るアイテムのリストを取得します。応答のis_selectable
パラメータの値に応じて、2つの可能なフローがあります:
- 値が
is_selectable=true
の場合は、type=unit
の要素を持つitem
ごとにunit_items
オブジェクトから要素を選択するフォームを表示する必要があります。このフォームでは、ユーザーはunit
タイプごとに1つの要素のみを選択します。
- 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_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
is_selectable=false
の場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
プロモーションコード販促キャンペーン
プロモーションコード販促キャンペーンを開始するには:
プロモーションコード販促キャンペーンをセットアップする
- アドミンページであなたのプロジェクトを開きます。
- サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
- 「プロモーションを作成する」をクリックします。
- 以下のパラメータを指定します:
- プロモーションのタイトルを入力します。
- プロモーションタイプとして「プロモーションコード」を選択します。
- ユーザーがプロモーションコードを引き換えたときに受け取るものを選択します:報酬なし、カート内のすべてのアイテムの割引、特定アイテムの割引、ボーナス商品、またはその組み合わせ。
- 割引額を設定します。
- 「次へ」をクリックします。
- 合計引き換え数とユーザーごとの引き換え数を指定します。
- 「次へ」をクリックします。
- キャンペーンの開始日と終了日を設定します。
- 「次へ」をクリックします。
- 設定を確認し、保存終了をクリックします。
- サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
- プロモーションを選択し、「•••」メニューボタンをクリックしてメニューを表示し、「プロモーションを編集する」をクリックします。
- 「コード」タブに移動します。
- プロモーションコードの生成方法を指定します。
- プロモーションコードを生成するか、手動で入力します。
- プロモーションをアクティブ化にします。
プロモーションコードを引き換える
プロモーションコードを使用して、is_selectable
パラメータ値に応じて、プロモーションコード報酬を取得するメソッド応答で2つの可能なフローがあります:
is_selectable=true
の場合、プロモーションコードを引き換えるメソッドを呼び出すときは、次の形式でselected_unit_items
オブジェクトを渡す必要があります:
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
応答の例:
- 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
の場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
プロモコードの特典を入手する
クーポンを引き換えた後にユーザーが受け取るアイテムのリストを取得するために、プロモーションコード報酬を取得するメソッドのコールを実装します。応答のis_selectable
パラメータの値に応じて、2つの可能なフローがあります:
- 値が
is_selectable=true
場合は、type=unit
要素を持つitem
ごとにunit_items
オブジェクトから要素を選択するフォームを表示する必要があります。このフォームでは、ユーザーはunit
タイプごとに1つの要素のみを選択します。
- 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": true
is_selectable=false
の場合、を使用している場合は、リクエストに追加のパラメータを渡すべきではありません。
ボーナス販促キャンペーン
ボーナス付きのプロモーションキャンペーンを開始するには:
- アドミンページでプロジェクトを開きます。
- サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
- 「プロモーションを作成する」をクリックします。
- 以下のパラメータを指定してください:
- プロモーションのタイトルを入力します。
- プロモーションのタイプとして「ボーナス」を選択します。
- プロモーションアイテムを選択します。
- ユーザーがプロモーションアイテムを購入するときに付与されるアイテムを選択します。
- 「次へ」をクリックします。
- 初めて購入したユーザーにのみプロモーションを適用したい場合は、「初めての購入者にのみプロモーションをトリガーする]」トグルを 「オン」に設定します。「一人のユーザーがプロモーションを利用できる回数の制限」と「特定のユーザーのみのプロモーション」のトグルが自動的に有効になり、プロモーションをトリガーするための一連の条件が作成されます。必要に応じて追加の条件を追加します。
- 「次へ」をクリックします。
- キャンペーンの開始日と終了日を設定します。
- 「次へ」をクリックします。
- 設定を確認し、保存終了をクリックします。
- サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
- プロモーションを選択し、「•••」メニューボタンをクリックしてメニューを表示し、「プロモーションを編集する」をクリックします。
- プロモーションをアクティブ化にします。
割引販促キャンペーン
アドミンページ経由で割引販促キャンペーンをセットアップする
割引付きのプロモーション キャンペーンを開始するには:- アドミンページでプロジェクトを開きます。
- サイドバーで「ストア」をクリックします。
- 「プロモーションと報酬 > プロモーションを作成する」をクリックします。
- 以下のパラメータを指定します:
- プロモーションのタイトルを入力します。
- プロモーションのタイプとして「割引」を選択します。
- 1つまたは複数のアイテムに適用される割引を設定します。
- 割引額を設定します。
- 「次へ」をクリックします。
- 初めて購入したユーザーにのみプロモーションを適用したい場合は、「初めての購入者にのみプロモーションをトリガーする]」トグルを 「オン」に設定します。「一人のユーザーがプロモーションを利用できる回数の制限」と「特定のユーザーのみのプロモーション」のトグルが自動的に有効になり、プロモーションをトリガーするための一連の条件が作成されます。必要に応じて追加の条件を追加します。
- 「次へ」をクリックします。
- キャンペーンの開始日と終了日を設定します。
- 「次へ」をクリックします。
- 設定を確認し、保存終了をクリックします。
- サイドメニューで「ストア」をクリックして「プロモーションと報酬」に移動します。
- プロモーションを選択し、「•••」メニューボタンをクリックしてメニューを表示し、「プロモーションを編集する」をクリックします。
- プロモーションをアクティブ化にします。
API経由で割引販促キャンペーンをセットアップする
割引プロモーションを使用するには、プロモーションメソッドグループの割引サブセクションのメソッドを使用することができます。
APIメソッド経由でプロモーションを作成するには:
- 必要なパラメータを指定してアイテムの割引プロモーションを作成するメソッドを呼び出します。
“is_enabled”:true
パラメータがあるアイテムプロモーションを更新するメソッドを呼び出し、プロモーションを有効にします。
API経由でプロモーションを編集するには、新しいプロモーションパラメータがあるアイテムプロモーションを更新するメソッドを呼び出します。また、
APIメソッドを使用して割引プロモーションを作成または編集する場合は、次のこともできます:
- プロジェクト内のすべてのアイテムに割引を構成します。
“items”:null
パラメータをアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。
- 物理的な商品の割引を構成します。物理的な商品のSKUを含む配列をアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。
- 端数の割合値で割引を構成します。端数の割合値がある
discount.percent
パラメータをアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。
- さまざまなタイプのアイテムの割引を構成します。必要なアイテムのSKUを含む配列をアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。
- ゲームの明確なDRMの割引を構成します。必要なDRMのSKUを含む配列を含む配列をアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。
- 指定された期間がない割引プロモーションを構成します。
“date_end”:null
パラメータをアイテムの割引プロモーションを作成するまたはアイテムプロモーションを更新するメソッドに渡します。
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。