促销码

运行机制

基本信息

促销码活动是用于提高购买转化率和平均订单金额的营销工具。应用促销码后,用户可获得:

  • 应用于整个订单或指定商品的折扣
  • 奖励品,包括:
    • 虚拟货币套餐
    • 游戏密钥
    • 虚拟物品
    • 捆绑包

主要功能:

  • 灵活配置奖励。可设置单一奖励类型(订单折扣、特定商品折扣或奖励品)或任意组合。
  • 设置活动总兑换次数限制。
  • 设置单个用户在活动中的兑换次数限制。
  • 批量生成促销码。
  • 对活动和促销码关联商品设置区域限制。
注:
如需为活动设置区域限制,请发送邮件至igs@xsolla.com与我们联系。

限制:

  • 每次购买仅限使用一个促销码。
  • 用户必须完成付款才能获得折扣或奖励品。
  • 折扣不适用于以虚拟货币标价的商品。对于同时具有真实货币和虚拟货币价格的商品,折扣仅适用于真实货币价格。
  • 若游戏密钥作为奖励品,兑换后将通过邮件发送或添加到权利系统。若游戏密钥用尽,用户将无法兑换促销码。
  • 若促销码活动设有区域限制,相关区域的用户将无法兑换。
  • 若促销码包含任何区域限制奖励品,该区域的用户将无法兑换该促销码。
示例:假设提供一个剑和盾作为促销码奖励。其中盾具有区域限制,仅可在美国境内购买。如美国之外的用户输入该促销码,则验证促销码兑换促销码调用的响应中将返回错误,用户无法获得促销码中的任何商品。
注:

您也可以为商店设置优惠券活动

主要差异:

  • 优惠券:用户仅可获得奖励品。促销码:可提供奖励品、单品折扣或购物车折扣。
  • 促销码在购买时(结算)兑换,优惠券在输入券码后直接兑换。

用户流程

注:
用户可在完成付款前取消应用促销码。

折扣应用规则

如果购买时商品存在多个有效的促销活动,则将逐个应用这些折扣,折扣的应用顺序对结果没有影响。

示例:

某虚拟物品原价为$10。在发布商帐户中为该商品设置了以下促销活动:

  • 黑色星期五折扣促销,11月4日-30日享受10%的折扣
  • 特价折扣促销,11月15日-12月15日享受20%的折扣
  • 促销码活动,11月4日-30日使用促销码享受5%的折扣

如果在11月20日购买该物品,则两个折扣促销活动和一个促销码活动都有效。

该虚拟物品的总价计算方式为(($10 - 10%) - 20%) - 5% = $10 × (100%-10%) × (100%-20%) × (100%-5%) = $10 × 0.9 × 0.8 × 0.95,结果为$6.84。

设置促销码活动

注:

创建包含奖励品的促销活动前,需先配置这些商品,再进行活动设置。

要在发布商帐户项目中手动创建商品,请前往商品目录 > 全部商品。有关此方法及其他创建商品方式的详细信息,请参阅文档中的商品目录部分。

在发布商帐户中进行设置

要创建促销码活动:

  1. 在发布商帐户的项目中,前往LiveOps > 促销活动部分。
  2. 促销活动选项卡中,单击创建新促销活动
  1. 指定促销活动名称
  2. 促销活动类型下拉列表中,选择促销码
  3. 外部ID字段中,指定用于通过API调用管理的促销活动ID。
  4. 要设置兑换促销码时对商品或购物车应用折扣:

    1. 对购买项提供折扣开关设置为
    1. 折扣数字段中输入折扣百分比。

  1. 要设置兑换促销码时对特定商品应用折扣:

    1. 对所选商品提供折扣开关设置为
    1. 折扣数字段中输入折扣百分比。
    1. 商品类型下拉列表中选择将获得促销码折扣的商品类型。
    1. 选择具体商品。

  1. 要设置兑换促销码时提供奖励品:

    1. 奖励品开关设置为
    1. 选择奖励品下拉列表中,选择兑换促销码后向用户发放的商品类型。
    1. 选择兑换促销码时赠送的具体商品。
    1. 如果是虚拟物品,需指定每个物品的数量。
    1. 如果是游戏密钥,需指定平台确定方式:
      • 预先指定平台(如Steam):从DRM选择类型下拉列表选择在生成代码时选择DRM,然后从DRM下拉列表选择平台。
      • 让用户自选:从DRM选择类型下拉列表选择玩家在兑换时选择DRM
    1. 单击下一步

注:

订单或商品折扣必须为整数且不超过99%。 配置特定商品折扣或奖励品时的注意事项:

  • 只有当项目中已创建至少一个该类型的商品时,才能选择该商品类型。
  • 可配置不同类型商品,请通过商品类型选择字段切换类型。
  1. 配置促销码兑换限制:

    1. 若要限制活动中所有用户的促销码总兑换次数,请将限制兑换总次数开关设置为,并指定最大兑换次数。
    1. 若要限制单个用户在活动中可兑换的促销码数量,请将限制每个用户的兑换总次数开关设置为,并指定每个用户的最大兑换次数。
    1. 若要限制任何唯一促销码在所有用户中的兑换次数,请将限制唯一促销码兑换次数开关设置为,并指定该促销码的最大兑换次数。
    1. 单击下一步

  1. 设置活动有效期:选择时区、开始日期和结束日期。如需创建无限期活动,请勾选无结束日期复选框。
  2. 单击下一步
  3. 检查活动设置。
  4. 单击保存并退出

