优惠券
运行机制
优惠券促销活动是获取新用户和增加销量的营销工具。使用优惠券的玩家能获得优惠券所关联的奖励。奖励包括：
- 虚拟货币套餐
- 游戏密钥
- 虚拟物品
每个优惠券都有一个券码。要使用优惠券，用户需在游戏、网站或移动应用中输入券码。
主要功能：
- 指定一个活动中优惠券的总可兑换次数。
- 指定一个活动中一个用户的优惠券可兑换次数。
- 多次生成优惠券码。
- 对与优惠券关联的促销活动和商品应用区域销售限制。
限制：
- 对于关联游戏密钥的优惠券，玩家兑换优惠券后会通过邮件收到一个游戏密钥。如活动已没有剩余游戏密钥，则玩家使用优惠券的请求会被拒绝。
- 如果优惠券包含具有区域限制的促销，则来自限制区域的用户将无法兑换优惠券。
- 如果优惠券包含具有区域销售限制的商品，则来自限制区域的用户将无法获得该优惠券关联的商品。
用户侧流程：
- 用户兑换优惠券。
- 与该优惠券关联的奖励通过以下方式之一发放给用户：
- 直接发放至物品库（虚拟物品或虚拟货币套餐）
- 通过邮件（游戏密钥）
- 直接发放至权利系统（游戏密钥）。
适用对象
希望借助优惠券促销活动提升销量的合作伙伴。
如何获取
前提条件
- 创建您的艾克索拉发布商帐户。
- 将商店连接到项目。
集成过程
设置优惠券活动
- 前往发布商帐户中的商店 > LiveOps和推广工具并创建一个促销活动。
- 指定必需参数：
- 输入促销活动标题。
- 选择优惠券作为促销活动类型。
- 选择用户兑换优惠券时收到的奖励商品：
- 指定可兑换的总次数以及每个用户可兑换的次数。
- 设置活动开始和结束日期。
- 检查设置并保存促销活动。
- 前往促销活动编辑菜单。
- 在活动码菜单中，选择生成优惠券码的方法。
- 生成优惠券码或手动输入券码。
- 保存更改。
- 激活促销活动。
虚拟货币套餐优惠券
对于虚拟货币套餐优惠券，应指定包含的货币套餐。要创建虚拟货币套餐：- 前往虚拟货币模块设置，然后指定以下参数：
- 图像
- 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
- http
1{
2 "bonus": [{
3 "item": {
4 "sku": "xsollus_gold_edition",
5 "name": "Xsollus: Gold Edition",
6 "type": "unit",
7 "description": null,
8 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
9 "unit_items": [{
10 "sku": "xsollus_gold_edition_steam",
11 "name": "Xsollus: Gold Edition (steam)",
12 "type": "game_key",
13 "drm_name": "Steam",
14 "drm_sku": "steam"
15 }, {
16 "sku": "xsollus_gold_edition_playstation",
17 "name": "Xsollus: Gold Edition (playstation)",
18 "type": "game_key",
19 "drm_name": "Playstation",
20 "drm_sku": "playstation"
21 }, {
22 "sku": "xsollus_gold_edition_xbox",
23 "name": "Xsollus: Gold Edition (xbox)",
24 "type": "game_key",
25 "drm_name": "XBox",
26 "drm_sku": "xbox"
27 }, {
28 "sku": "xsollus_gold_edition_rockstar",
29 "name": "Xsollus: Gold Edition (rockstar)",
30 "type": "game_key",
31 "drm_name": "Rockstar Games Launcher",
32 "drm_sku": "rockstar"
33 }]
34 },
35 "quantity": 1
36 }, {
37 "item": {
38 "sku": "xsollus_bonus_pack_edition",
39 "name": "Xsollus: Bonus Pack",
40 "type": "unit",
41 "description": null,
42 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
43 "unit_items": [{
44 "sku": "xsollus_bonus_pack_edition_steam",
45 "name": "Xsollus: Bonus Pack (steam)",
46 "type": "game_key",
47 "drm_name": "Steam",
48 "drm_sku": "steam"
49 }, {
50 "sku": "xsollus_bonus_pack_edition_playstation",
51 "name": "Xsollus: Bonus Pack (playstation)",
52 "type": "game_key",
53 "drm_name": "Playstation",
54 "drm_sku": "playstation"
55 }, {
56 "sku": "xsollus_bonus_pack_edition_xbox",
57 "name": "Xsollus: Bonus Pack (xbox)",
58 "type": "game_key",
59 "drm_name": "XBox",
60 "drm_sku": "xbox"
61
62 }]
63 },
64 "quantity": 3
65 }],
66 "is_selectable": true
- 如果
is_selectable=false，则不应在请求中传入额外参数。
按券码兑换优惠券
实现兑换优惠券码方法调用以使用优惠券。根据Get coupon rewards方法相应中的is_selectable参数值，有两种可能的流程：- 如果
is_selectable=true，调用兑换优惠券码方法时应用以下格式传入selected_unit_items对象：
Copy
- http
1selected_unit_items:{
2 unit_1_sku: "selected_unit_item_sku",
3 unit_2_sku: "selected_unit_item_sku"
4}
响应示例：
Copy
- http
1{
2 {
3 "items": [
4 {
5 "sku": "xsollus_gold_edition_steam",
6 "name": "Xsollus: Gold Edition (steam)",
7 "type": "game_key",
8 "description": null,
9 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
10 "attributes": [],
11 "is_free": true,
12 "groups": [],
13 "price": null,
14 "virtual_prices": [],
15 "drm_name": "Steam",
16 "drm_sku": "steam",
17 "has_keys": false,
18 "is_pre_order": true,
19 "release_date": null,
20 "quantity": 1
21 },
22 {
23 "sku": "xsollus_bonus_pack_edition_origin",
24 "name": "Xsollus: Bonus Pack (origin)",
25 "type": "game_key",
26 "description": null,
27 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
28 "attributes": [],
29 "is_free": true,
30 "groups": [],
31 "price": null,
32 "virtual_prices": [],
33 "drm_name": "Origin",
34 "drm_sku": "origin",
35 "has_keys": false,
36 "is_pre_order": true,
37 "release_date": null,
38 "quantity": 3
39 }
40 ]
41}
- 如果
is_selectable=false，则不应在请求中传入额外参数。
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
