优惠券

运行机制

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

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

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

主要功能:

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

限制:

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

用户侧流程:

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

适用对象

  • 集成了以下产品(之一或两者)的合作伙伴:
  • 希望通过优惠券促销活动提升销量的合作伙伴。

如何获取

前提条件

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

集成过程

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

设置优惠券活动

  1. 前往发布商帐户中的商店 > 促销活动并创建一个促销活动。
  2. 指定必需参数:
    1. 输入促销活动标题。
    2. 选择优惠券作为促销活动类型。
  3. 选择用户兑换优惠券时收到的奖励品。可用选项:
    1. 虚拟货币套餐
    2. 游戏密钥
    3. 虚拟物品(一个或多个,例如套装和到期性订阅等。)
  4. 指定可兑换的总次数以及每个用户可兑换的次数。
  5. 设置活动开始和结束日期。
  6. 检查设置并保存促销活动。
  7. 前往促销活动编辑菜单。
  8. 活动码菜单中,选择生成优惠券码的方法。
  9. 生成优惠券码或手动输入券码。
  10. 保存更改。
  11. 激活促销活动。

虚拟货币套餐优惠券

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

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

游戏密钥优惠券

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

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

虚拟物品优惠券

对于虚拟物品优惠券,应指定虚拟物品SKU及其数量。可为一个优惠券指定一个物品或SKU不同的多个物品,包括套装和到期性订阅等。

生成优惠券

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

  1. 手动输入券码 — 适用于只有一个且可重复使用多次的优惠券(最多128个字符)。
  2. 生成券码 — 由数字和英文字母组成的券号(10个字符)。适合包含多个优惠券的活动。
您可以在创建优惠券促销后在促销活动编辑器中生成优惠券。您可以多次生成券码。如果要上传手动输入的券码,请将需求通过邮件发送给艾克索拉

Note
优惠券码区分大小写。例如:winter2021WINTER2021是两个不同的优惠券。

区域限制

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

获取优惠券奖励

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

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

Copy
Full screen
Small screen
{
   "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,则不应在请求中传入额外参数。

按券码兑换优惠券

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

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

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

响应示例:

Copy
Full screen
Small screen
{
  {
    "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,则不应在请求中传入额外参数。
    1. 本文对您的有帮助吗?
      谢谢!
      我们还有其他可改进之处吗? 留言
      非常抱歉
      请说明为何本文没有帮助到您。 留言
      感谢您的反馈!
      我们会查看您的留言并运用它改进用户体验。
      为此页面评分
      为此页面评分
      我们还有其他可改进之处吗?

      不想回答

      感谢您的反馈!
      上次更新时间: 2020年12月30日

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

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