优惠券

运行机制

优惠券促销活动是获取新用户和增加销量的营销工具。使用优惠券的玩家能获得优惠券所关联的奖励。奖励包括：

虚拟货币套餐
游戏密钥
虚拟物品

每个优惠券都有一个券码。要使用优惠券，用户需在游戏、网站或移动应用中输入券码。

主要功能：

指定一个活动中优惠券的总可兑换次数。
指定一个活动中一个用户的优惠券可兑换次数。
多次生成优惠券码。
对与优惠券关联的促销活动和商品应用区域销售限制。

限制：

对于关联游戏密钥的优惠券，玩家兑换优惠券后会通过邮件收到一个游戏密钥。如活动已没有剩余游戏密钥，则玩家使用优惠券的请求会被拒绝。
如果优惠券包含具有区域限制的促销，则来自限制区域的用户将无法兑换优惠券。
如果优惠券包含具有区域销售限制的商品，则来自限制区域的用户将无法获得该优惠券关联的商品。

用户侧流程：

用户兑换优惠券。
与该优惠券关联的奖励通过以下方式之一发放给用户：
- 直接发放至物品库（虚拟物品或虚拟货币套餐）
- 通过邮件（游戏密钥）
- 直接发放至权利系统（游戏密钥）。

适用对象

希望借助优惠券促销活动提升销量的合作伙伴。

如何获取

前提条件

创建您的艾克索拉发布商帐户。
将商店连接到项目。

设置优惠券活动

在发布商帐户中打开您的项目，然后前往LiveOps > 促销活动并创建一个促销活动。
指定必需参数：
1. 输入促销活动标题。
2. 选择优惠券作为促销活动类型。
选择用户兑换优惠券时收到的奖励商品：
1. 虚拟货币套餐。
2. 游戏密钥。
3. 虚拟物品（一个或多个，例如套装和时效性商品等。）
指定可兑换的总次数以及每个用户可兑换的次数。
设置活动开始和结束日期。
检查设置并保存促销活动。
前往促销活动编辑菜单。
在活动码菜单中，选择生成优惠券码的方法。
生成优惠券码或手动输入券码。
保存更改。
激活促销活动。

虚拟货币套餐优惠券

对于虚拟货币套餐优惠券，应指定包含的货币套餐。要创建虚拟货币套餐：

前往虚拟货币模块设置，然后指定以下参数：
- 图像
- SKU
- 货币名称
- 一个虚拟货币单位的价格
- 默认货币
创建所需数量的货币套餐，并为每个套餐指定以下参数：
- 图像
- SKU
- 名称
- 描述
- 使用的货币
- 套餐中的货币数量
- 价格
- 默认货币
启用在商店中显示货币套餐。

游戏密钥优惠券

对于游戏密钥优惠券，需指定游戏密钥SKU和DRM信息。有两种方式：

为已设置好的DRM生成优惠券。该参数在生成优惠券时设置。
使用优惠券时选择DRM。

虚拟物品优惠券

对于虚拟物品优惠券，应指定虚拟物品SKU及其数量。可为一个优惠券指定一个物品或SKU不同的多个物品，包括套装和时效性商品等。

生成优惠券

活动可以包含一个或多个优惠券。优惠券格式有两种选择：

手动输入券码 — 适用于只有一个且可重复使用多次的优惠券（最多128个字符）。
生成券码 — 由数字和英文字母组成的券号（10个字符）。适合包含多个优惠券的活动。

您可以在创建优惠券促销后在促销活动编辑器中生成优惠券。您可以多次生成券码。如果要上传手动输入的券码，请将需求通过邮件发送给艾克索拉。

优惠券码区分大小写。例如：winter2021和WINTER2021是两个不同的优惠券。

区域限制

区域限制应用于整个促销活动。如要应用区域限制，请将需求通过邮件发送给艾克索拉。

获取优惠券奖励

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

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

响应示例：

Copy

Full screen

Small screen

 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，则不应在请求中传入额外参数。

按券码兑换优惠券

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

如果is_selectable=true，调用兑换优惠券码方法时应用以下格式传入selected_unit_items对象：

Copy

Full screen

Small screen

1"selected_unit_items": {
2  "unit_1_sku": "selected_unit_item_sku",
3  "unit_2_sku": "selected_unit_item_sku"
4}

响应示例：

Copy

Full screen

Small screen

 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，则不应在请求中传入额外参数。

感谢您的反馈！

我们会查看您的留言并运用它改进用户体验。

上次更新时间: 2025年9月19日

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

运行机制
适用对象
如何获取
前提条件
集成过程
设置优惠券活动
获取优惠券奖励
按券码兑换优惠券

Your browser is not supported. Please try a different browser

优惠券

运行机制

适用对象

如何获取

前提条件

集成过程

设置优惠券活动

虚拟货币套餐优惠券

游戏密钥优惠券

虚拟物品优惠券

生成优惠券

区域限制

获取优惠券奖励

按券码兑换优惠券