特别目录优惠

运行机制

特别目录优惠 — 对输入特别优惠码的用户显示目录隐藏商品。如未输入优惠码，则不显示这些商品。

主要功能：

• 设置输入优惠码后显示的商品列表
• 为输入优惠码后显示的商品设置促销活动
• 配置活动的优惠码兑换总次数
• 配置每个用户在活动中的优惠码兑换次数
• 根据需求设置区域限制

• 生成多个优惠码

• 用户必须授权登入才能使用优惠码。
• 如优惠码关联了具有区域限制的商品，来自不适用区域的用户将无法看到与该优惠码关联的特别优惠。
  示例：输入优惠码后应显示Legendary Starter Pack。Legendary Starter Pack具有区域限制 — 它仅适用于美国境内。如果美国之外的用户输入了该优惠码，则验证优惠码方法的响应中将返回一个错误，且用户无法查看或购买Legendary Starter Pack。

用户流程

1. 授权登入后的用户打开商品目录并看到除特别优惠外的所有商品。
2. 用户在目录的特别字段中输入优惠码并激活。
3. 用户看到可供购买的特别商品。
4. 用户购买特别商品，该优惠码即视作已兑换。

集成过程

1. 设置提供特别目录优惠的促销活动。
2. 实现向用户显示目录。方法是使用虚拟物品和货币方法组目录子部分中的方法生成目录。
3. 实现目录中优惠码输入字段的显示。
4. 使用验证促销码方法验证优惠码。
5. 实现显示应用优惠码后的商品目录。方法是，调用虚拟物品和货币方法组目录子部分的方法生成目录时在promo_code参数中传入优惠码的值。
6. 要创建特别商品的订单，请使用使用指定商品创建订单方法。在请求正文的promo_code参数中传入优惠码的值。如要使用购物车，请在创建购物车和创建订单时在请求正文的promo_code中传入优惠码的值。

如何获取

前提条件

1. 注册发布商帐户。
2. 连接商店并设置虚拟物品、虚拟货币或捆绑包模块。

设置提供特别目录优惠的促销活动

1. 使用创建特别目录优惠促销活动方法创建提供特别目录优惠的促销活动。在items数组中，传入激活优惠码后显示的商品的SKU。还可以指定：
   • 促销活动有效期，方法是：
     • 在date_start参数中传入开始日期。
     • 在date_end参数中传入结束日期。如未指定结束日期，则促销活动无限期。
   • 限制：
     • 在redeem_user_limit参数中传入一个用户可以使用该促销活动的次数
     • 在redeem_code_limit参数中传入该促销码可兑换的次数
     • 在redeem_total_limit参数中传入该促销活动可被使用的总次数
2. 使用生成特别目录优惠代码方法为创建的促销活动生成优惠码或使用创建特别目录优惠代码方法创建优惠码。需要时可生成多个代码。要获取生成的代码，请使用获取特别目录优惠代码方法。
3. 使用激活特别目录优惠促销活动方法激活促销活动。

要管理促销活动，请使用以下方法：

• 更新特别目录优惠促销活动
• 停用特别目录优惠促销活动

要获取特别目录优惠的信息，请使用以下方法：

• 获取特别目录优惠促销活动列表
• 获取特别目录优惠促销活动