设置促销活动

将商店集成到游戏后，您可以设置优惠券、促销码、奖励或折扣促销活动以吸引新用户，提升销量。

您也可以开展个性化促销活动，即针对指定用户设置活动。您可以设置促销活动中可用于指定用户的商品数。此功能仅适用于折扣促销活动和奖励促销活动。

注意
仅可对登录管理器产品使用个性化目录。

如已集成登录管理器产品，设置针对用户的个性化促销活动前请进行以下操作：

  1. 为项目设置用户属性。
  2. 在登录管理器部分设置用户属性机制。

属性是以键值对形式存储的用户特征。通过属性可以：

  • 细分用户
  • 在网页商城中为不同用户群体准备个性化店面。

为确保传输数据的完整性，可在登录管理器中以JSON机制格式设置属性验证规则，并使用Login API方法或Webhook管理用户属性。您还可以在发布商帐户中编辑属性值。详细信息请参阅如何设置用户属性。

优惠券提供在无需购买或使用购物车的情况下发放免费商品的代码。要使用优惠券，用户需在游戏、网站或移动应用中输入券码。之后关联的奖励会发放到用户的物品库。奖励包括：

关于优惠券的详细信息，请参阅优惠券部分。

促销码在结算时对购物车价格应用折扣或向购物车添加免费商品。激活促销码并完成购物车商品的支付后，用户可收到以下奖励之一：

关于促销码的详细信息，请参阅促销码部分。

用户购买促销商品时也可以收到奖励。奖励包括：

通过折扣促销活动可对一个或多个商品设置折扣。可对一个产品应用不限数量的促销活动。折扣不可累加，可以应用于单个商品的价格。可对以下一种或多种商品应用折扣：

关于折扣的详细信息，请参阅折扣促销活动部分。

优惠券促销活动

要启动一个优惠券促销活动：

  1. 设置优惠券促销活动。
  2. 使用按券码兑换优惠券的方法。
  3. 使用获取优惠券奖励的方法。

注：
区域限制应用于整个促销活动。您可以发送邮件给艾克索拉来应用区域限制。

设置优惠券促销活动

  1. 在发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店，然后前往促销活动。
  3. 单击创建促销活动。
  4. 指定以下参数：
    1. 输入促销活动标题。
    2. 选择优惠券促销活动类型。
  5. 选择用户兑换优惠券时收到的奖励。可用选项：
  6. 添加以下内容：
    1. External ID中的促销活动ID。
    2. 用户兑换优惠券时收到的奖励品。
    3. 物品类型和数量。
  7. 单击下一步。
  8. 指定总兑换次数和单个用户的兑换次数。
  9. 设置活动的开始和结束时间。
  10. 单击下一步。
  11. 检查设置，然后单击保存并退出。
注：
促销活动为激活状态时无法对其进行更改。
  1. 在侧边栏中单击商店，然后前往促销活动。
  2. 选择促销活动，单击•••菜单按钮打开菜单，然后单击编辑计划。
  3. 前往活动码选项卡。
  4. 指定优惠券生成方式。
  5. 生成优惠券码或手动输入券码。
  6. 激活促销活动。

按券码兑换优惠券

注：
要调用艾克索拉API，您可以使用针对各游戏引擎和平台的现成SDK：

实现Redeem coupon code方法调用以使用优惠券。根据Get coupon rewards方法相应中的is_selectable参数值，有两种可能的流程：

  1. 如果is_selectable=true，调用Redeem coupon code方法时应用以下格式传入selected_unit_items对象：

Copy
Full screen
Small screen
  • http
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

响应示例：

Copy
Full screen
Small screen
  • 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
  }
  ]
}
  1. 如果is_selectable=false，则不应在请求中传入额外参数。

获取优惠券奖励

注：
要调用艾克索拉API，您可以使用针对各游戏引擎和平台的现成SDK：

请实现Get coupon rewards方法调用以获取用户兑换优惠券后收到的商品的列表。根据响应中的is_selectable参数值，有两种可能的流程：

  1. 如果值为is_selectable=true，则应对于每个具有type=unit元素的item显示从unit_items对象中选择元素的表单。在该表单中，用户对于每种unit类型只能选择一个元素。
响应示例：

Copy
Full screen
Small screen
  • 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
  1. 如果is_selectable=false，则不应在请求中传入额外参数。

促销码促销活动

要启动一个促销码活动：

  1. 设置促销码活动。
  2. 实现促销码的兑换方法。
  3. 实现获取促销码奖励的方法。

设置促销码促销活动

  1. 在发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店，然后前往促销活动。
  3. 单击创建促销活动。
  4. 指定以下参数：
    1. 输入促销活动标题。
    2. 选择促销码促销活动类型。
  5. 选择用户兑换促销码时收到的东西：无奖励、对购物车全部商品的折扣、对指定商品的折扣、奖励品或以上的组合。
  6. 选择折扣量。
  7. 单击下一步。
  8. 指定总兑换次数和单个用户的兑换次数。
  9. 单击下一步。
  10. 设置活动的开始和结束日期。
  11. 单击下一步。
  12. 检查设置，然后单击保存并退出。