要向活动添加促销码:

  1. 在发布商帐户的项目中,前往LiveOps > 促销活动部分。
  2. 在促销码活动所在行,单击•••并从下拉列表中选择编辑促销活动
  1. 前往活动码选项卡。
  2. 要自动生成活动码:
    1. 活动码字符串格式下拉列表中,选择自动生成
    1. 指定要生成的数量并单击生成
  1. 要手动添加活动码:
    1. 活动码字符串格式下拉列表中,选择手动输入
    1. 输入促销码并单击创建
    1. 重复上述步骤添加所需数量的券码。
  1. 下载包含优惠券码的CSV文件(可选)。
注:

促销码区分大小写。例如,winter123WINTER123视为不同的促销码。

您可以无限次向活动添加新活动码,但总数不得超过50,000个。

如需上传大量自行生成的优惠券码,请联系我们:igs@xsolla.com

要使活动对用户可用,您需要激活它。操作方法:

  1. 在发布商帐户的项目中,前往LiveOps > 促销活动部分。
  2. 在促销码活动所在行,单击•••并从下拉列表中选择编辑促销活动
  3. 在右上角的下拉列表中,选择激活促销活动

通过API设置

注:
通过API配置促销活动时,您可以指定小数折扣金额。
注意
使用API调用更新促销活动时所需的参数列表与检索促销活动时返回的参数列表不一致。调用API方法更新促销活动时,您必须传递:
  • 必需参数
  • 需要更改的参数
  • 促销活动检索调用返回的所有其他参数

要通过API设置和管理促销码活动,请使用以下调用:

任务API调用
创建促销码活动。创建促销码活动
激活促销码活动。激活促销码活动
编辑促销活动。使用新促销活动选项更新促销码活动。编辑促销活动还可用于处于激活状态的促销活动。
停用促销活动。停用促销码活动
设置无限期促销活动。创建促销码活动更新促销码活动。请向相应调用传入“date_end”: null参数。
删除促销活动。删除促销码活动
注:
如果停用或删除活动中的促销活动,用户将无法再看到该促销活动。

在应用或网站中设置促销码兑换功能

在UI界面实现促销码兑换功能

  1. 在应用程序UI(目录或购物车中)实现以下元素:

    • 促销码输入框
    • 展示促销码奖励和折扣的UI元素
    • 促销码奖励选择表单(如适用)
    • 应用促销码的按钮
  2. 通过以下客户端侧API调用实现促销码逻辑:

注:
要调用艾克索拉API,您可以使用针对各游戏引擎和平台的现成SDK:
任务API调用
检查促销码是否有效。验证促销码
获取向用户显示的游戏分发平台列表(如促销码奖励是游戏密钥)。

获取促销码奖励

当响应返回is_selectable=true时,对于每个type=unit的商品,需为unit_items对象中的元素显示选择表单。在该表单中,用户只能为每个unit类型选择一个元素。

type=unit参数适用于游戏密钥,此时用户需选择一个游戏平台。

展示更新后商品目录,包含促销码折扣和奖励品。使用目录子部分中的API调用,需在promo_code请求参数中传入促销码。
直接购买商品并应用促销码(无需添加至购物车)。

使用指定商品创建订单

需在promo_code请求参数中传入促销码。

应用促销码并更新购物车内容和总价(应用折扣并添加奖励品)。

兑换促销码

需在coupon_code请求参数中传入促销码。

注:
若要检查用户在活动中还能使用多少次促销码,请使用服务器侧API调用获取指定用户的促销码限制
  1. 确保促销码兑换时正确发放商品。
  1. 如已在应用或网站中实现了游戏内商店,无需额外设置。促销码关联商品将以与标准购买相同的方式发放。
注:
游戏密钥将通过电子邮件或权利系统发送给用户。

在使用艾克索拉创建的网站上兑换促销码

注意
优惠券和促销码兑换功能仅支持使用网页商城模板创建的网站。

要在网站上显示优惠券码输入区域:

  1. 在发布商帐户中打开您的项目,然后前往商店 > 网站部分。
  2. 站点部分,选择您的网站,然后单击打开建站器
  3. 在建站器的主区域,选择想添加新区块的位置并点击添加区块
  4. 选择促销码区块。
  5. 自定义区块外观(可选):
    • 修改区块标题和描述文本。
    • 设置区块自定义背景。
    • 更改按钮样式。
    • 修改优惠券兑换按钮文本。
  6. 要应用更改,请发布网站:

    1. 在建站器右上角,单击发布
    1. 勾选需要发布的页面。
    1. 单击发布

注:

如果无法发布网站,请确保满足以下所有条件:

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2026年2月13日

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

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至doc_feedback@xsolla.com与我们联系。