注：
促销活动为激活状态时无法对其进行更改。
  1. 在侧边栏中单击商店，然后前往促销活动。
  2. 选择促销活动，单击•••菜单按钮打开菜单，然后单击编辑计划。
  3. 前往活动码选项卡。
  4. 指定促销码生成方式。
  5. 生成促销码或手动输入券码。
  6. 激活促销活动。

兑换促销码

注：
要调用艾克索拉API，您可以使用针对各游戏引擎和平台的现成SDK：

实现Redeem promo code方法调用以使用促销码。根据is_selectable参数值，Get promo code rewards方法响应中有两种可能的流程：

  1. 如果is_selectable=true，调用Redeem promo code方法时应用以下格式传入selected_unit_items对象：

Copy
Full screen
Small screen
  • http
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

响应示例：

Copy
Full screen
Small screen
  • 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
    }
    ]
}
  1. 如果is_selectable=false，则不应在请求中传入额外参数。

获取促销码奖励

注：
要调用艾克索拉API，您可以使用针对各游戏引擎和平台的现成SDK：

请实现Get promo code rewards方法调用以获取用户兑换促销码后收到的商品的列表。根据响应中的is_selectable参数值，有两种可能的流程：

  1. 如果值为is_selectable=true，则应对于每个具有type=unit元素的item显示从unit_items对象中选择元素的表单。在该表单中，用户对于每种unit类型只能选择一个元素。
响应示例：

Copy
Full screen
Small screen
  • 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
  1. 如果is_selectable=false，则不应在请求中传入额外参数。

奖励促销活动

要启动一个奖励促销活动：

  1. 在发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店，然后前往促销活动。
  3. 单击创建促销活动。
  4. 指定以下参数：
    1. 输入促销活动标题。
    2. 选择奖励促销活动类型。
  5. 选择促销商品。
  6. 选择购买促销商品时发放给用户的奖励品。
  7. 单击下一步。
  8. 如希望促销活动仅适用于首次购买的用户，请将仅对首购用户触发促销活动开关设置为开。一位用户可使用促销活动的限制次数和仅对特定用户触发促销活动开关将自动启用并将创建一组促销活动触发条件。如有需要，可以添加更多条件。
  9. 如要针对特定用户设置促销活动，请将仅对特定用户触发促销活动开关设置为开并指定相关条件。
  10. 如要限制促销活动对指定用户的适用次数，请将一位用户可使用促销活动的限制次数开关切换为开并指定次数。
  11. 单击下一步。
  12. 设置活动的开始和结束日期。
  13. 单击下一步。
  14. 检查设置，然后单击保存并退出。

注：
促销活动为激活状态时无法对其进行更改。
  1. 在侧边栏中单击商店，然后前往促销活动。
  2. 选择促销活动，单击•••菜单按钮打开菜单并单击编辑计划。
  3. 激活促销活动。

折扣奖励促销活动

注：
不能对折扣促销活动应用区域限制。

通过发布商帐户设置折扣促销活动

要启动一个折扣促销活动：
  1. 在发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店。
  3. 单击促销活动 > 创建促销活动。
  4. 指定以下参数：
    1. 输入促销活动标题。
    2. 选择折扣促销活动类型。
  5. 设置应用于一个或多个商品的折扣。
  6. 设置折扣量。
  7. 单击下一步。
  8. 如希望促销活动仅适用于首次购买的用户，请将仅对首购用户触发促销活动开关设置为开。一位用户可使用促销活动的限制次数和仅对特定用户触发促销活动开关将自动启用并将创建一组促销活动触发条件。如有需要，可以添加更多条件。
  9. 如要针对特定用户设置促销活动，请将仅对特定用户触发促销活动开关设置为开并指定相关条件。
  10. 如要限制促销活动对指定用户的适用次数，请将一位用户可使用促销活动的限制次数开关切换为开并指定次数。
  11. 单击下一步。
  12. 设置活动的开始和结束日期。
  13. 单击下一步。
  14. 检查设置，然后单击保存并退出。
注：
促销活动为激活状态时无法对其进行更改。
  1. 在侧边栏中单击商店，然后前往促销活动。
  2. 选择促销活动，单击•••菜单按钮打开菜单并单击编辑计划。
  3. 激活促销活动。

通过API设置折扣促销活动

要使用折扣促销活动，可使用Promotions方法组Discount子部分下的方法。

要通过API方法创建促销活动：

  1. 用要求的参数调用Create discount promotion for item方法。
  2. 用“is_enabled”:true参数调用Update item promotion方法以激活促销活动。

要通过API编辑促销活动，请使用新促销活动参数调用Update item promotion方法。您也可以编辑状态为Active的促销活动。

通过API方法创建或编辑折扣促销活动时，您还可以：

您的进度
感谢您的反馈！
上次更新时间: 2024年1月22日

发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈！